Polymarket

Polymarket Trades

Returns historical trade data from Polymarket with different filters such as trader's address and market slug.

POST/v2/semantic/retrieve/parameterized

Query Parameters

proxy_walletstring

Filter by wallet address

Example:

"ALL"

condition_idstring

Ethereum condition ID for the market

Example:

"ALL"

market_slugstring

Filter trades by specific market

Example:

"bitcoin-up-or-down-january-9-10am-et"

sidestring

Trade direction: "BUY" or "SELL"

Example:

"BUY"

start_timestring

Trades after this timestamp (inclusive)

Example:

"1767973812"

end_timestring

Trades before this timestamp (inclusive)

Example:

"1767973860"

Response Fields

Field	Type	Description
`id`	String	Unique trade identifier
`condition_id`	String	Ethereum condition ID for the market
`price`	Float	Price per share (0-1 range)
`side`	String	Trade direction: "BUY" or "SELL"
`size`	Float	Number of shares traded
`timestamp`	String (ISO 8601)	Timestamp of trade execution
`transaction_hash`	String	Ethereum transaction hash
`slug`	String	Market identifier
`outcome`	String	Trade outcome (e.g., "Yes", "No")
`proxy_wallet`	String	Trader's wallet address

Tips for Best Results

•Use Unix timestamps (as strings) for start_time and end_time filtering
•Combine market_slug and time filters for focused analysis
•Use side parameter to filter by trade direction ("BUY" or "SELL")
•Use pagination for large datasets to avoid timeouts
•Transaction hashes can be used to verify trades on-chain
•Combine multiple filters for sophisticated queries

Polymarket Trades

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 556,
  "params": {
    "proxy_wallet": "ALL",
    "condition_id": "ALL",
    "market_slug": "bitcoin-up-or-down-january-9-10am-et",
    "side": "BUY",
    "start_time": "1767973812",
    "end_time": "1767973860"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "condition_id": "ALL",
    "end_time": "1767973860",
    "market_slug": "bitcoin-up-or-down-january-9-10am-et",
    "proxy_wallet": "ALL",
    "side": "BUY",
    "start_time": "1767973812",
    "wallet_proxy": "ALL"
  },
  "pagination": {
    "limit": 10,
    "offset": 0,
    "has_more": true
  },
  "data": {
    "results": [
      {
        "condition_id": "0x584654c869a3f1868f3ad1248e11ea988f3c4e332002839c6cac0e6db94485ee",
        "id": "0x19320a9cfc47d70e2ac56c25b3555a34f402484a236267a8c220fa060eba74c7_0x1e30835026c910cd5f676a504ce8c39666917f402dfe93bb46c19adf6b152c13",
        "outcome": "Down",
        "price": 0.001,
        "proxy_wallet": "0x11514fb5ef1e3fe110691243714fcf2182db1fed",
        "side": "BUY",
        "size": 225.23,
        "slug": "bitcoin-up-or-down-january-9-10am-et",
        "timestamp": "2026-01-09T15:51:00Z",
        "transaction_hash": "0x19320a9cfc47d70e2ac56c25b3555a34f402484a236267a8c220fa060eba74c7"
      },
      {
        "condition_id": "0x584654c869a3f1868f3ad1248e11ea988f3c4e332002839c6cac0e6db94485ee",
        "id": "0x19320a9cfc47d70e2ac56c25b3555a34f402484a236267a8c220fa060eba74c7_0xb07225fa95a2b5dd0f15b3f41f07657d9eb9e928268d4e5ae9fdf7e178049ac7",
        "outcome": "Down",
        "price": 0.001,
        "proxy_wallet": "0x11514fb5ef1e3fe110691243714fcf2182db1fed",
        "side": "BUY",
        "size": 14.99,
        "slug": "bitcoin-up-or-down-january-9-10am-et",
        "timestamp": "2026-01-09T15:51:00Z",
        "transaction_hash": "0x19320a9cfc47d70e2ac56c25b3555a34f402484a236267a8c220fa060eba74c7"
      }
    ]
  }
}