{"uid":"cap_F_ChOFj-M2tFQe-KQ27EQ","slug":"hivemindos-wallet-token-p-l-2e04143d","name":"HivemindOS Wallet Token P&L","description":"Wallet profit and loss by token: one wallet's realized and unrealized profit and loss for each token it traded. Use when an agent needs to know how well a wallet has traded each token before following it. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.","url":"https://api.hivemindos.app/v1/x402/onchain-intelligence/wallets.tokenPnl?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"}},"description":"The window to read, as YYYY-MM-DD dates. Defaults to recent days."},"chain":{"type":"string","description":"Chain name, such as base, ethereum or solana."},"address":{"type":"string","description":"EVM address (0x…) or Solana address."},"orderBy":{"type":"array","maxItems":3,"description":"Optional sort, e.g. [{ field: \"volume\", direction: \"DESC\" }]."},"request":{"type":"string","maxLength":2000,"description":"The read in plain words, naming the address, $SYMBOL, chain or exchange."},"tokenAddress":{"type":"string","description":"EVM address (0x…) or Solana address."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D2HXFXz-sODPSY2tOPh-i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns realized and unrealized profit and loss broken down by token for a single on-chain wallet, over a specified date range.","exampleAgentPrompt":"Can you pull the realized and unrealized profit and loss by token for wallet 0x4f3eD...aB12 on Ethereum, covering January 1 to March 31 2025, sorted by volume descending — I want to see how well they traded before I consider copy-trading them.","exampleUseCases":[{"title":"Copy-trade vetting by PnL","prompt":"Before I start copy-trading this wallet 0xABC123...def on Base, can you show me its realized and unrealized PnL broken down by each token it traded over the past 90 days? Sort by total profit descending."},{"title":"Solana whale performance audit","prompt":"I want to know how much this Solana whale wallet 7xKp...mNqR made or lost on each token it traded between January 1 and June 30 2025 — give me both realized and unrealized gains."},{"title":"Token-specific wallet loss screening","prompt":"Can you check wallet 0x9Fa2...3C11 on Ethereum and tell me which tokens it has the biggest unrealized losses on right now, looking at trades from the last 60 days?"}],"resultDescription":"A structured list of tokens the wallet has traded, each with realized PnL, unrealized PnL, trade volume, and related metrics for the specified date window. Results can be sorted by volume or PnL fields as specified.","failureModes":["Invalid or unrecognized wallet address returns an error or empty result","Unsupported chain name returns a validation error","Date range with no trading activity returns empty token list","Payment of $0.05 USDC on Base fails if wallet has insufficient balance or network issue","Request times out for wallets with extremely high trade counts"],"whenToPreferThis":"Use this endpoint when you need per-token realized and unrealized PnL for a specific wallet — especially for copy-trade vetting, whale tracking, or portfolio auditing. Prefer it over generic block explorers when you need structured, computed PnL rather than raw transaction history. It complements the Perp positions endpoint (which covers Hyperliquid perpetuals) by handling spot token trading across EVM and Solana chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:32:49.351Z","isFirstParty":false,"canonicalSlug":"hivemindos-wallet-token-p-l-2e04143d"}