What is Bitquery Polymarket API?

Use the service to investigate who traded, which outcome tokens a wallet holds, how volume changed and when markets resolved. Recorded trade prices describe completed on-chain activity; they are not resting CLOB orders or executable book depth.

Start with a narrow IDE query before scaling to subscriptions or bulk ingestion. Points, stream-minutes, transfer, licensing and archive coverage are separate dimensions. Kafka, gRPC and cloud delivery have their own eligibility and volume requirements.

Who it is for

Wallet and market analytics developers.
Researchers joining Polymarket and Polygon transactions.
Teams ingesting continuous event streams.

Features and coverage

Decoded trades
Filter outcome-token trades by market, wallet or protocol.
Trade prices
Read prices attached to on-chain trades.
Token balances
Study wallet exposure through balance updates.
Market lifecycle
Track condition creation, resolution, payouts and redemptions.
Aggregated volume
Group trades and rank markets by activity.
Delivery formats
GraphQL queries and WebSocket subscriptions, plus Kafka, gRPC and cloud delivery for eligible plans.

Workflows with Bitquery Polymarket API

Monitor a wallet

Filter trades to one wallet, subscribe to new rows and join balance updates for exposure.

Trace settlement

Join condition, payout and redemption events and retain transaction IDs.

Plan a historical load

Specify chain, data family, period and format before selecting archive and compute allowances.

Pricing and total cost

Annual plans list Personal at US$29/month equivalent, Pro at US$69 and Scale at US$199, billed yearly. Points, stream-minutes and data transfer are metered; full archive history is separate.

Personal — annual billing

US$29/month equivalent (US$348/year)

100,000 API points/month.
Personal use; no streaming.

Pro — annual billing

US$69/month equivalent (US$828/year)

1 million API points/month.
100,000 stream-minutes and 5 GB.
Commercial use.

Scale — annual billing

US$199/month equivalent (US$2,388/year)

5 million API points/month.
2 million stream-minutes and 50 GB.
Commercial use.

Fees and usage costs

Monthly billing differs from annual commitments.
Archive add-ons are per chain and data family, starting at US$100/month or US$70/month equivalent billed yearly. Polymarket history needs the relevant chain/product quote.

Trial: 7-day live-data trial without a card; archive history is excluded.

Getting started

Before you start: Trade prices do not replace a resting-book feed.

Create a Bitquery account and API token.
Open a Polymarket example in the IDE and narrow its filters.
Choose queries or subscriptions and check points, streaming and archive allowances.

On-chain trades describe completed activity, not resting CLOB liquidity.

Read DEX trade documentation

Useful links

What to check

Trade prices do not replace a resting-book feed.
Personal licensing excludes commercial use.
Entry plans do not include the full historical archive.
GraphQL, Kafka, gRPC and bulk delivery have different plan and volume requirements.

A closer look

Ratings & reviews

Editorial rating

4.0/ 5

0 user reviews

PredictionToolkit editorial

Our take on Bitquery Polymarket API

Detailed queries and streams suit data-heavy integrations. Licensing, archive coverage and multiple usage units require careful planning; this is not a resting-book feed.

Based on documented features, setup and access terms. How we rate