Deed Settlement Endpoints
Deed settlement endpoints provide specialised access to all deed transactions on SwssChain. These endpoints expose metadata not available through the standard transaction endpoints: including deed type, jurisdictional metadata, settlement status, and the associated Finality Certificate hash. All deed data is permanently available with no archival cutoff.
Base URL: https://swssscan.swss.io/api/v1
GET /deeds/{txHash}
Returns full deed settlement data for a given transaction hash. This is the primary endpoint for retrieving complete deed metadata.
curl https://swssscan.swss.io/api/v1/deeds/0xtxhash... -H "X-API-Key: your_api_key"
{
"transactionHash": "0xtxhash...",
"deedType": "HOME_DEED",
"assetClass": "Home Deed",
"settler": "0xsettler...",
"blockNumber": 1234567,
"timestamp": "2026-05-15T10:00:01Z",
"jurisdiction": "England and Wales",
"metadataHash": "0xmeta...",
"certificateHash": "0xcert...",
"certified": true,
"tslActivated": true
}
GET /deeds/address/{address}
Returns paginated deed settlements for a wallet address. Optionally filter by deed type.
curl "https://swssscan.swss.io/api/v1/deeds/address/0xwallet...?page=1&limit=20" -H "X-API-Key: your_api_key"
curl "https://swssscan.swss.io/api/v1/deeds/address/0xwallet...?deedType=HOME_DEED" -H "X-API-Key: your_api_key"
GET /deeds/type/{deedType}
Returns all deed settlements of a specific type, ordered by block number descending. Valid deedType values:
| Value | Deed Type |
HOME_DEED | Home Deed |
COMPUTE_DEED | Compute Deed |
AI_AGENT_DEED | AI Agent Deed |
BIZ_DEED | BizDeed |
curl "https://swssscan.swss.io/api/v1/deeds/type/HOME_DEED?page=1&limit=20" -H "X-API-Key: your_api_key"
GET /deeds/stats
Returns aggregate deed settlement statistics across the entire chain.
curl https://swssscan.swss.io/api/v1/deeds/stats -H "X-API-Key: your_api_key"
{
"totalDeeds": 18420,
"byType": {
"HOME_DEED": 18420,
"COMPUTE_DEED": 0,
"AI_AGENT_DEED": 0
},
"totalCertified": 18420,
"dailyVolume": 47,
"tslRetirements": 18420,
"lastUpdated": "2026-05-15T10:00:00Z"
}
SwssChain-Specific JSON-RPC Method
For developers using the JSON-RPC interface directly via an RPC provider:
curl https://YOUR_RPC_URL -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"method": "swss_getDeedTransaction",
"params": ["0xtxhash..."],
"id": 1
}'
Deed Settlement Object Fields Reference
| Field | Type | Description |
transactionHash | string | The deed transaction hash |
deedType | string | Protocol-level deed type identifier |
assetClass | string | Human-readable asset class name |
settler | string | Wallet address that submitted the deed |
blockNumber | integer | Block in which the deed was finalised |
timestamp | string | ISO 8601 settlement timestamp |
jurisdiction | string | Legal jurisdiction recorded in the deed |
metadataHash | string | Hash of the deed's asset-class-specific metadata |
certificateHash | string | Hash of the associated Finality Certificate |
certified | boolean | true when Finality Certificate has been issued |
tslActivated | boolean | true when TSL supply retirement was activated |
Next Steps