Skip to main content
GET
GET /v1/wallet/closed-positions · 2 credits Every position a wallet has fully exited: tokens bought and sold, average entry and exit prices, total bought and sold (USD and native), realized PnL in absolute and percent, buy/sell counts, first and last trade time. The realized counterpart of /v1/wallet/positions - the realized PnL of every position lands in exactly one of the two. EVM and Solana.
USD figures are valued at the native coin’s USD price at the time of each trade, on EVM and Solana alike. boughtTokens and soldTokens are the token amounts bought and sold over the position’s life. entryPriceUsd is the average price paid over every buy (totalBuyUsd / boughtTokens; null when the wallet never bought the token, for example tokens received by transfer then sold) and exitPriceUsd the average price of every sell (totalSellUsd / soldTokens), the same rule as exitPriceUsd on /v1/wallet/positions. firstTradeAt and lastTradeAt are the position’s first and last trade. decimals is the token’s decimals. buyFeesUsd, sellFeesUsd and totalFeesUsd are the fees paid trading the token (network fees, tips and platform fees, in USD at the time of each transaction); null when not available for the position. realizedPnlPercent is realized PnL over total USD bought. meta.hasMore signals another page; meta.oldestAt is the last row’s exit time; meta.asOf is the moment the holdings were read on-chain, shared by every page of the same snapshot.
Chains. Omit chain for every EVM chain of a hex address (a base58 address is Solana), pass chain for one chain, or chains for several: public chain ids comma-separated (chains=evm:8453,evm:56) or as a repeated parameter, evm for every EVM chain. Rows, sort and pages cover the requested chains only. Every chain must belong to the wallet’s family; send chain or chains, not both. The call costs 2 credits whatever the number of chains.
tokens= scopes the response to 1 to 50 token addresses: a fully-exited token in one call (where the wallet got in and out, and its realized PnL), without paging the wallet. A token whose bag is fully sold but still shows a residual balance is listed here with its realized PnL, and on /v1/wallet/positions as a holding with buys and sells at 0.
Time window. from and to (unix milliseconds, both inclusive) keep the positions whose last trade (lastTradeAt) falls in that window: from=1785542400000&to=1788220799999 lists the positions closed in August 2026 (UTC). Rows, sort and pages cover the window only. On Solana a request lists up to the 1,000 most recent closed positions of its window: for a wallet that closes more, page through shorter windows (for example to set just before the previous meta.oldestAt).

Authorizations

Authorization
string
header
required

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

Query Parameters

wallet
string
required

Wallet address (EVM hex, case-insensitive; Solana base58).

chain
string

Public chain id - evm:<id> or solana. Omit for all EVM chains.

chains

Public chain ids, comma-separated or as a repeated parameter: evm:<id>, solana, or evm for every EVM chain (combine it with explicit ids freely). Rows, sort and pages cover those chains only. Every chain must belong to the wallet's family (EVM chains for a hex address, solana for a base58 address). Send chain or chains, not both; omit both for every EVM chain of a hex address.

tokens
string

Comma-separated token addresses (1-50) to scope the response to: where the wallet got in and out of those tokens and their realized PnL, without paging the whole wallet.

limit
integer
default:30

1-100. Default 30.

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

Rows to skip. Default 0.

Required range: x >= 0
sort
enum<string>
default:lastTradeAt

lastTradeAt (default) or pnl.

Available options:
lastTradeAt,
pnl
from
integer

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

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).

Required range: x >= 0

Response

200

Standard { data, meta } envelope.