Quickstart

Five reads that show the shape of the API. Replace YOUR_API_KEY, or drop the key header to use the keyless tier.

1. Assets a wallet owns

NFTs, kiosk items and, with an option, coins in one asset shape. More in NFTs.

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": "getAssetsByOwner",
  "params": {
    "ownerAddress": "0xb30ad69255009768b8f651f10f0055090b19783755ec2154d7fd9cf873f7dc47",
    "limit": 5,
    "options": {
      "showFungible": true,
      "showNativeBalance": true
    }
  }
}'

2. A parsed transaction

Typed, with a plain description, transfers, object changes and events. More in Transactions.

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"
  ]
}'

3. A wallet's balances

Every coin with its USD value and the time of the price. More in Wallets.

curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balances?limit=10" \
  -H "x-api-key: YOUR_API_KEY"

4. An object

Type, owner, version and contents. Add a checkpoint with objects.at for a past state. More in Objects.

curl "https://api.tide.ad/v1/objects/0x0000000000000000000000000000000000000000000000000000000000000006" \
  -H "x-api-key: YOUR_API_KEY"

5. A balance on a past date

One coin for one wallet at a checkpoint or time. More in History and holders at any date.

curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balance-at?coinType=0x2::sui::SUI&datetime=2026-11-01%2000:00:00" \
  -H "x-api-key: YOUR_API_KEY"