API Reference
swssscan.swss.io Explorer API
Pre-launch
Section
API Reference
Documentation category
Type
Guide
Technical reference
Summary
HTTP API endpoints exposed by the SwssChain Explorer: finality certificates, deed data, validators, governance, and chain stats.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

swssscan.swss.io Explorer API

The SwssChain Explorer exposes a public HTTP API for querying settlement data, deed records, finality certificates, validator state, and chain statistics. All endpoints return JSON. No authentication is required for public endpoints.

Base URL (Mainnet): https://swssscan.swss.io
Base URL (Testnet): Testnet access requires SWSS DevHub registration: see below.

Testnet Access: SWSS DevHub Required

Access to SwssChain testnet 122606 is limited to developers the SWSS Foundation has approved. Credentials, endpoints and testnet allocation are issued together on approval: see how access is granted. Testnet access is not publicly open.

Endpoint Reference

EndpointMethodDescription
/api/statsGETChain statistics: total blocks, transactions, addresses, average block time
/api/finality-cert/{txHash}GETFinality Certificate by deed transaction hash
/api/deed-contract/{deedId}GETFull deed settlement data by deed ID
/api/deed-daily?days=NGETPer-day deed transaction breakdown: RWA (0x70) and AI Agent (0x71) types
/api/validatorsGETCurrent validator set with epoch and rotation history
/api/governanceGETOn-chain governance state, params, and active proposals
/api/blocksGETRecent blocks with transaction counts
/api/transactionsGETRecent transactions
/api/addressesGETAddress data and balance

GET /api/stats

curl https://swssscan.swss.io/api/stats
{
  "total_blocks":        "154837",
  "total_transactions":  "76",
  "total_addresses":     "31",
  "average_block_time":  3000,
  "network_utilization_percentage": 0
}

GET /api/finality-cert/{txHash}

Retrieves a Finality Certificate directly from the SwssChain RPC node via swss_getFinalityCert. No third-party data source. Results are cryptographically verifiable by any participant.

curl https://swssscan.swss.io/api/finality-cert/0x1deed7a3f...
{
  "version":     1,
  "txHash":      "0x1deed7a3f...",
  "blockNumber": 154837,
  "blockHash":   "0xblockhash...",
  "deedId":      "SWSS-ESTATE-00001",
  "assetRef":    "LR-EW-4821953",
  "chainId":     122605,
  "timestamp":   1749254400,
  "signatures": [
    { "validator": "0x36841E62...", "signature": "0xsig1..." },
    { "validator": "0x9b8d2290...", "signature": "0xsig2..." },
    { "validator": "0x2033FcD2...", "signature": "0xsig3..." }
  ]
}

GET /api/deed-contract/{deedId}

Returns full on-chain deed data including legal owner, jurisdiction, asset reference, TSL dissolution amount, and lock status. Owner privacy is enforced: ownership data is only returned with a valid ECDSA-signed authentication token from the owner's wallet.

curl https://swssscan.swss.io/api/deed-contract/SWSS-ESTATE-00001
{
  "deedId":          "SWSS-ESTATE-00001",
  "jurisdiction":    "England and Wales",
  "assetRef":        "LR-EW-4821953",
  "dissolutionSwss": "0.000143",
  "annualCapSwss":   "0.0",
  "scpTxHash":       "0x1deed7a3f...",
  "locked":          false
}

GET /api/deed-daily

curl "https://swssscan.swss.io/api/deed-daily?days=14"
[
  { "date": "2026-06-06", "count": 3, "rwa": 3, "agent": 0 },
  { "date": "2026-06-05", "count": 1, "rwa": 1, "agent": 0 }
]

GET /api/validators

curl https://swssscan.swss.io/api/validators
{
  "epoch":       77,
  "blockNumber": 155925,
  "validators": [
    { "address": "0x36841E62...", "addedAtBlock": 0 },
    { "address": "0x9b8d2290...", "addedAtBlock": 0 },
    { "address": "0x2033FcD2...", "addedAtBlock": 0 },
    { "address": "0x5eD15343...", "addedAtBlock": 74000, "rotatedFrom": "0x06c40a72..." }
  ]
}

GET /api/governance

curl https://swssscan.swss.io/api/governance

Returns state, params, and proposals objects representing the current on-chain governance snapshot.