API Reference
Deed Settlement Endpoints
Pre-launch
Section
API Reference
Documentation category
Type
Guide
Technical reference
Summary
Complete reference for SwssChain deed settlement API endpoints (by hash, address, type, and aggregate stats) with full response shapes and JSON-RPC method.
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

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.

# All deed types for address
curl "https://swssscan.swss.io/api/v1/deeds/address/0xwallet...?page=1&limit=20"   -H "X-API-Key: your_api_key"

# Filter to Home Deed only
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:

ValueDeed Type
HOME_DEEDHome Deed
COMPUTE_DEEDCompute Deed
AI_AGENT_DEEDAI Agent Deed
BIZ_DEEDBizDeed
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

FieldTypeDescription
transactionHashstringThe deed transaction hash
deedTypestringProtocol-level deed type identifier
assetClassstringHuman-readable asset class name
settlerstringWallet address that submitted the deed
blockNumberintegerBlock in which the deed was finalised
timestampstringISO 8601 settlement timestamp
jurisdictionstringLegal jurisdiction recorded in the deed
metadataHashstringHash of the deed's asset-class-specific metadata
certificateHashstringHash of the associated Finality Certificate
certifiedbooleantrue when Finality Certificate has been issued
tslActivatedbooleantrue when TSL supply retirement was activated

Next Steps