# Polymarket historical data

Read a market’s past trades with their units.

Get dated Polymarket trade records for a market slug. Our example reads a closed basketball market and shows outcome labels, prices, normalized shares and the next page.

Ten records from one closed basketball market. A transaction can contain multiple records, so the record count is not a count of unique transactions.

Provider in the worked example: Predexon via BlockRun.

Price shown for this route: 0.85¢ per request.

## Choose trade records or a price series.

The worked example reads trades. A chart-ready price series is a separate dataset.

Access and tested prices checked on 11 November 2026.

| Option | Price and billing | Strength | Good to know | Access |
| --- | --- | --- | --- | --- |
| Predexon via BlockRun (Through TaskFuel) | $0.0085 / request. Per request from your TaskFuel balance. Five records requested per page in this test. | Market and time filters with inspected, normalized trade records. | Two pages from one market; complete coverage was not tested. | TaskFuel |
| Predexon direct (Own API key) | Free trade endpoint. Documented as free and unlimited on every plan. Direct API authentication required. | A direct route for repeated trade-history queries. | Separate credentials; this test used the TaskFuel route. | Direct |
| Polymarket price history (Direct CLOB API) | See exchange documentation. Direct access under Polymarket’s API terms. GET /prices-history selects an asset ID and time range. | Timestamp/price points with a fidelity setting in minutes. | A price series rather than individual trade records; this route was not executed. | Direct |

- [Predexon via BlockRun: provider reference](https://blockrun.ai/docs/api-reference/prediction-markets). Checked 2026-11-11.
- [Predexon direct: provider reference](https://docs.predexon.com/api-reference/trading/trades). Checked 2026-11-11.
- [Polymarket price history: provider reference](https://docs.polymarket.com/api-reference/markets/get-prices-history). Checked 2026-11-11.


## What it can do

### Read a market’s trade history

A market slug and date range select the records. The response includes outcome, token ID, timestamp, side, price, normalized shares and trade amount.

Price: $0.0085 / request.

### Continue the same date window

A pagination key retrieves the next page with the same filters. The provider documents up to 500 rows per page; this test used five.

Price: $0.0085 / next page.


## A real example

Tested on 2026-11-11 through Predexon via BlockRun.

Both five-record pages matched the requested market and date range. The first record was a buy of the Under outcome: 3.7 normalized shares at $0.10, with a $0.37 trade amount.

Your agent asked: Read historical trades for Kings vs. Mavericks: first-quarter total 51.5 points

Returned in this test:

- Market: Kings vs. Mavericks: 1Q O/U 51.5
- First record: Under; BUY; 3.7 shares × $0.10 = $0.37
- Trade time: 3 November 2026 at 01:10:58 UTC
- Raw versus normalized: 3,700,000 raw units; 3.7 normalized shares
- Pagination test: 10 distinct records across two pages
- Provider contract: [Predexon Polymarket trades documentation](https://docs.predexon.com/api-reference/trading/trades)

Charged in this test: $0.0085.

The receipt is for page one. Page two cost another $0.0085. This sample does not establish complete historical coverage.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. Exact first-page request. start_time=1793577600 and end_time=1793750400 mean 2 November and 4 November 2026 at 00:00 UTC. The market_slug identifies the market; token_id identifies an outcome.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://blockrun.ai/api/v1/pm/polymarket/trades?market_slug=nba-sac-dal-2026-11-02-1q-total-51pt5&start_time=1793577600&end_time=1793750400&limit=5",
  "method": "GET",
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read trades[].timestamp, market_slug, condition_id, token_id, outcome_label, side, price, shares_normalized and amount_usd. In this response, raw shares use 1,000,000 units per share. The first record has 3.7 normalized shares × $0.10 = $0.37; fee_usd is separate. One transaction hash can appear on multiple outcome records. URL-encode pagination.pagination_key and resend it as pagination_key with the same filters to request another paid page. Both tested pages reported has_more=true.

[Read the Polymarket trade response contract](https://docs.predexon.com/api-reference/trading/trades)

[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Read the outcome behind a price.

Your agent keeps the outcome label and token ID with each historical price, so Over and Under remain separate series.

### Export normalized trade rows.

An agent can write timestamp, market, outcome, price, normalized shares and trade amount to CSV from the returned JSON. The example supplies two inspected pages.

### Choose trades or a price series.

A trade feed contains execution records. Polymarket’s direct price-history endpoint returns timestamp/price points for an asset ID. They serve different analyses.




## Questions

### How do I get Polymarket historical data?

Select the market slug or another supported market identifier, set a UTC range and read the paginated trade response. This example uses the Predexon trade feed through BlockRun and TaskFuel.

### Is this historical price data or trade data?

This example returns trades, including price, outcome, shares and timestamp. Polymarket’s separate CLOB price-history API returns a price series for an asset ID; its market parameter is not the human-readable slug.

### Does this provide a full Polymarket dataset?

The test covers ten records from one closed market. The provider still reported more results. Earliest coverage, missing records and complete archive exports were not tested.

### Why do raw shares look too large?

The tested response has both shares and shares_normalized. Its first record contains 3,700,000 raw units and 3.7 normalized shares. Multiplying 3.7 by the $0.10 price matches the $0.37 amount_usd.

### Can I use a direct provider instead?

Yes. Predexon documents its direct trade endpoint as free and unlimited on every plan, with API-key authentication. Polymarket’s own price-history endpoint is another option when a timestamp/price series is the desired output.

### What did the historical-data requests cost?

Each five-record request cost $0.0085 on 11 November 2026. Two tested pages cost $0.017 total. Your agent shows the price for your own request before it pays.

## Related tool guides

- [Connect Polymarket research through MCP](https://taskfuel.ai/tools/polymarket-mcp/)
- [Read Kalshi historical data](https://taskfuel.ai/tools/kalshi-historical-data/)
- [Search current prediction market odds](https://taskfuel.ai/tools/prediction-market-api/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/polymarket-historical-data/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
