Super Octopus logoSuper Octopus Docs

Get Trades For A User Or Markets

Returns cached trade fills with filters for user, market, pagination, side selection, taker flags, and notional thresholds

GET
/trades

Query Parameters

limit?integer

Maximum rows to return (max 10,000).

offset?integer

Cursor offset for pagination.

takerOnly?boolean

Limit results to taker fills (default true).

filterType?string

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

filterAmount?number

Threshold used alongside filterType.

market?array<>

Comma-separated list of condition IDs.

user?string

Wallet address to scope results to.

side?string

Limit to BUY or SELL fills.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/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.domain.com/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.domain.com/users/macro-whale.png",
    "profileImageOptimized": "https://cdn.domain.com/users/macro-whale@2x.jpg",
    "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.domain.com/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.domain.com/users/civic-fund.png",
    "profileImageOptimized": "https://cdn.domain.com/users/civic-fund@2x.jpg",
    "transactionHash": "0x4ce08d5e23b884ddaf8b4691cfd04e6c4f80c378a9cfd76f4043f8197a9482cd"
  }
]
{
  "error": "unknown_field: takerOnly"
}
{
  "error": "unauthorized: ip_not_allowlisted"
}
{
  "error": "internal_error: unexpected database failure"
}