Wallets
Balances, history, identity, PnL and positions for any address or SuiNS name, now or at a past date.
When to use it
- Build a wallet or portfolio view without running an indexer.
- Label an address: its SuiNS name, who funded it, what it is linked to.
- Compute profit and loss per coin.
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. Balances
Every coin the wallet holds, sorted by USD value.
curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/balances?limit=10" \
-H "x-api-key: YOUR_API_KEY"2. History
Transactions with their balance changes, all of history, both directions.
curl "https://api.tide.ad/v1/wallet/0x671f7079e238edf837ae8d4fe8274f3337e1b20bbc08e2e9b9b7f5fcee9566e2/history?limit=5" \
-H "x-api-key: YOUR_API_KEY"3. Identity
SuiNS names and what tide knows about the address.
curl "https://api.tide.ad/v1/wallet/0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd/identity" \
-H "x-api-key: YOUR_API_KEY"4. Profit and loss
Realized and unrealized PnL per coin.
curl "https://api.tide.ad/v1/wallet/0x935029ca5219502a47ac9b69f556ccf6e2198b5e7815cf50f68846f723739cbd/pnl?sort=volume" \
-H "x-api-key: YOUR_API_KEY"API reference
| Method | What it does | Credits |
|---|---|---|
| wallet.balancesGET /v1/wallet/:wallet/balances | Every coin a wallet holds now, with USD value, sorted by value. | 10 |
| wallet.nftsGET /v1/wallet/:wallet/nfts | NFTs and kiosk items a wallet holds now. | 10 |
| wallet.historyGET /v1/wallet/:wallet/history | A wallet's transactions with its balance changes, all history, both directions. | 10 |
| wallet.transfersGET /v1/wallet/:wallet/transfers | A wallet's coin transfers in and out with the counterparty. | 10 |
| wallet.identityGET /v1/wallet/:wallet/identity | Who a wallet is: known label and SuiNS names. | 1 |
| wallet.fundedByGET /v1/wallet/:wallet/funded-by | Who first sent SUI to a wallet. | 10 |
| wallet.pnlGET /v1/wallet/:wallet/pnl | Realized and unrealized profit and loss per coin for a wallet. | 10 |
| wallet.positionsGET /v1/wallet/:wallet/positions | A wallet's DeFi positions: liquidity, lending, staking and vaults. | 10 |
| wallet.linkedGET /v1/wallet/:wallet/linked | Wallets that look related to this one. | 10 |
| wallet.balanceAtGET /v1/wallet/:wallet/balance-at | A wallet's balance of one coin at a past time or checkpoint. | 10 |
| wallet.holdingsAtGET /v1/wallet/:wallet/holdings-at | Every coin a wallet held at a past time, with USD at that time. | 20 |
Full lists: Wallet. Every method page has its parameters, credits and an example response.