Trade History (Market) — Bulk

Market trade history — bulk export

curl --request GET \
  --url https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all

const options = {method: 'GET'};

fetch('https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

onchain

markets

{token_id}

trades

all

Market trade history — bulk export

curl --request GET \
  --url https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all

const options = {method: 'GET'};

fetch('https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v2/onchain/markets/{token_id}/trades/all")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Growth plan or above only. This endpoint returns the entire trade history for a market token in one response — no client-side pagination, no offset bookkeeping. Because a single call can return tens of thousands of fills (and tens of MB of JSON), it’s gated to the Growth plan and above. Starter and free tier requests receive 403.

Hard cap: 250,000 trades per call — beyond that, response includes "partial": true with "partial_reason": "hard_cap_250000"
Wall-clock budget: 180 seconds — first cold-cache call on a busy market may take 1-3 minutes
Cache: full results cached 5 minutes. Repeat calls return in under 1 second
Typical payload: 1-50 MB. Worst case (capped): 100-200 MB JSON

Returns every onchain trade fill for one market token in a single response. The server walks the full trade history with parallel time-bucketed queries server-side — you don’t need to paginate. Each trade is enriched with market metadata. This is the right endpoint when you want bulk-export a market for analysis, indexing, or backtesting. For interactive UIs that just need the most recent N fills, use the standard Market Trade History instead.

Request

GET /v2/onchain/markets/{token_id}/trades/all?from=<unix>&to=<unix>

Parameter	Type	Location	Description
`token_id`	string	path	CTF token ID (numeric string)
`from`	integer	query	Optional start of window in unix seconds. Default: 2024-01-01 (covers all Polymarket history)
`to`	integer	query	Optional end of window in unix seconds. Default: now

Response

{
  "token_id": "21743669032210695168079601505378236205866986767926346409604806906483294819314",
  "from_ts": 1774588800,
  "to_ts": 1775817600,
  "count": 27601,
  "partial": false,
  "partial_reason": null,
  "fetched_in_ms": 5437,
  "cache": "miss",
  "trades": [
    {
      "tx_hash": "0xa73ccafda4acf5473d65ce9b6ed9f9e41861ea2ae0b5c0a8bb5cfd3869583fdf",
      "order_hash": "0x3e5baca0ae04010bfe01ec0a0a3fe8b6e291ca8373bb4803f31620754f83a17d",
      "timestamp": 1775817557,
      "maker": "0x4ef7e2e97735a144c35c04bf22bcac184d3221be",
      "taker": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
      "token_id": "21743669032210695168079601505378236205866986767926346409604806906483294819314",
      "direction": "SELL",
      "price": 0.545,
      "shares": 1827.47,
      "usd": 995.99,
      "fee": 0
    }
  ]
}

Response fields

Field	Type	Description
`token_id`	string	The CTF token ID requested
`from_ts` / `to_ts`	integer	Resolved time window in unix seconds
`count`	integer	Total trades returned (≤ 250,000)
`partial`	boolean	`true` if either the 250K hard cap or the 180s wall-clock budget was hit before the full window was walked
`partial_reason`	string \| null	`"hard_cap_250000"` or `"wall_clock_180s"` when partial; otherwise `null`
`fetched_in_ms`	integer	Server-side fetch time. Cached calls show the original miss time
`cache`	string	`"hit"` if served from Redis cache, `"miss"` if freshly walked
`trades`	array	All trades, sorted by `timestamp` descending (newest first)

Trade fields

Field	Type	Description
`tx_hash`	string	Polygon transaction hash
`order_hash`	string	Order hash from the exchange
`timestamp`	integer	Unix seconds when the fill settled
`maker`	string	Maker address
`taker`	string	Taker address
`token_id`	string	The outcome token id (echoes the request param)
`direction`	string	`"BUY"` or `"SELL"` from the maker’s perspective
`price`	number	USDC per share, 4-decimal precision
`shares`	number	Outcome tokens traded
`usd`	number	USDC notional
`fee`	number	Maker fee paid (USDC)

Example: full lifetime of a market

curl "https://api.polynode.dev/v2/onchain/markets/21743669032210695168079601505378236205866986767926346409604806906483294819314/trades/all?key=$YOUR_KEY"

Example: window inside a longer-running market

curl "https://api.polynode.dev/v2/onchain/markets/$TOKEN/trades/all?from=1774588800&to=1775817600&key=$YOUR_KEY"

Errors

403 Tier required:

{ "error": "/trades/all requires the Growth plan or above. Your tier: starter. See polynode.dev/pricing." }

401 No API key:

{ "error": "API key required. Pass via ?key= or x-api-key header." }

Notes

For a multi-token market (binary YES/NO), call this endpoint twice — once per token_id. A condition_id variant that returns both tokens in one call is on the roadmap.
partial: true results are not cached. Subsequent calls re-attempt the full walk. Tighten the time window with from/to if you keep hitting the cap.
Cache key is (token_id, from_ts, to_ts). Different windows are cached independently. Default-window calls (no from/to) share a cache slot.
The walk is parallelized — total bandwidth use is moderate even for huge markets.

Path Parameters

token_id

string

required

CTF token ID

Query Parameters

from

integer

Optional unix timestamp lower bound

integer

Optional unix timestamp upper bound

Response

Full trade history

​Request

​Response

​Response fields

​Trade fields

​Example: full lifetime of a market

​Example: window inside a longer-running market

​Errors

​Notes

Path Parameters

Query Parameters

Response

Request

Response

Response fields

Trade fields

Example: full lifetime of a market

Example: window inside a longer-running market

Errors

Notes