{"uid":"cap_bK65tFZTgtstJz-rKYpyo","slug":"market-intelligence-api-positioning-endpoint-6484cfc4","name":"Market Intelligence API – Positioning Endpoint","description":"Pay-per-call market intelligence for AI agents across crypto, US and European stocks, rates and FX: on-chain buy/sell pressure, trading decisions from $0.05, token risk checks on six chains, webhook alerts, pre-trade verdicts, technicals, perps funding, smart money, SEC and ESEF fundamentals, insider trades, European short interest, ECB rates and FX, datasets and news.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/positioning/%7Bsymbol%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"spot":null,"perps":{"venues":[{"venue":"gmx_v2_arbitrum","market":"GOLD/USD","fundingPaidBy":"LONGS","openInterestLongUsd":182798,"openInterestShortUsd":157838,"fundingRateAnnualPercent":17.33}],"positioning":"BALANCED","longSharePercent":54.6,"openInterestLongUsd":397242,"openInterestShortUsd":330086,"openInterestChange24hPercent":3.2},"symbol":"XAUUSD","coverage":["perps:gmx_v2_arbitrum","perps:gtrade_arbitrum"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dm9muDo4tGhzzM22PhIxT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns on-chain and cross-venue positioning data (open interest, long/short split, funding rates) for a given crypto or tokenized US equity symbol.","exampleAgentPrompt":"What's the current long/short positioning for ETHUSD across all perp venues — who's paying funding, and is the market balanced or skewed?","exampleUseCases":[{"title":"Pre-trade long/short check for Bitcoin","prompt":"Before I open a long on Bitcoin, can you pull the current positioning data for BTCUSD — I want to know if the market is crowded long and what the funding rate looks like on GMX and other venues?"},{"title":"Gold perpetuals funding rate monitor","prompt":"Check on-chain positioning for XAUUSD — are longs or shorts paying funding right now, and how has open interest changed in the last 24 hours?"},{"title":"Crowded-trade risk screen for NVDA","prompt":"I'm thinking about a position in NVDA tokenized perps — can you look up the long/short split and open interest across venues so I can see if the trade is already crowded?"}],"resultDescription":"JSON object with top-level symbol, a coverage array listing which venue/product pairs are included, and nested spot/perps objects. The perps block contains aggregate openInterestLongUsd, openInterestShortUsd, longSharePercent, openInterestChange24hPercent, a positioning label (e.g. BALANCED), and a venues array where each entry shows the venue name, market, which side pays funding, per-venue open interest, and the annualized funding rate.","failureModes":["Symbol not found or unsupported — likely returns null spot/perps data or an error object","No coverage for requested symbol on any venue — coverage array will be empty","402 Payment Required if x402 payment header is missing or malformed","Rate limiting or upstream venue data unavailability causing stale or partial results","Invalid path parameter format causing 400 or 404 response"],"whenToPreferThis":"Use this endpoint when you need a consolidated cross-venue view of who is long vs short (and by how much) for a specific symbol, including funding rate dynamics. Prefer it over general candle or signal endpoints when the specific question is about positioning imbalance, crowded trades, or funding cost — not price direction or trade timing verdicts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:31:45.122Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-positioning-endpoint-6484cfc4"}