Skip to main content
POST
POST /v1/wallet/pnl · 2 credits per 5 wallets (2 more per wallet with include=portfolio) Batch twin: up to 20 wallets per call, response array in input order. Each slot is { data, from, to }: data is the body of the single GET for that wallet (PnL curve plus summary) and from / to the window it covers, or { error } when that wallet failed, so one wallet never fails the others. The window (period, or from / to), include and its includeNative / includeStables options apply to every wallet of the call. Billed 2 credits per 5 wallets served (1 to 5 wallets cost 2 credits, a full call of 20 costs 8); the same address requested on several chains counts as one wallet. meta.total gives the combined total of the wallets of the call.
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. A slot’s data is exactly what GET /v1/wallet/pnl returns for that wallet with the same window and include, usdBasis included; see that page for the fields.
Window. period (1d, 7d, 30d by default, or all) or from / to (unix milliseconds, both inclusive) are shared by the whole call, exactly as on the GET. A slot’s from and to are the meta.from and meta.to of that GET: the window that wallet’s figures cover. Every wallet of a call is computed on the same window; two slots only differ where the history of one of them is not that deep or that fine (Solana PnL starts on 2026-02-01; on EVM chains a bound that cuts a UTC day before 2025-09-27 moves out to the edge of that day). A window that is refused (period with from or to, a bound in seconds, from later than to, a from in the future) is a 400 on the call, not an error per slot.
include (optional, shared by the whole call, a comma-separated string or a list) takes portfolio: each wallet served then carries its portfolio block (current value of its token positions, unrealized PnL, number of open positions), exactly as the GET returns it with include=portfolio. includeNative and includeStables (optional, shared by the whole call) count the native coin and stablecoin balances in each block, as on the GET, and tradedInWindow adds traded to each block (the figures limited to the tokens traded inside the slot’s from / to); sent as true without include=portfolio, they are a 400 on the call. A slot in error carries no block, and an unknown value is a 400 on the call. The option costs 2 more credits per wallet whose block is served, counted like the batch itself (the same address requested on several chains is one wallet): 20 wallets with their block cost 8 + 40 = 48 credits. A wallet whose block is null pays the batch price only. A batch with include=portfolio counts 2 per item in the Wallet rate group: a batch of 20 counts 40.
Combined total. meta.total adds up the wallets of the call, for a user who tracks several wallets: realizedPnlUsd, trades, wins, losses, buys, sells, boughtUsd and soldUsd are the sums of the slots’ summary, and winRate is computed again from the summed wins and losses (never an average of rates). wallets is the number of slots counted and failed the number of slots in error, which are left out. Each slot keeps its own window: on Solana the history starts on 2026-02-01, and the total adds up what each slot covers. realizedPnlNative, boughtNative and soldNative are summed only when every wallet counted is on the same single chain; otherwise they are null. The fee fields are summed the same way, and feesNative follows the rule of the native values. tradedTokens is not in the total: a token traded by two wallets would count twice. With include=portfolio, total.portfolio adds up totalValueUsd, unrealizedPnlUsd and positions over the blocks served (wallets says how many; a null block is left out), and with tradedInWindow=true carries traded with the same three sums. The same item sent twice (same address, same chains) counts once. The same address sent twice on chains that overlap without being the same (for example chain=evm:8453 and no chain, which covers every EVM chain) would count its trades twice: total is then null. The total costs nothing more.

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.

Required array length: 1 - 20 elements
period
enum<string>

Same as the GET, applied to every wallet: 1d, 7d, 30d (default) or all. Not combined with from / to.

Available options:
1d,
7d,
30d,
all
from
integer

Same as the GET, applied to every wallet: inclusive lower time bound, unix MILLISECONDS. A value in seconds is rejected (400).

Required range: x >= 0
to
integer

Same as the GET, applied to every wallet: inclusive upper time bound, unix MILLISECONDS. A value in seconds is rejected (400).

Required range: x >= 0
include

Same as the GET, applied to every wallet: portfolio (a comma-separated string or a list) adds the portfolio block to each wallet served. 2 more credits per wallet whose block is served: 20 wallets cost 8 + 40 = 48 credits. Absent unless you ask; an empty value adds nothing; an unknown value is a 400 on the call.

Example:

"portfolio"

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

tradedInWindow
boolean
default:false

Same as the GET, applied to every wallet: each block carries traded, on the window of its slot.

Example:

false

Response

200

Standard { data, meta } envelope.