Skip to main content
POST
POST /v1/wallet/closed-positions · 2 credits per wallet Batch twin: up to 20 wallets per call, response array in input order. Each slot is { data, hasMore, oldestAt, asOf }, the body of the single GET for that wallet, or { error } when that wallet failed, so one wallet never fails the others. limit, offset, sort, from and to 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 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, hasMore, oldestAt and asOf are exactly what GET /v1/wallet/closed-positions returns for that wallet with the same options; see that page for the row fields.

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 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
limit
integer
default:30
required

Page size per wallet, 1-100. Default 30.

Required range: 1 <= x <= 100
Example:

30

offset
integer
default:0
required

Rows to skip per wallet. Default 0.

Required range: x >= 0
Example:

0

sort
enum<string>
default:lastTradeAt

lastTradeAt (default) or pnl, applied to every wallet.

Available options:
lastTradeAt,
pnl
Example:

"lastTradeAt"

from
integer

Only positions whose last trade (lastTradeAt) is at or after this time, unix milliseconds (inclusive). A value in seconds is rejected (400). Applied to every wallet.

Required range: x >= 0
to
integer

Only positions whose last trade (lastTradeAt) is at or before this time, unix milliseconds (inclusive). A value in seconds is rejected (400). Applied to every wallet.

Required range: x >= 0

Response

200

Standard { data, meta } envelope.