curl 'https://api.serialized.xyz/v1/wallet/closed-positions?chain=solana&wallet=GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E&limit=2&sort=pnl' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "solana",
"address": "9x4EQVaPRWSw4jKoWTpRzMP7YAu5sZwHyLJ9tbJYpump",
"symbol": "JOKE",
"name": "Jokecoin",
"iconUrl": "https://serialized.cloud/token/24edc11a-af3e-4b87-b419-50ccf51ba34c/icon",
"decimals": 6,
"totalBuyUsd": 41.208763,
"totalSellUsd": 58.913145,
"totalBuyNative": 0.198734,
"totalSellNative": 0.284102,
"realizedPnlUsd": 17.704382,
"realizedPnlNative": 0.085368,
"realizedPnlPercent": 42.96,
"buyCount": 4,
"sellCount": 3,
"lastTradeAt": 1786940537718,
"buyFeesUsd": 0.016744,
"sellFeesUsd": 0.019118,
"totalFeesUsd": 0.035862
},
{
"chain": "solana",
"address": "GFQLVG2UKYydSCJ2WjkuMXijpgJ6hbs2nEsNwdZFpump",
"symbol": "Tortuga",
"name": "Tortuga",
"iconUrl": null,
"decimals": 6,
"totalBuyUsd": 7.444819,
"totalSellUsd": 3.836057,
"totalBuyNative": 0.035902,
"totalSellNative": 0.018501,
"realizedPnlUsd": -3.608762,
"realizedPnlNative": -0.017401,
"realizedPnlPercent": -48.47,
"buyCount": 1,
"sellCount": 1,
"lastTradeAt": 1786907901306,
"buyFeesUsd": 0.019147,
"sellFeesUsd": 0.026285,
"totalFeesUsd": 0.045432
}
],
"meta": {
"asOf": 1787163135112,
"hasMore": false,
"oldestAt": 1786907901306
}
}
Wallet Closed Positions
Wallet Closed Positions
Every position a wallet has fully exited: total bought and sold (USD and native), realized PnL in absolute and percent, buy/sell counts 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.
GET
/
v1
/
wallet
/
closed-positions
curl 'https://api.serialized.xyz/v1/wallet/closed-positions?chain=solana&wallet=GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E&limit=2&sort=pnl' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "solana",
"address": "9x4EQVaPRWSw4jKoWTpRzMP7YAu5sZwHyLJ9tbJYpump",
"symbol": "JOKE",
"name": "Jokecoin",
"iconUrl": "https://serialized.cloud/token/24edc11a-af3e-4b87-b419-50ccf51ba34c/icon",
"decimals": 6,
"totalBuyUsd": 41.208763,
"totalSellUsd": 58.913145,
"totalBuyNative": 0.198734,
"totalSellNative": 0.284102,
"realizedPnlUsd": 17.704382,
"realizedPnlNative": 0.085368,
"realizedPnlPercent": 42.96,
"buyCount": 4,
"sellCount": 3,
"lastTradeAt": 1786940537718,
"buyFeesUsd": 0.016744,
"sellFeesUsd": 0.019118,
"totalFeesUsd": 0.035862
},
{
"chain": "solana",
"address": "GFQLVG2UKYydSCJ2WjkuMXijpgJ6hbs2nEsNwdZFpump",
"symbol": "Tortuga",
"name": "Tortuga",
"iconUrl": null,
"decimals": 6,
"totalBuyUsd": 7.444819,
"totalSellUsd": 3.836057,
"totalBuyNative": 0.035902,
"totalSellNative": 0.018501,
"realizedPnlUsd": -3.608762,
"realizedPnlNative": -0.017401,
"realizedPnlPercent": -48.47,
"buyCount": 1,
"sellCount": 1,
"lastTradeAt": 1786907901306,
"buyFeesUsd": 0.019147,
"sellFeesUsd": 0.026285,
"totalFeesUsd": 0.045432
}
],
"meta": {
"asOf": 1787163135112,
"hasMore": false,
"oldestAt": 1786907901306
}
}
GET /v1/wallet/closed-positions · 2 credits
Every position a wallet has fully exited: total bought and sold (USD and native), realized PnL in absolute and percent, buy/sell counts 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.
On Solana, USD figures are valued at the SOL price at the time of each trade; on EVM chains, at the current native price.
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.tokens= scopes the response to 1 to 50 token addresses: the realized PnL of a fully-exited token in one call, 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.curl 'https://api.serialized.xyz/v1/wallet/closed-positions?chain=solana&wallet=GuhieZDx6nwJV14WjeUQH2ted6CGPKoGCCTaPSPNgG2E&limit=2&sort=pnl' \
-H 'Authorization: YOUR_API_KEY'
{
"data": [
{
"chain": "solana",
"address": "9x4EQVaPRWSw4jKoWTpRzMP7YAu5sZwHyLJ9tbJYpump",
"symbol": "JOKE",
"name": "Jokecoin",
"iconUrl": "https://serialized.cloud/token/24edc11a-af3e-4b87-b419-50ccf51ba34c/icon",
"decimals": 6,
"totalBuyUsd": 41.208763,
"totalSellUsd": 58.913145,
"totalBuyNative": 0.198734,
"totalSellNative": 0.284102,
"realizedPnlUsd": 17.704382,
"realizedPnlNative": 0.085368,
"realizedPnlPercent": 42.96,
"buyCount": 4,
"sellCount": 3,
"lastTradeAt": 1786940537718,
"buyFeesUsd": 0.016744,
"sellFeesUsd": 0.019118,
"totalFeesUsd": 0.035862
},
{
"chain": "solana",
"address": "GFQLVG2UKYydSCJ2WjkuMXijpgJ6hbs2nEsNwdZFpump",
"symbol": "Tortuga",
"name": "Tortuga",
"iconUrl": null,
"decimals": 6,
"totalBuyUsd": 7.444819,
"totalSellUsd": 3.836057,
"totalBuyNative": 0.035902,
"totalSellNative": 0.018501,
"realizedPnlUsd": -3.608762,
"realizedPnlNative": -0.017401,
"realizedPnlPercent": -48.47,
"buyCount": 1,
"sellCount": 1,
"lastTradeAt": 1786907901306,
"buyFeesUsd": 0.019147,
"sellFeesUsd": 0.026285,
"totalFeesUsd": 0.045432
}
],
"meta": {
"asOf": 1787163135112,
"hasMore": false,
"oldestAt": 1786907901306
}
}
Authorizations
Your raw API key (not needed on the demo server).
Query Parameters
Wallet address (EVM hex, case-insensitive; Solana base58).
Public chain id - evm:<id> or solana. Omit for all EVM chains.
Comma-separated token addresses (1-50) to scope the response to: the realized PnL of those tokens, without paging the whole wallet.
1-100. Default 30.
Required range:
1 <= x <= 100Rows to skip. Default 0.
Required range:
x >= 0lastTradeAt (default) or pnl.
Available options:
lastTradeAt, pnl Response
200
Standard { data, meta } envelope.