CLOB Read (Public)

Get Market By Token

Polymarket-compat GET /markets-by-token/{token_id}.

Reverse-resolve a CLOB token id to its parent condition_id

the canonical outcome label.

Resolves DB-first via the JSONB-indexed markets.clob_token_ids column, then falls back to the Redis poller cache. The funded-key audit on 2026-05-07 caught a divergence: /v1/midpoint?token_id=X accepted token ids that the poller cache hadn’t seen yet, while /v1/markets-by-token/{X} 404’d them. The DB lookup closes that gap on every market the Gamma sync has hydrated (which is now all of them, post-PR #887 backfill).

GET

markets-by-token

{token_id}

Get Market By Token

curl --request GET \
  --url https://api.polysimulator.com/v1/markets-by-token/{token_id}

{
  "condition_id": "<string>",
  "primary_token_id": "<string>",
  "secondary_token_id": "<string>",
  "outcome": "<string>"
}

Path Parameters

token_id

string

required

Response

Successful Response

condition_id

string

required

primary_token_id

string | null

secondary_token_id

string | null

outcome

string | null

Post Midpoints BatchPolymarket-compat ``POST /midpoints``. Body: ``[{token_id}, {token_id}, ...]`` (PM-compat) **or** ``{items: [{token_id}, ...]}`` (legacy wrapped form). Returns ``{token_id: midpoint_string}``. Bounded to 50 tokens per request to match PM's documented cap.

Get Market By Token

curl --request GET \
  --url https://api.polysimulator.com/v1/markets-by-token/{token_id}

{
  "condition_id": "<string>",
  "primary_token_id": "<string>",
  "secondary_token_id": "<string>",
  "outcome": "<string>"
}