# Arkham x402 Polymarket Prices

> Arkham x402 Polymarket Prices is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.4/call, status unknown (last checked 2026-09-14).

Fetches historical or interval-based price data for a Polymarket prediction market token via Arkham's wallet intelligence platform using x402 pay-per-request.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/prices
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-prices-9c5bc968
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VNw-x0h4BjsYa2PWo2Oki

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 arkham-x402-polymarket-prices-9c5bc968 -d '<json body>'
```

Example prompt: Pull the hourly price history for Polymarket token 0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4 up through July 21 2026 using Arkham's Polymarket prices endpoint.

## When to prefer this

Use this endpoint when you need structured, interval-based price history for a specific Polymarket prediction market token and want to leverage Arkham's on-chain intelligence data. Prefer this over generic DEX price APIs when you need Polymarket-specific coverage and are already operating within an x402 micropayment flow.

## Known failure modes

- Invalid or unrecognized Polymarket token address returns empty prices array
- Insufficient x402 USDC payment results in 402 Payment Required error
- Malformed end time or unsupported interval value causes request rejection
- Token address for a non-Polymarket asset returns no data
- Rate limiting or quota exceeded on the Arkham API

## How this service works

Get Arkham Polymarket prices. Provide at least one of: tokenAddress, conditionID. $0.40 per call.

## Output

Returns a JSON object containing an array of price data points for the specified Polymarket token, along with the end time of the query window, the time interval used (e.g. '1h'), and the token address that was queried.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max number of price points to return (1-7500). Default: 500, or 7500 for interval=1s and interval=5s. When the requeste…"
  },
  "range": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Window selector anchored on the token's last bucket: 1d, 1w, 1m, all. Server picks the granularity. Overrides startTime…"
  },
  "endTime": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional Unix timestamp in seconds for end of range. Ignored when range is set."
  },
  "interval": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Price interval: 1s, 5s, 1m, 1h, 1d, auto. Default: 1h. 1s and 5s require startTime and endTime, with a maximum 2-hour s…"
  },
  "startTime": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional Unix timestamp in seconds for start of range. Ignored when range is set."
  },
  "conditionID": {
   "anyOf": [
    {
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "prices": [],
  "endTime": "2026-07-21T18:13:23.852372246Z",
  "interval": "1h",
  "tokenAddress": "0x7baa312d6393ea83c631fb77b47061651a2a9992c40fcac017009611d6a03df4"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-prices-9c5bc968/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)