{"uid":"cap_Ip-m2c1FYzf4033zC_3Pz","slug":"agents-allium-so-acf642f2","name":"Allium Wallet PnL","description":"Get wallet profit and loss","url":"https://agents.allium.so/api/v1/developer/wallet/pnl","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"address":{"type":"string","description":"Wallet address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"chain":"ethereum","tokens":[{"raw_balance":"1500000000000000000","average_cost":{"amount":"2400.00","currency":"USD","decimals":18},"realized_pnl":{"amount":"1200.00","currency":"USD","decimals":18},"current_price":{"amount":"2500.50","currency":"USD","decimals":18},"token_address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","unrealized_pnl":{"amount":"150.75","currency":"USD","decimals":18},"current_balance":{"amount":"3750.75","currency":"USD","decimals":18}}],"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","total_balance":{"amount":"3750.75","currency":"USD","decimals":18},"total_realized_pnl":{"amount":"1200.00","currency":"USD","decimals":18},"total_unrealized_pnl":{"amount":"150.75","currency":"USD","decimals":18}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dMcFXHs4lFWDPdyhrgy8K","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates realized and unrealized profit and loss for a given blockchain wallet address","exampleAgentPrompt":"What's the profit and loss for my Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? I want to see both realized and unrealized PnL.","exampleUseCases":null,"resultDescription":"Returns a breakdown of realized and unrealized profit and loss for the specified wallet, including token-level performance data showing gains and losses across trades and current holdings.","failureModes":["Invalid or malformed wallet address returns 400 error","Unsupported chain or network returns an error","Wallet with no transaction history may return empty or zero PnL","Payment failure (insufficient USDC balance) returns 402","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need computed PnL figures for a wallet rather than raw transaction history or balances alone. Prefer this over manually calculating gains from transaction history endpoints when you want ready-to-use realized/unrealized profit metrics for a specific address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:56:04.094Z","isFirstParty":false}