Polymarket Full Order Book Price Levels in a Time Window (First 20 Snapshots)

omnial/polymarket-order-book-depth-snapshots

Given a Polymarket outcome token ID and a start and end time, returns the first 20 order book snapshots in that window, oldest first: each snapshot's time (Unix milliseconds), the market's condition ID, the token ID, the tick size and every bid and ask price level with its size (bids from the highest price down, asks from the lowest price up). Prices run from 0 to 1.

activeper callv1

Price

Up to $0.0328 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Polymarket

Data from Polymarket.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/polymarket-order-book-depth-snapshots" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/polymarket-order-book-depth-snapshots" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/polymarket-order-book-depth-snapshots", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/polymarket-order-book-depth-snapshots", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0328

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "token_id",
    "start_time",
    "end_time"
  ],
  "properties": {
    "limit": {
      "enum": [
        20
      ],
      "type": "integer",
      "default": 20,
      "description": "Snapshots returned: the first 20 in the window. The only value offered."
    },
    "end_time": {
      "type": "integer",
      "minimum": 1,
      "description": "End of the window, in Unix milliseconds; later than start_time."
    },
    "token_id": {
      "type": "string",
      "minLength": 1,
      "description": "The outcome token ID of one side (Yes or No) of a Polymarket market: a long decimal number, sent as a string."
    },
    "start_time": {
      "type": "integer",
      "minimum": 1,
      "description": "Start of the window, in Unix milliseconds."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "snapshots": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "asks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "type": "number",
                  "description": "Shares offered at this price."
                },
                "price": {
                  "type": "number",
                  "description": "Ask price, 0 to 1."
                }
              }
            },
            "description": "Every ask price level, lowest price first."
          },
          "bids": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "size": {
                  "type": "number",
                  "description": "Shares bid at this price."
                },
                "price": {
                  "type": "number",
                  "description": "Bid price, 0 to 1."
                }
              }
            },
            "description": "Every bid price level, highest price first."
          },
          "market": {
            "type": "string",
            "description": "The market's condition ID, a 0x-prefixed hex string."
          },
          "assetId": {
            "type": "string",
            "description": "The outcome token ID, as sent."
          },
          "tickSize": {
            "type": "string",
            "description": "The tick size Polymarket reports for the market, as a decimal string; price levels can sit at finer steps than this value."
          },
          "timestamp": {
            "type": "number",
            "description": "Snapshot time, Unix milliseconds."
          }
        }
      },
      "description": "Up to 20 snapshots, oldest first."
    }
  },
  "description": "The token's order book snapshots in the window, as returned after shaping."
}