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.
curl "https://swssscan.swss.io/api/v1/transactions/address/0xwallet...?page=1&limit=50" -H "X-API-Key: your_api_key"
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
| Field | Type | Description |
transactionHash | string | 32-byte transaction hash (0x-prefixed) |
blockNumber | integer | Block in which this transaction was confirmed |
blockHash | string | Hash of the containing block |
from | string | Sender wallet address |
to | string | Recipient address or contract address |
value | string | SWSS Coin value transferred, in wei |
gasPrice | string | Gas price paid, in wei |
gasUsed | string | Actual gas consumed |
gasLimit | string | Maximum gas the sender authorised |
nonce | integer | Sender nonce at time of submission |
input | string | Hex-encoded transaction input data |
status | string | success or failed |
timestamp | string | ISO 8601 confirmation timestamp |
isDeedTransaction | boolean | true if this is a deed transaction |
deedType | string | Deed type identifier if applicable, otherwise null |
Next Steps