Transactions
Any transaction by digest, parsed into a type, a plain sentence, transfers, object changes and events. Address history reaches back to genesis.
When to use it
- Show a user what a transaction did, in words, without decoding it yourself.
- List everything an address has sent or received, with filters for type, coin and time.
- Parse many digests in one call.
Quickstart
Replace YOUR_API_KEY with your key from the developer portal, or drop the key header to use the keyless tier. See Quickstart.
1. Parse transactions
Send digests and get typed transactions back, each with a one sentence description.
curl -X POST "https://api.tide.ad/v0/transactions" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"transactions": [
"3nrSJ85TEooEfeXjbbDEVdsbebfYdFMXzHE3gBSHTkcT",
"2hhr9HKTRS7vnqc6r9ny7WQgecSzTnkAbPwrpGACKCE7"
]
}'2. Read one transaction
The same transaction as a JSON-RPC call.
curl -X POST "https://api.tide.ad/" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getTransaction",
"params": {
"digest": "3nrSJ85TEooEfeXjbbDEVdsbebfYdFMXzHE3gBSHTkcT"
}
}'3. List an address's history
Both directions, newest first, paged with a cursor.
curl "https://api.tide.ad/v0/addresses/0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad/transactions?limit=5" \
-H "x-api-key: YOUR_API_KEY"API reference
| Method | What it does | Credits |
|---|---|---|
| tx.parsePOST /v0/transactions | Parse up to 100 transaction digests into typed, described transactions. | varies |
| getTransactionJSON-RPC | One parsed transaction by digest. | 1 |
| getTransactionBlockJSON-RPC | The raw transaction as the Sui node reports it. | 1 |
| tx.historyGET /v0/addresses/:address/transactions | Parsed transaction history of an address, filterable by type, source, time and checkpoint. | 10 |
| getTransactionsForAddressJSON-RPC | Full history of an address with sort order, filters and a pagination token. | varies |
| bridge.transfersGET /v1/wallet/:wallet/bridge | Sui Bridge transfers of a wallet, out of Sui and into Sui, newest first. | 3 |
Full lists: Transactions. Every method page has its parameters, credits and an example response.