{"uid":"cap_6iWMt9ZgmZxHk-mURO5hN","slug":"tradesonar-dydx-whale-positions-api-555fbeda","name":"TradeSonar dYdX Whale Positions API","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/positions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"positions":[{"side":"...","ticker":"...","sizeUsd":"...","openedAt":"...","markPrice":"...","entryPrice":"...","unrealizedPnlUsd":"..."}]}}},"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_1fqkpuDCboQLf9ZJJ9wDl","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":"Retrieves current open positions for a specific dYdX on-chain address, including side, size, entry price, mark price, and unrealized PnL.","exampleAgentPrompt":"Pull up the current open positions for dYdX address dydx1abc123xyz on TradeSonar — I want to see what markets they're in, whether they're long or short, their position sizes, and unrealized PnL.","exampleUseCases":[{"title":"Smart money copytrading research","prompt":"Look up the current dYdX positions for address dydx1qf2vz8r9k3lmwtx7npd6ujcves4ag0ez5 — I want to know what markets they're in, which direction they're positioned, and how big each trade is in USD."},{"title":"Whale crowding risk assessment","prompt":"Check what open positions the dYdX whale at dydx1ht9phgl8ljhkzxn8xhvlzpn4qe7npdklh is holding right now — I need to see if they're heavily concentrated in one market and what their entry prices look like."},{"title":"Smart money PnL monitoring","prompt":"I'm tracking a known dYdX smart money wallet at dydx1xvzrp2e5w8mnjyfkq3ars6l0dthuczqnm — can you fetch their current positions and tell me the unrealized PnL on each trade?"}],"resultDescription":"Returns a list of current open positions for the specified dYdX address, each including the market ticker, side (long/short), position size in USD, entry price, current mark price, unrealized PnL in USD, and the timestamp the position was opened. The response is stamped with a data_as_of field indicating freshness via block height and replica lag.","failureModes":["Invalid or malformed dYdX address returns a 400 or 404 error","Address with no open positions returns an empty positions array","Stale data due to replica lag may cause slightly outdated position values","Rate limiting or payment failure (x402) if USDC balance is insufficient","Address that has never traded on dYdX may return empty or not-found response"],"whenToPreferThis":"Use this endpoint when you need to inspect the current open positions of a specific known dYdX wallet address — especially for smart money tracking, copytrading research, or whale monitoring workflows. Prefer this over generic market endpoints when you have a target address and want position-level detail (size, side, PnL, entry price) rather than aggregate market signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:41.343Z","isFirstParty":false,"canonicalSlug":"tradesonar-dydx-whale-positions-api-555fbeda"}