wallet.transfers

A wallet's coin transfers in and out with the counterparty.

Details

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

Returns the coin transfers of a wallet: one record per coin moved, with direction (in or out), counterparty, coinType (also mint), symbol, amount in whole coins, amountRaw and decimals. Only plain transfers count: transactions whose commands are built-in transfers and payments, not swaps or protocol calls (use /history for those). Gas is not part of the amount. Page with cursor; a page covers up to limit transactions and may hold a few more records when one transaction moves several coins. Filter by direction, coinType and time.

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.
direction	string	Only incoming or only outgoing transfers.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/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/transfers?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

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

Response

JSON

{
  "wallet": "0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2",
  "data": [],
  "pagination": {
    "hasMore": true,
    "nextCursor": "341837407.2"
  },
  "cursor": "341837407.2",
  "historyFrom": null,
  "asOf": {
    "checkpoint": 341856994,
    "timestamp": "2026-11-05T08:41:56.338Z",
    "lagMs": 765
  }
}