Wallet Trade History

Complete onchain trade fill history for any wallet. Every fill, every counterparty, every fee.

GET /v2/onchain/wallets/{address}/trades

Wallet trade history (onchain)

cURL

curl --request GET \
  --url https://api.polynode.dev/v2/onchain/wallets/{address}/trades

Returns every onchain trade fill for a wallet, including both maker and taker sides. This is the complete settlement record from the blockchain. Each trade is enriched with market metadata (question, slug, outcome, image).

Unlike the standard wallet trade history which relies on Polymarket’s data API (and can timeout or miss trades for heavy wallets), this endpoint pulls directly from onchain settlement data and never misses a fill.

Request

GET /v2/onchain/wallets/{address}/trades?limit=100&offset=0

Parameter	Type	Location	Description
address	string	path	Wallet address (0x-prefixed, 40 hex chars)
limit	integer	query	Max results (default 100, max 1000)
offset	integer	query	Skip first N results for pagination

Response

{
  "wallet": "0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa",
  "source": "onchain",
  "count": 1,
  "offset": 0,
  "trades": [
    {
      "tx_hash": "0x2fc63f3efc794d13c747d089d3b42bb9b4539b22216ccb2e6b2ea039ca5bb9ca",
      "timestamp": 1774749310,
      "order_hash": "0x84f21e21f5c2a1df3264694a33ec9a8a292b83e163cbda4efe63333243aa08ef",
      "maker": "0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa",
      "taker": "0x198098d9c6c1dcb843314b9da212c44396c9a1d0",
      "maker_asset_id": "0",
      "taker_asset_id": "21912724974096796009916816278814088615574660931588091764221331842149572809887",
      "maker_amount": 3.05,
      "taker_amount": 5,
      "fee": 0.319672,
      "side": "maker",
      "market": "Bitcoin Up or Down - March 28, 9:55PM-10:00PM ET",
      "slug": "btc-updown-5m-1774749300",
      "outcome": "Up",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/BTC+fullsize.png"
    }
  ]
}

Field	Type	Description
trades[].tx_hash	string	Transaction hash
trades[].timestamp	number	Unix timestamp of the fill
trades[].order_hash	string	Order hash that was filled
trades[].maker	string	Maker wallet address
trades[].taker	string	Taker wallet address
trades[].maker_asset_id	string	Asset the maker provided ("0" = USDC)
trades[].taker_asset_id	string	Asset the taker provided (CTF token ID)
trades[].maker_amount	number	Amount maker provided (USDC)
trades[].taker_amount	number	Amount taker provided (tokens)
trades[].fee	number	Fee paid on this fill (USDC)
trades[].side	string	"maker" or "taker" relative to the queried wallet
trades[].market	string	Market question
trades[].slug	string	Market slug
trades[].outcome	string	Outcome label (e.g. “Yes”, “Up”, “Trump”)
trades[].image	string	Market image URL

Example

curl "https://api.polynode.dev/v2/onchain/wallets/0x2f5653a3761f65c5a299f9839eadbd4d4d679ffa/trades?limit=10" \
  -H "x-api-key: YOUR_KEY"

Path Parameters

address · string · required

Wallet address

Query Parameters

limit · integer · default: 100

Max results (max 1000)

offset · integer · default: 0

Skip first N results

Response

200

Trade fills