Wallet

wallet.history

A wallet's transactions with its balance changes, all history, both directions.

Details

Endpoint: GET /v1/wallet/:wallet/history
Credits: 10
Rate class: Heavy. Counts against your heavy requests per second.

Returns the wallet's transactions, newest first or oldest first (sort), each with the digest, checkpoint, timestamp (unix seconds), fee in SUI, feePayer, error and the wallet's own balanceChanges per coin (amount in whole coins, amountRaw in the smallest unit). A transaction is included when the wallet sent it, paid its gas, or had a balance change. Page with cursor, up to 100 per page. Filter by time, checkpoint, coinType, status and type (coarse: TRANSFER, CONTRACT_CALL, PUBLISH, UPGRADE, SYSTEM). For fully parsed transactions use /v0/addresses/{address}/transactions.

Parameters

Name	Type	Description
walletrequired	string	Wallet address (0x...), name.sui or @name.
limit	integer	Rows per page, up to 100.From 1 to 100.
cursor	string	Cursor from the previous page. Alias: before (history).
sort	string	desc is newest first (default), asc is oldest first.One of "desc", "asc".
gte-time	integer	Only transactions at or after this unix time (seconds).
lte-time	integer	Only transactions at or before this unix time (seconds).
gte-checkpoint	integer	Only transactions at or after this checkpoint.
lte-checkpoint	integer	Only transactions at or before this checkpoint.
coinType	string	Only transactions that changed this coin's balance for the wallet. Alias: mint.
before	string	Alias of cursor.
status	string	Only successful or only failed transactions.One of "success", "failed".
type	string	Coarse transaction type filter.One of "TRANSFER", "CONTRACT_CALL", "PUBLISH", "UPGRADE", "SYSTEM".

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/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/history?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

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

Response

JSON

{
  "wallet": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
  "data": [
    {
      "digest": "DhLpbTMo2zDahBZ6Vim66Wmo3w9WPkHbvYYFudG59iz5",
      "signature": "DhLpbTMo2zDahBZ6Vim66Wmo3w9WPkHbvYYFudG59iz5",
      "checkpoint": 341483615,
      "txIndex": 14,
      "timestamp": 1793777331,
      "type": "CONTRACT_CALL",
      "status": "success",
      "fee": 0.004641189,
      "feeMist": "4641189",
      "feePayer": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "sender": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "error": null,
      "balanceChanges": [
        {
          "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "mint": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "symbol": "SUI",
          "amount": -192.921334823,
          "amountRaw": "-192921334823",
          "decimals": 9
        },
        {
          "coinType": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
          "mint": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
          "symbol": "USDC",
          "amount": -45.153997,
          "amountRaw": "-45153997",
          "decimals": 6
        }
      ],
      "partial": false
    },
    {
      "digest": "HukeFLD8f8ryfie9o1ZTG3fBtRvAJLBTcfVxvpWAtsQA",
      "signature": "HukeFLD8f8ryfie9o1ZTG3fBtRvAJLBTcfVxvpWAtsQA",
      "checkpoint": 341483520,
      "txIndex": 25,
      "timestamp": 1793777308,
      "type": "CONTRACT_CALL",
      "status": "success",
      "fee": -0.004397549,
      "feeMist": "-4397549",
      "feePayer": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "sender": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "error": null,
      "balanceChanges": [
        {
          "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "mint": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "symbol": "SUI",
          "amount": 0.010660254,
          "amountRaw": "10660254",
          "decimals": 9
        }
      ],
      "partial": false
    },
    {
      "digest": "3L9uwzcQixyfvBcrs2E4VgKNPcS3NzSaDx7ZyFLjX5j8",
      "signature": "3L9uwzcQixyfvBcrs2E4VgKNPcS3NzSaDx7ZyFLjX5j8",
      "checkpoint": 341483515,
      "txIndex": 9,
      "timestamp": 1793777307,
      "type": "CONTRACT_CALL",
      "status": "success",
      "fee": 0.015384117,
      "feeMist": "15384117",
      "feePayer": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "sender": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
      "error": null,
      "balanceChanges": [
        {
          "coinType": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "mint": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
          "symbol": "SUI",
          "amount": 192.908242619,
          "amountRaw": "192908242619",
          "decimals": 9
        },
        {
          "coinType": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
          "mint": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
          "symbol": "USDC",
          "amount": 45.147969,
          "amountRaw": "45147969",
          "decimals": 6
        }
      ],
      "partial": false
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "341483269.5"
  },
  "cursor": "341483269.5",
  "historyFrom": null,
  "asOf": {
    "checkpoint": 341484426,
    "timestamp": "2026-11-04T07:32:09.838Z",
    "lagMs": 950
  }
}

Long lists are cut to a few items here.