Get trades

Endpoint

GET /trades

Server: https://data.openfish.fun (port 3003)

Tags: Core

Provides trade history, filterable by wallet, market, or event. By default only the taker side of each trade is included.

---

Parameters

Name	In	Type	Default	Description
user	query	string		User wallet address
market	query	string		Comma-separated condition IDs
eventId	query	string		Comma-separated event IDs (mutually exclusive with market)
limit	query	integer	100	Max results (max 10000)
offset	query	integer	0	Pagination offset
takerOnly	query	boolean	true	Only include taker-side trades
side	query	string		Filter by side. One of: BUY, SELL
filterType	query	string		Trade size filter type. One of: CASH, TOKENS. Must be used with filterAmount.
filterAmount	query	number		Minimum trade size. Must be used with filterType.

---

Response

200 — A JSON array of Trade objects.

[
  {
    "proxyWallet": "0xabc...",
    "side": "BUY",
    "asset": "token123",
    "conditionId": "0xdef...",
    "size": "50.0",
    "price": "0.65",
    "timestamp": 1700000000,
    "title": "Will BTC exceed $100k?",
    "slug": "will-btc-exceed-100k",
    "icon": "https://...",
    "eventSlug": "bitcoin-milestones",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "transactionHash": "0x123...",
    "name": "Alice",
    "profileImage": "https://..."
  }
]

---

Example

curl "https://data.openfish.fun/trades?user=0xabc123...&side=BUY&limit=50"