Skip to main content
GET
/
trades
Get trade history
curl --request GET \
  --url https://data-api.forka.st/trades
[
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "side": "BUY",
    "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "size": 420.5,
    "price": 0.46,
    "timestamp": 1718121600,
    "usdcSize": 193.43,
    "title": "Will the Fed cut rates in September?",
    "slug": "fed-rate-cut-sep-2024",
    "icon": "https://cdn.forka.st/markets/fed.png",
    "eventSlug": "fomc-2024-policy",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "name": "Macro Whale",
    "pseudonym": "macro.whale",
    "bio": "Macro strategist backing major economic events.",
    "profileImage": "https://cdn.forka.st/users/macro-whale.png",
    "profileImageOptimized": "https://cdn.forka.st/users/[email protected]",
    "transactionHash": "0xa8b1be184ad6b5a219d121935e7b4f6a1cb5df38e7b74d2880aed672541da831"
  },
  {
    "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
    "side": "SELL",
    "asset": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5:1",
    "conditionId": "0x8eee3789813eead2d47db3bdf6a1c5021f564ef18e2aefc8b80b9dcd5d6f8ac5",
    "size": 280.75,
    "price": 0.51,
    "timestamp": 1717660800,
    "usdcSize": 143.18,
    "title": "Will turnout exceed 60% in the French election?",
    "slug": "france-turnout-60",
    "icon": "https://cdn.forka.st/markets/france-election.png",
    "eventSlug": "french-presidential-2024",
    "outcome": "No",
    "outcomeIndex": 1,
    "name": "Civic Data Fund",
    "pseudonym": "civic.fund",
    "bio": "Collective focused on political prediction markets.",
    "profileImage": "https://cdn.forka.st/users/civic-fund.png",
    "profileImageOptimized": "https://cdn.forka.st/users/[email protected]",
    "transactionHash": "0x4ce08d5e23b884ddaf8b4691cfd04e6c4f80c378a9cfd76f4043f8197a9482cd"
  }
]
https://data-api.forka.st/trades surfaces every fill captured by the Forkast orderbook subgraph. You can query by wallet or by a batch of markets.

​
Parameters worth noting

  • limit/offset support up to 10,000 rows for heavy exports.
  • takerOnly=true (default) filters out maker fills; set it to false for a complete view.
  • Pair filterType=CASH|TOKENS with filterAmount to return only trades larger than a given notional amount.
  • side lets you focus on buys or sells when looking at a specific wallet.
The market parameter accepts CSV lists and cannot be combined with other future scoping filters.

Query Parameters

​
limit
integer
default:100

Maximum rows to return (max 10,000).

Required range: 0 <= x <= 10000
​
offset
integer
default:0

Cursor offset for pagination.

Required range: 0 <= x <= 10000
​
takerOnly
boolean
default:true

Limit results to taker fills (default true).

​
filterType
enum<string>

Apply a cash or token threshold filter (requires filterAmount).

Available options:
CASH,
TOKENS
​
filterAmount
number

Threshold used alongside filterType.

Required range: x >= 0
​
market
string[]

Comma-separated list of condition IDs.

0x-prefixed 64-character hex string.

​
user
string

Wallet address to scope results to.

​
side
enum<string>

Limit to BUY or SELL fills.

Available options:
BUY,
SELL

Response

Trade rows returned.

​
proxyWallet
string

0x-prefixed EVM address (40 hex chars).

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
side
enum<string>
Available options:
BUY,
SELL
​
asset
string
​
conditionId
string

0x-prefixed 64-character hex string.

Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

​
size
number
​
price
number
​
timestamp
integer<int64>
​
transactionHash
string
​
usdcSize
number
​
title
string
​
slug
string
​
icon
string
​
eventSlug
string
​
outcome
string
​
outcomeIndex
integer
​
name
string | null
​
pseudonym
string | null
​
bio
string | null
​
profileImage
string | null
​
profileImageOptimized
string | null