curl 'https://api.serialized.xyz/v1/wallet/pnl?wallet=GW4XaKAEuwQ2NiKAj43GaaXRpFv4SvhjCTU3HWTw5E4R&chain=solana&period=7d' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"usdBasis": "trade",
"history": [
{
"at": 1794841200000,
"realizedPnlUsd": 3754.3051400390214,
"trades": 4,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
],
"summary": {
"realizedPnlUsd": 3754.3051400390214,
"winRate": 100,
"trades": 4,
"wins": 2,
"losses": 0,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"tradedTokens": 2,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
},
"meta": {
"asOf": 1795012552657,
"from": 1794407700000,
"to": 1795012552657
}
}
Wallet PnL
Realized PnL of a wallet over a time window: PnL curve (daily buckets, hourly when the window starts within the last 8 days) plus summary (total realized, win rate, wins/losses, trades split into buys and sells with their USD volumes, tokens traded). Pick the window with period or with your own from / to. include=portfolio adds the wallet’s current value, unrealized PnL and number of open positions, with the native coin and stablecoin balances on request. Omit chain to combine every EVM chain; chains combines a list of EVM chains; chain=solana for Solana.
curl 'https://api.serialized.xyz/v1/wallet/pnl?wallet=GW4XaKAEuwQ2NiKAj43GaaXRpFv4SvhjCTU3HWTw5E4R&chain=solana&period=7d' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"usdBasis": "trade",
"history": [
{
"at": 1794841200000,
"realizedPnlUsd": 3754.3051400390214,
"trades": 4,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
],
"summary": {
"realizedPnlUsd": 3754.3051400390214,
"winRate": 100,
"trades": 4,
"wins": 2,
"losses": 0,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"tradedTokens": 2,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
},
"meta": {
"asOf": 1795012552657,
"from": 1794407700000,
"to": 1795012552657
}
}
GET /v1/wallet/pnl · 2 credits (4 with include=portfolio)
Realized PnL of a wallet over a time window: PnL curve (daily buckets, hourly when the window starts within the last 8 days) plus summary (total realized, win rate, wins/losses, trades split into buys and sells with their USD volumes, tokens traded). Pick the window with period or with your own from / to. include=portfolio adds the wallet’s current value, unrealized PnL and number of open positions, with the native coin and stablecoin balances on request. Omit chain to combine every EVM chain; chains combines a list of EVM chains; chain=solana for Solana.
usdBasis says how USD amounts were computed: trade = amounts valued at the native coin’s USD price at the time of the trade. On Solana each trade is valued at the SOL price of its minute (the realized PnL is the same figure as on the wallet’s positions); on EVM chains each day’s realized PnL and volumes are valued at that day’s native USD price.buys and sells split trades (trades = buys + sells), and boughtUsd / soldUsd are the USD value of what was bought and sold. The four are on summary and on every point of history. A trade is one token bought or sold in one transaction: a token that a swap only routes through is not a trade, and the other side of the swap (the native coin or stablecoin paid or received) is not counted. On the hourly curve, the figures of a day are spread over the hours of that day in which the wallet sold, in proportion to the volume sold: the points of a day add up to that day’s totals, and a day with no sale stays one point, at 00:00 UTC or at the first hour of the window on that day.realizedPnlNative, boughtNative and soldNative, on summary and on every point of history, are realizedPnlUsd, boughtUsd and soldUsd in the chain’s native coin (ETH, BNB, SOL…), read as stored, with no exchange rate involved. On chains whose native coin is a stablecoin they equal the USD figures. Native coins of different chains don’t add up, so these fields are only served when the call covers one chain: chain=solana, chain=<one EVM chain>, or chains with a single chain. On a call over several EVM chains (no chain, chains=evm, or a list of chains) they are null, whatever chains the wallet traded on.gasFeesUsd, mevFeesUsd, platformFeesUsd and totalFeesUsd, on summary and on every point of history, are the fees the wallet paid on its trades: the network fee, the tips paid to validators and the trading platform fee, each transaction counted once, and feesNative is their total in the native coin. realizedPnlUsd is before fees: the net PnL is realizedPnlUsd minus totalFeesUsd. Served on Solana; a field is null when it is not known for the period.summary.tradedTokens is the number of distinct tokens traded at least once over the period, with the same definition of a trade; the same token on two chains counts twice. It is null when the count is not known, which is always the case for a wallet that traded more than 20,000 tokens over the period, all the chains of its family together, whatever chain or chains selects. When the window ends in the past, it counts every token last traded since from: a token traded again after to is counted even without a trade inside the window, so read the figure as an upper bound.include=portfolio adds a portfolio object after summary: the wallet as it stands now, whatever the window (period, from, to), on the chains of the call. totalValueUsd is the current value of its token positions, unrealizedPnlUsd their unrealized PnL, positions the number of positions /v1/wallet/positions lists by default, and asOf the moment the balances were read (milliseconds). The native coin and stablecoin balances are not counted unless you ask for them: includeNative=true and includeStables=true have the meaning they have on /v1/wallet/positions, and those balances then count in totalValueUsd and in positions (they carry no PnL, so unrealizedPnlUsd does not change). These are the figures of meta.summary of GET /v1/wallet/positions called on the same chains with the same includeNative and includeStables and its other options at their defaults. The two options cost nothing more, and are only accepted with include=portfolio: sent as true without it, the call is a 400. The option costs 2 more credits: the call is billed 4 credits when the block is served. portfolio is null when the positions cannot be computed: the PnL is served and the option is not billed. A call with include=portfolio counts 2 in the Wallet rate group.tradedInWindow=true, with include=portfolio, adds portfolio.traded: the same totalValueUsd, unrealizedPnlUsd and positions, limited to the open positions in tokens the wallet traded at least once inside the window (meta.from to meta.to). summary.realizedPnlUsd plus portfolio.traded.unrealizedPnlUsd is a profit for the period that leaves out the positions the wallet did not touch during it. The values are as of now, also when the window ends in the past, and a position counts with its whole balance, the part bought before the window included. Native coin and stablecoin balances are never part of traded. When the window ends in the past, a token traded before and after it counts even without a trade inside, as for summary.tradedTokens. The option costs nothing more and is only accepted with include=portfolio: sent as true without it, the call is a 400.chains takes public chain ids, comma-separated (chains=evm:8453,evm:1) or as a repeated parameter, evm for every EVM chain: the curve, the summary and the portfolio block cover those chains only. Every chain must belong to the wallet’s family; send chain or chains, not both. The call costs the same whatever the number of chains.period is 1d, 7d, 30d (default) or all. 1d and 7d cover the last 24 hours and the last 7 days up to now. 30d keeps whole UTC days: from 00:00 UTC thirty days ago through now. all is the whole history. period is not combined with from / to.from and to bound the PnL in unix milliseconds, both inclusive, exact to the second: from=1785542400000&to=1788220799999 is August 2026 (UTC). Send one or both: without from the window starts at the beginning of the history, without to it ends now, and a to within the last minute is treated as now. A from later than to, a from in the future, or period sent together with from or to is a 400.meta.from and meta.to give the window the response covers, in unix milliseconds, both inclusive, whether you sent period or your own bounds. meta.from is null when the window has no lower bound (period=all, or to alone, on EVM chains). They follow your bounds to the second (a from between two seconds starts at the next one, a to covers its whole second), except where the history is not that deep or that fine: Solana PnL starts on 2026-02-01, and on EVM chains a bound that cuts a UTC day before 2025-09-27 moves out to the edge of that day. Read the window from meta rather than from your request.at is the start of the bucket (UTC). The first and the last bucket only hold the part of their hour or day that is inside the window, so the first at can be earlier than meta.from.period=1d or period=7d rather than a from you recompute on every call: it is the same window and it answers faster. To end a window now, leave to out.curl 'https://api.serialized.xyz/v1/wallet/pnl?wallet=GW4XaKAEuwQ2NiKAj43GaaXRpFv4SvhjCTU3HWTw5E4R&chain=solana&period=7d' \
-H 'Authorization: YOUR_API_KEY'
{
"data": {
"usdBasis": "trade",
"history": [
{
"at": 1794841200000,
"realizedPnlUsd": 3754.3051400390214,
"trades": 4,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
],
"summary": {
"realizedPnlUsd": 3754.3051400390214,
"winRate": 100,
"trades": 4,
"wins": 2,
"losses": 0,
"buys": 2,
"sells": 2,
"boughtUsd": 2828.304011800208,
"soldUsd": 6582.6091518392295,
"tradedTokens": 2,
"realizedPnlNative": 52.86639331800001,
"boughtNative": 39.506172836,
"soldNative": 92.372566154,
"gasFeesUsd": 0.015693572972512768,
"mevFeesUsd": 0.014241694013190335,
"platformFeesUsd": 29.329812705102203,
"totalFeesUsd": 29.359747972087906,
"feesNative": 0.41198728700000004
}
},
"meta": {
"asOf": 1795012552657,
"from": 1794407700000,
"to": 1795012552657
}
}
Query Parameters
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). The curve and the summary combine 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.
Extras, comma-separated or with the parameter repeated. portfolio adds a portfolio object after summary: the current value of the wallet's token positions (totalValueUsd), their unrealized PnL (unrealizedPnlUsd) and the number of open positions (positions), the figures of meta.summary of /v1/wallet/positions. 2 more credits when the block is served (4 for the call). Absent unless you ask; an empty value adds nothing; an unknown value is a 400.
With include=portfolio: the portfolio block also carries traded, the same three figures limited to the open positions in tokens the wallet traded inside the window. Values as of now. No extra credit. Sent as true without include=portfolio, the call is a 400. Default false.
Response
Standard { data, meta } envelope.