tx.history

Parsed transaction history of an address, filterable by type, source, time and checkpoint.

Details

Endpoint: GET /v0/addresses/:address/transactions
Credits: 10
Rate class: Heavy. Counts against your heavy requests per second.

Returns parsed transactions that involve an address (sender, sponsor, balance change, object owner, package call or event sender), newest first by default, as a bare array. The address may be a 0x address or a SuiNS name. Page with before=<last digest>, or with until for the other direction. Type and source filters classify transactions while paging: one call reads at most 10 index pages. If it finds fewer than limit matches it returns what it found with a continuation (a digest in the x-tide-next header for the REST path, paginationToken for the others) and capped true in the RPC result. Time filters are exact at checkpoint granularity. History older than the loaded index returns not_indexed with the lowest checkpoint available. 10 credits per page.

Parameters

Name	Type	Description
addressrequired	string	0x address or .sui name.
type	string	One of TRANSFER, SWAP, ARBITRAGE, FLASH_LOAN, LIQUIDATION, DEPOSIT, WITHDRAW, BORROW, REPAY, STAKE, UNSTAKE, MINT, BURN, NFT_SALE, NFT_LISTING, NFT_TRANSFER, PUBLISH, UPGRADE, ORACLE_UPDATE, CONTRACT_CALL, SYSTEM, UNKNOWN. The type comes from tide's transaction classifier: a DEX trade is SWAP, a loop that ends in the coin it started with is ARBITRAGE, an NFT purchase is NFT_SALE.One of "TRANSFER", "SWAP", "ARBITRAGE", "FLASH_LOAN", "LIQUIDATION", "DEPOSIT", "WITHDRAW", "BORROW", "REPAY", "STAKE", "UNSTAKE", "MINT", "BURN", "NFT_SALE", "NFT_LISTING", "NFT_TRANSFER", "PUBLISH", "UPGRADE", "ORACLE_UPDATE", "CONTRACT_CALL", "SYSTEM", "UNKNOWN".
source	string	Protocol slug, for example CETUS.
before	string	Digest. Only transactions older than this one.
until	string	Digest. Only transactions newer than this one (stop here). Alias: after.
limit	integer	Transactions per page, 1 to 100. Default 10.From 1 to 100.
gte-time	integer	Unix seconds, at or after.
gt-time	integer	Unix seconds, after.
lte-time	integer	Unix seconds, at or before.
lt-time	integer	Unix seconds, before.
gte-checkpoint	integer	Checkpoint, at or after. Alias gte-slot.
gt-checkpoint	integer	Checkpoint, after.
lte-checkpoint	integer	Checkpoint, at or before.
lt-checkpoint	integer	Checkpoint, before.
sort	string	Order.One of "asc", "desc".
status	string	Filter by outcome. Default any.One of "succeeded", "failed", "any".
coinType	string	Only transactions that changed this coin's balance for the address.
direction	string	With coinType or alone: only inflows or outflows for the address, gas excluded.One of "in", "out".

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v0/addresses/0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad/transactions?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v0/addresses/0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad/transactions?limit=5", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

[
  {
    "digest": "HnPA7dLp3EqMnGuMbcDgqBiRkQRzsSjwPC1C6HAZVFWT",
    "checkpoint": 341886930,
    "txIndex": 36,
    "timestamp": 1793875369,
    "epoch": 1302,
    "type": "CONTRACT_CALL",
    "source": "DEEPBOOK",
    "description": "Called balance_manager::generate_proof_as_owner on DeepBook.",
    "status": "success",
    "error": null,
    "sender": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad",
    "feePayer": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad",
    "fee": -887321,
    "gas": {
      "computation": 100000,
      "storage": 81798800,
      "rebate": 82786121,
      "budget": 10000000,
      "price": 100
    },
    "nativeTransfers": [],
    "tokenTransfers": [],
    "balanceChanges": [
      {
        "owner": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad",
        "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
        "amountRaw": "887321",
        "amount": 0.000887321,
        "usd": 0.00082,
        "priceAsOf": "2026-11-05T10:42:49.508Z"
      }
    ],
    "objectChanges": [
      {
        "objectId": "0x47dcbbc8561fe3d52198336855f0983878152a12524749e054357ac2e3573d58",
        "type": "0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809::balance_manager::BalanceManager",
        "kind": "mutated",
        "owner": {
          "kind": "shared",
          "initialSharedVersion": 389887099
        },
        "version": 1072975175,
        "previousVersion": 1072975174
      }
    ],
    "events": [
      {
        "index": 0,
        "type": "0x2c8d603bc51326b8c13cef9dd07031a408a48dddb541963357661df5d3204809::order::OrderCanceled",
        "package": "0xcaf6ba059d539a97646d47f0b9ddf843e138d215e2a12ca1f4585d386f7aec3a",
        "module": "order",
        "sender": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad",
        "json": {
          "balance_manager_id": "0x47dcbbc8561fe3d52198336855f0983878152a12524749e054357ac2e3573d58",
          "base_asset_quantity_canceled": "252794900000000",
          "client_order_id": "113893820",
          "is_bid": true,
          "order_id": "542112914838176274984899",
          "original_quantity": "252794900000000",
          "pool_id": "0x56a1c985c1f1123181d6b881714793689321ba24301b3585eec427436eb1c76d",
          "price": "29387",
          "timestamp": "1793875369508",
          "trader": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad"
        }
      }
    ],
    "commands": [
      {
        "index": 0,
        "kind": "MoveCall",
        "target": "0xcaf6ba059d539a97646d47f0b9ddf843e138d215e2a12ca1f4585d386f7aec3a::balance_manager::generate_proof_as_owner",
        "typeArguments": [],
        "summary": "Called balance_manager::generate_proof_as_owner in DeepBook."
      }
    ],
    "explain": {
      "summary": "Called balance_manager::generate_proof_as_owner on DeepBook.",
      "steps": [
        {
          "sentence": "Called DeepBook (balance_manager::generate_proof_as_owner, pool::cancel_order).",
          "commands": [
            0
          ]
        }
      ],
      "result": [
        {
          "owner": "0xffd4f043057226453aeba59732d41c6093516f54823ebc3a16d17f8a77d2f0ad",
          "roles": [
            "sender"
          ],
          "changes": [
            {
              "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
              "amountRaw": "887321",
              "amount": 0.000887321,
              "usd": 0.00082
            }
          ],
          "sentence": "Net: received 0.00089 SUI ($0.00082) in gas."
        }
      ]
    },
    "insight": null,
    "partial": false
  }
]

Long lists are cut to a few items here.