{"uid":"cap_Ev55AFhTJge4Uz2myixSx","slug":"tradesonar-whale-pnl-summary-67f5385d","name":"TradeSonar Whale PnL Summary","description":"Realized PnL and funding summary for an address","url":"https://api.tradesonar.io/v1/whales/:address/pnl?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"dYdX address, e.g. dydx1yckl... — get top addresses from /v1/whales/leaderboard"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_HhPDyxcjpFdKtQtDWo958","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 profit/loss and funding payment summary for a specific dYdX whale address","exampleAgentPrompt":"What's the realized PnL and funding summary for the dYdX address dydx1yckl...? I want to know how profitable this whale has been.","exampleUseCases":[{"title":"Whale profitability due diligence","prompt":"Look up the realized PnL and funding summary for dYdX address dydx1abc123xyz — I want to know if this whale is actually profitable before I start copy-trading them."},{"title":"Smart money tracker performance review","prompt":"Can you pull the realized profit/loss and funding payments for dydx1xyz456def on dYdX? I'm tracking their performance over time as part of my smart money watchlist."},{"title":"Funding carry analysis for a specific trader","prompt":"Get me the funding breakdown for dYdX address dydx1qrs789ghi — I want to see how much they've earned or paid in funding relative to their realized trading gains."}],"resultDescription":"Returns a summary of realized PnL (closed position gains and losses) and funding payment history for the specified dYdX address, allowing assessment of overall trading profitability and carry income/costs.","failureModes":["Invalid or malformed dYdX address returns 400 or empty result","Address with no trading history returns empty or zero values","Rate limiting or payment failure for x402 micropayment returns 402","Stale data if address has very recent trades not yet indexed"],"whenToPreferThis":"Use this endpoint when you need historical realized PnL and funding summary for a specific dYdX trader or whale address. Prefer this over general market endpoints when the focus is on individual address performance rather than market-wide crowding or funding signals. Pair with the /whales/leaderboard endpoint to discover top addresses first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:45:18.346Z","isFirstParty":false,"canonicalSlug":"tradesonar-whale-pnl-summary-67f5385d"}