API Reference
Transaction Endpoints
Pre-launch
Section
API Reference
Documentation category
Type
Guide
Technical reference
Summary
Complete reference for SwssChain transaction API endpoints (by hash, address, block, and pending) with full transaction object field reference.
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

Transaction Endpoints

Transaction endpoints provide access to all transaction data on SwssChain, including both standard EVM transactions and deed transactions. Deed transactions include an additional isDeedTransaction flag and a deedType field not present in standard transactions. For full deed-specific metadata, use the Deed Settlement Endpoints.

Base URL: https://swssscan.swss.io/api/v1

GET /transactions/{txHash}

Returns a transaction by its hash. The hash must be a full 66-character hex string prefixed with 0x.

curl https://swssscan.swss.io/api/v1/transactions/0xtxhash...   -H "X-API-Key: your_api_key"
{
  "transactionHash": "0xtxhash...",
  "blockNumber": 1234567,
  "blockHash": "0xblock...",
  "from": "0xsender...",
  "to": "0xrecipient...",
  "value": "1000000000000000000",
  "gasPrice": "1000000000",
  "gasUsed": "21000",
  "gasLimit": "25000",
  "nonce": 42,
  "input": "0x",
  "status": "success",
  "timestamp": "2026-05-15T10:00:01Z",
  "isDeedTransaction": false,
  "deedType": null
}

GET /transactions/address/{address}

Returns paginated transaction history for a wallet address. Supports filtering to deed transactions only.

# All transactions, paginated
curl "https://swssscan.swss.io/api/v1/transactions/address/0xwallet...?page=1&limit=50"   -H "X-API-Key: your_api_key"

# Deed transactions only
curl "https://swssscan.swss.io/api/v1/transactions/address/0xwallet...?deedOnly=true"   -H "X-API-Key: your_api_key"
{
  "transactions": [ /* array of transaction objects */ ],
  "total": 284,
  "page": 1,
  "limit": 50,
  "hasMore": true
}

GET /transactions/block/{blockNumber}

Returns all transactions included in a specific block.

curl https://swssscan.swss.io/api/v1/transactions/block/1234567   -H "X-API-Key: your_api_key"

GET /transactions/pending

Returns transactions currently in the mempool awaiting inclusion. On SwssChain's 1-second block time, most transactions move from pending to confirmed within 1 to 2 seconds.

curl https://swssscan.swss.io/api/v1/transactions/pending   -H "X-API-Key: your_api_key"

Transaction Object Fields Reference

FieldTypeDescription
transactionHashstring32-byte transaction hash (0x-prefixed)
blockNumberintegerBlock in which this transaction was confirmed
blockHashstringHash of the containing block
fromstringSender wallet address
tostringRecipient address or contract address
valuestringSWSS Coin value transferred, in wei
gasPricestringGas price paid, in wei
gasUsedstringActual gas consumed
gasLimitstringMaximum gas the sender authorised
nonceintegerSender nonce at time of submission
inputstringHex-encoded transaction input data
statusstringsuccess or failed
timestampstringISO 8601 confirmation timestamp
isDeedTransactionbooleantrue if this is a deed transaction
deedTypestringDeed type identifier if applicable, otherwise null

Next Steps