{"uid":"cap_QXmouhlxH3pgJtr7e-neh","slug":"tradesonar-dydx-whale-pnl-lookup-99ff2c04","name":"TradeSonar — dYdX Whale PnL Lookup","description":"TradeSonar: dYdX on-chain smart-money, funding and crowding signals. Every response is stamped with data_as_of freshness (block height + replica lag).","url":"https://api.tradesonar.io/v1/whales/%7Baddress%7D/pnl?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"positionCount":0,"fundingPaidUsd":"...","realizedPnlUsd":"...","fundingReceivedUsd":"..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KXOjkctLymyVtxFb1MM3-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns realized PnL, funding paid/received, and position count for a specific dYdX on-chain address, with block-level data freshness stamping.","exampleAgentPrompt":"Pull the on-chain PnL breakdown for dYdX address dydx1abc123xyz — I want to see realized PnL, total funding paid and received, and how fresh the data is.","exampleUseCases":[{"title":"Vetting a dYdX copy-trade target","prompt":"Before I start copy-trading this dYdX whale, can you pull their realized PnL and funding stats from TradeSonar for address dydx1qp8f7k2mn3r9s — I want to know if they're actually profitable net of funding costs."},{"title":"Auditing smart-money funding drag","prompt":"I'm analyzing whether smart-money dYdX traders are being eaten alive by funding fees — look up the funding paid vs received for address dydx1xz99t8w4v2r1j and tell me their net funding position alongside realized PnL."},{"title":"Tracking a known whale's trading performance","prompt":"What's the current realized PnL and position count for dYdX wallet dydx1lm5n6p7q8r9st — I want to see the latest block-stamped snapshot of how they're doing overall."}],"resultDescription":"A JSON object containing the address's realized PnL in USD, total funding paid in USD, total funding received in USD, and the number of positions traded, along with a data_as_of timestamp including block height and replica lag indicating data freshness.","failureModes":["Invalid or malformed dYdX address returns a 400/404 error","Address with no dYdX trading history may return zero values across all fields","Replica lag may cause stale data during high-throughput periods (indicated in data_as_of field)","Payment of 0.002 USDC required per call — missing or failed x402 payment returns 402 Payment Required","Network or upstream dYdX node issues may cause temporary unavailability"],"whenToPreferThis":"Use this endpoint when you need realized PnL and funding cost breakdown for a specific dYdX perpetuals trader by wallet address. Prefer this over general market endpoints when your goal is evaluating a specific wallet's historical profitability, funding drag, or trade count — e.g. for copy-trading vetting, smart-money attribution, or on-chain due diligence. Not suited for market-wide signals or real-time price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:31:52.951Z","isFirstParty":false,"canonicalSlug":"tradesonar-dydx-whale-pnl-lookup-99ff2c04"}