InsightSocial
GET /v1/polymarket/booksbeta

Polymarket Books API

Get the order books of up to 150 Polymarket outcome tokens in one request.

20–1,880 credits, metered · single call · failed calls free

curl "https://api.insightsocial.app/v1/polymarket/books?token_ids=<token_ids>" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "polymarket",
"endpoint": "/v1/polymarket/books",
"schema_version": "2",
"data": {
"<field>": "<value>"
},
"unavailable": [],
"credits_used": "<integer>"
}

Parameters

Query parameters for GET /v1/polymarket/books. Send your key in the x-api-key header.

NameRequiredDescription
token_idsYesOutcome token ids, 1–150. Separate ids with commas. Token ids are the tokenId of a market outcome.
depthNoPrice levels returned per side, 1–200. Default: 20. Levels run from the best price outward.

Response

This endpoint is beta: data holds the platform's own fields under our naming rules (snake_case keys, string ids, ISO times where the platform gives a timestamp) rather than a unified post or profile, and those fields may change.

Every field, error and example is in the Polymarket Books API reference.

How much does the Polymarket Books API cost?

Metered: 20–1,880 credits a call. The ceiling is reserved when the call starts and you are charged what it actually read.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

Polymarket Books API: frequently asked questions

Send GET /v1/polymarket/books with the token_ids parameter and your key in the x-api-key header. Get the order books of up to 150 Polymarket outcome tokens in one request.