Skip to main content
POST
POST /v1/wallet/positions · 2 credits per wallet Batch twin: up to 20 wallets per call, response array in input order. Each slot is { data, summary, hasMore }, the body of the single GET for that wallet, or { error } when that wallet failed, so one wallet never fails the others. minValueUsd, minLiquidityUsd, includeNative, includeStables, limit and offset apply to every wallet of the call. tokens is set per wallet, in its item. Billed per wallet: the same address requested on several chains counts as one wallet.
Each items[] entry takes a wallet and an optional chain or chains (omit both for all EVM chains of a hex address; a base58 address is Solana). chains is a list or a comma-separated string of public chain ids, evm for every EVM chain, all of the wallet’s family; an item with both, or with a chain outside the wallet’s family, comes back as its own { error } slot. An item can also carry tokens, 1 to 50 token addresses as a list or a comma-separated string: that wallet’s rows and summary then cover only those tokens, like tokens= on the GET. Each wallet takes its own list, so one call can read a few known tokens across a user’s EVM and Solana wallets; an invalid list comes back as that wallet’s { error } slot. A slot’s data, summary and hasMore are exactly what GET /v1/wallet/positions returns for that wallet with the same options; see that page for the row fields. amount is the wallet’s exact on-chain balance, a decimal string at the token’s full precision; token quantities are never in exponent notation.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Body

application/json
items
object[]
required

[{ "wallet": "…", "chain": "…" }] or [{ "wallet": "…", "chains": ["…", "…"] }] - 1 to 20 wallets, EVM and Solana mixed freely; chain or chains optional, one of the two per item (omit both for all EVM chains). chains takes a list or a comma-separated string, with evm for every EVM chain. An item with both, or with a chain outside the wallet's family, gets an { error } slot. An item can also carry tokens, 1 to 50 token addresses as a list or a comma-separated string: that wallet's rows and summary then cover only those tokens, like tokens= on the GET. Each wallet takes its own list; an invalid list gets an { error } slot.

Required array length: 1 - 20 elements
minValueUsd
number
default:0.05

Same as the GET, applied to every wallet. Default 0.05.

Required range: x >= 0
Example:

0.05

minLiquidityUsd
number
default:1000

Same as the GET, applied to every wallet. Default 1000.

Required range: x >= 0
Example:

1000

includeNative
boolean
default:false

Same as the GET, applied to every wallet.

Example:

false

includeStables
boolean
default:false

Same as the GET, applied to every wallet.

Example:

false

limit
integer

Page size per wallet, 1-500.

Required range: 1 <= x <= 500
offset
integer
default:0

Rows to skip per wallet. Default 0.

Required range: x >= 0
Example:

0

Response

200

Standard { data, meta } envelope.