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
| Endpoint | Method | Description |
/api/stats | GET | Chain statistics: total blocks, transactions, addresses, average block time |
/api/finality-cert/{txHash} | GET | Finality Certificate by deed transaction hash |
/api/deed-contract/{deedId} | GET | Full deed settlement data by deed ID |
/api/deed-daily?days=N | GET | Per-day deed transaction breakdown: RWA (0x70) and AI Agent (0x71) types |
/api/validators | GET | Current validator set with epoch and rotation history |
/api/governance | GET | On-chain governance state, params, and active proposals |
/api/blocks | GET | Recent blocks with transaction counts |
/api/transactions | GET | Recent transactions |
/api/addresses | GET | Address 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.