# Market Intelligence API – Positioning Endpoint

> Market Intelligence API – Positioning Endpoint is a paid API for AI agents from api.marketintelligenceapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

Returns on-chain and cross-venue positioning data (open interest, long/short split, funding rates) for a given crypto or tokenized US equity symbol.

## Facts

- Endpoint: GET https://api.marketintelligenceapi.com/api/v1/intelligence/positioning/%7Bsymbol%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market-intelligence-api-positioning-endpoint-6484cfc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bK65tFZTgtstJz-rKYpyo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability market-intelligence-api-positioning-endpoint-6484cfc4
```

Example prompt: What's the current long/short positioning for ETHUSD across all perp venues — who's paying funding, and is the market balanced or skewed?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market-intelligence-api-positioning-endpoint-6484cfc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.marketintelligenceapi.com](https://www.zero.xyz/host/api.marketintelligenceapi.com/llms.txt)