GET

/polymarket/order-book/history

GET /polymarket/order-book/history is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Get order book history AI agents call it per request through a transparent proxy and pay $0.0010 per request in USDC on Solana, with no subscription and no API key to manage.

Price

$0.0010 / request

Method

GET

Settlement

USDC on Solana

Parameters

ParameterTypeRequiredDescription
tointegerNoEnd timestamp (Unix milliseconds, inclusive)
fromintegerNoStart timestamp (Unix milliseconds, inclusive)
limitintegerNoNumber of results (default: 20, max: 200)
max_spreadnumberNoOnly return snapshots with spread <= this value
min_spreadnumberNoOnly return snapshots with spread >= this value
market_slugstringNoMarket slug (alternative to condition_id)
position_idstringNoToken ID (required if condition_id / market_slug not set)
condition_idstringNoCondition ID — returns history for all positions in this market
min_liquiditynumberNoOnly return snapshots where total liquidity (bid + ask) >= this value
pagination_keystringNoCursor from previous response's pagination.pagination_key

Call /polymarket/order-book/history with an AI agent

Proxygate CLI
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/order-book/history -X GET
MCP / agent
// Call it from an AI agent over the Proxygate MCP server
call_api({
  listing_id: "7742c7e4-1afe-483b-bdd6-e78dfc527a0e",
  method: "GET",
  path: "/polymarket/order-book/history"
})

Polymarket API by Struct /polymarket/order-book/history: frequently asked questions

Get order book history

It costs $0.0010 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.

The agent calls GET /polymarket/order-book/history through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.

No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.