# Nansen Prediction Market Position Detail

> Nansen Prediction Market Position Detail is a paid API for AI agents from api.nansen.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Retrieves detailed position information for a specific prediction market, including holdings, exposure, and related analytics.

## Facts

- Endpoint: GET https://api.nansen.ai/api/v1/prediction-market/position-detail
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nansen-6dcf76fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n2SJW_L5MrdbRMtKmnSfv

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 nansen-6dcf76fa
```

Example prompt: Pull up the full position detail on Nansen for the Polymarket market at contract address 0xabc123 — I want to see the breakdown of my holdings and exposure.

## When to prefer this

Use this endpoint when you need granular position-level detail for a specific prediction market, especially when you want Nansen's smart money context layered on top of raw on-chain data. Prefer this over the Top Holders endpoint when you need a single position's full detail rather than a leaderboard view.

## Known failure modes

- Invalid or missing market identifier returns 400 error
- Market address not found in Nansen database returns 404
- Insufficient credits or unpaid x402 payment returns 402
- Rate limiting or quota exceeded returns 429
- Malformed POST body returns 400 validation error

## How this service works

Get Prediction Market Position Detail

## Output

Returns detailed position information for a specified prediction market, including position size, exposure, holdings breakdown, and related on-chain analytics powered by Nansen's wallet labeling and smart money data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "title": "PositionDetailRequest",
 "required": [
  "market_id"
 ],
 "properties": {
  "market_id": {
   "type": "string",
   "title": "Market Id",
   "examples": [
    "654412"
   ],
   "maxLength": 100,
   "minLength": 1,
   "description": "Polymarket market ID"
  },
  "pagination": {
   "type": "object",
   "title": "PaginationRequest",
   "properties": {
    "page": {
     "type": "integer",
     "title": "Page",
     "default": 1,
     "minimum": 1,
     "description": "Page number (1-based)"
    },
    "per_page": {
     "type": "integer",
     "title": "Per Page",
     "default": 10,
     "maximum": 1000,
     "minimum": 1,
     "description": "Number of records per page (max 1000)"
    }
   },
   "description": "Pagination parameters for API requests."
  }
 },
 "description": "Request for position detail endpoint.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "PositionDetailResponse",
 "required": [
  "data"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "PositionDetailItem",
    "required": [
     "market_id"
    ],
    "properties": {
     "address": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Address",
      "description": "Holder address (hex)"
     },
     "balance": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Balance",
      "description": "Token balance"
     },
     "outcome": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Outcome",
      "examples": [
       "Yes"
      ],
      "description": "Outcome label"
     },
     "event_id": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Event Id",
      "description": "Parent event ID"
     },
     "token_id": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Token Id",
      "description": "CLOB token ID"
     },
     "market_id": {
      "type": "string",
      "title": "Market Id",
      "examples": [
       "654412"
      ],
      "description": "Market ID"
     },
     "buy_tokens": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Buy Tokens",
      "description": "Total tokens bought"
     },
     "event_title": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Event Title",
      "description": "Parent event title"
     },
     "sell_tokens": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Sell Tokens",
      "description": "Total tokens sold"
     },
     "buy_cost_usd": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Buy Cost Usd",
      "description": "Total buy cost in USD"
     },
     "current_price": {
      "anyOf": [
       {
        "type": "number"
       }
      ],
      "title": "Current Price",
      "description": "Current price"
     },
     "outcome_index": {
      "anyOf": [
       {
        "type": "integer"
       }
      ],
      "title": "Outcome Index",
      "examples": [
       1
      ],
      "description": "Outcome index"
     },
     "owner_address": {
      "anyOf": [
       {
        "type": "string"
       }
      ],
      "title": "Owner Address",
      "description": "SAFE proxy owner 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nansen-6dcf76fa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.nansen.ai](https://www.zero.xyz/host/api.nansen.ai/llms.txt)