{"uid":"cap_-7BY1tLQ7d4ei83DsDXBD","slug":"tradesonar-current-open-positions-for-a-dydx-address-7a4c7834","name":"TradeSonar: Current Open Positions for a dYdX Address","description":"Current open positions for an address","url":"https://api.tradesonar.io/v1/whales/:address/positions?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__wvr907cFcRZmnNrClHyE","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 the current open perpetual positions held by a specified dYdX wallet address, enabling whale tracking and smart-money analysis.","exampleAgentPrompt":"What open positions is the dYdX whale address dydx1yckl... currently holding — which markets are they long or short on, and what's their exposure?","exampleUseCases":[{"title":"Whale position monitoring for signals","prompt":"Pull up the current open positions for the dYdX address dydx1abc123... — I want to see which markets they're in and whether they're long or short before I make my next trade."},{"title":"Smart-money copytrading research","prompt":"I'm looking at the top dYdX leaderboard traders — can you show me the live open positions for dydx1xyz789... so I can see what they're betting on right now?"},{"title":"Crowding and concentration analysis","prompt":"I want to understand how concentrated a specific whale is — fetch the open positions for dydx1qrs456... so I can see if they're overexposed to one market."}],"resultDescription":"Returns a list of currently open perpetual positions for the given dYdX address, including market identifiers, long/short side, position size, entry price, and likely unrealized PnL. Each response is timestamped to indicate data freshness.","failureModes":["Invalid or malformed dYdX address returns a 400 or 404 error","Address with no open positions returns an empty positions array","Network or upstream dYdX data outage may cause 503 or timeout","Stale data if dYdX chain has latency; timestamp in response indicates freshness","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need real-time open position data for a specific dYdX wallet — especially for whale tracking, smart-money copying, or crowding analysis. Prefer this over generic blockchain explorers because it surfaces structured perpetual position data (size, side, entry price) rather than raw transaction history. Combine with /v1/whales/leaderboard to discover top addresses to query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:46:34.018Z","isFirstParty":false,"canonicalSlug":"tradesonar-current-open-positions-for-a-dydx-address-7a4c7834"}