0.85¢ per request

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.

One TaskFuel account and prepaid balance. Your agent shows the price before it pays.

Works with

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.
OptionPrice & billingChoose it forGood to knowAccess
Predexon via BlockRunThrough TaskFuel$0.0085 / requestPer request from your TaskFuel balanceFive 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 directOwn API keyProvider referenceFree trade endpointDocumented as free and unlimited on every planDirect API authentication required.A direct route for repeated trade-history queries.Separate credentials; this test used the TaskFuel route.Direct
Polymarket price historyDirect CLOB APIProvider referenceSee exchange documentationDirect access under Polymarket’s API termsGET /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

Polymarket historical data: what your agent gets.

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

  • 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.

    $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.

    $0.0085 / next page

Closed basketball market history, tested.

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.

TaskFuel test run ·

Charged $0.0085

Your agent asked

Read historical trades for Kings vs. Mavericks: first-quarter total 51.5 points
Data from
Predexon via BlockRun

What came back

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

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

Try the API request Quote first, then run

1. Check the price

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code. 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.

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

Setup and API reference · Job polling and timeout recovery

Try it in your next task.

Sign in to TaskFuel and copy the connection prompt into your agent. Approve the connection, then ask for the work you need.

01

Name the task

Tell your agent what the output needs to contain.

02

See the price

Your agent shows the provider and price before spending.

03

Review the response

Check the output against your task. The call reports its cost and remaining balance.

When to use it.

Historical research

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.

CSV preparation

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.

Choosing the dataset

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.

Good 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.

Your agent can do things it couldn’t this morning.

$1 in free credit, no card required.

Start for Free