Skip to main content
GET
/
data
/
trades
List trades for the authenticated account
curl --request GET \
  --url https://clob.kuest.com/data/trades
{
  "data": [
    {
      "id": "<string>",
      "taker_order_id": "<string>",
      "market": "<string>",
      "asset_id": "<string>",
      "side": "<string>",
      "size": "<string>",
      "fee_rate_bps": "<string>",
      "price": "<string>",
      "status": "<string>",
      "match_time": "2023-11-07T05:31:56Z",
      "last_update": "2023-11-07T05:31:56Z",
      "maker_address": "<string>",
      "owner": "<string>",
      "bucket_index": 123,
      "maker_orders": [
        {
          "order_id": "<string>",
          "maker_address": "<string>",
          "owner": "<string>",
          "matched_amount": "<string>",
          "fee_rate_bps": "<string>",
          "price": "<string>",
          "asset_id": "<string>",
          "outcome": "<string>",
          "side": "<string>"
        }
      ],
      "type": "TAKER",
      "outcome": "<string>",
      "transaction_hash": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "limit": 123,
  "count": 123
}
Fetch trades where your authenticated account participated as the taker or as one of the matched makers.
Provide the L2 headers (KUEST_ADDRESS, KUEST_SIGNATURE, KUEST_TIMESTAMP, KUEST_API_KEY, KUEST_PASSPHRASE). The endpoint only returns fills linked to that credential set.

​
Query parameters

ParameterTypeRequiredDescription
idstringNoTrade ULID (case-insensitive). Returns at most one entry.
takerstringNoFilter by taker wallet address.
makerstringNoFilter by maker wallet address.
marketstringNoConditionID (market identifier).
beforestringNoUnix timestamp (seconds); include trades strictly before this instant.
afterstringNoUnix timestamp (seconds); include trades strictly after this instant.
next_cursorstringNoBase64-encoded offset for pagination (MA== to start, LTE= when exhausted).
Filters can be combined. Omitted parameters are ignored, and empty strings are treated as if the filter were not supplied.

​
Response fields

The endpoint returns a paginated object with data, next_cursor, limit, and count. Each entry inside data contains:
FieldTypeDescription
idstringTrade ULID.
taker_order_idstringULID for the market order that initiated the trade.
marketstringCondition (market) ULID.
asset_idstringToken ID tied to the taker order.
sidestringbuy or sell, from the taker’s perspective.
sizestringExecuted quantity (decimal string).
fee_rate_bpsstringTaker fee rate in basis points.
pricestringExecuted price (decimal string between 0 and 1).
statusstringCurrently always CONFIRMED.
match_timestringISO-8601 timestamp for when the trade matched.
last_updatestringISO-8601 timestamp of the latest status update (same as match_time for now).
outcomestringPlaceholder outcome label; currently empty.
maker_addressstringWallet that funded the taker order.
ownerstringAPI key owner for the taker order (falls back to the taker wallet).
transaction_hashstring|nullNot populated yet; reserved for on-chain settlement hashes.
bucket_indexintegerAlways 0 until bucketed settlements are exposed.
maker_ordersarrayMaker orders that filled the trade.
typestringTAKER if your account submitted the market order, otherwise MAKER.

​
maker_orders entries

FieldTypeDescription
order_idstringMaker order ULID.
maker_addressstringMaker wallet address.
ownerstringAPI key owner for the maker order (falls back to the maker wallet).
matched_amountstringQuantity filled from the maker order (decimal string).
fee_rate_bpsstringMaker fee rate in basis points.
pricestringMaker order price.
asset_idstringToken ID associated with the maker order.
outcomestringPlaceholder outcome label; currently empty.
sidestringMaker order side (buy or sell).

​
Known gaps

  • status is fixed to CONFIRMED until lifecycle updates propagate through the API.
  • transaction_hash, bucket_index, and outcome are placeholder fields for future on-chain and bucketed settlement support.
  • Each trade currently exposes a single maker fill; multi-fill buckets will surface once the API publishes them.

Query Parameters

​
id
string

Filter by trade identifier.

​
taker
string

Return trades where the taker address matches this value.

​
maker
string

Return trades where the counterparty maker address matches this value.

​
market
string

Filter by condition (market) identifier.

​
before
string

Unix timestamp; include trades strictly before this instant.

​
after
string

Unix timestamp; include trades strictly after this instant.

​
next_cursor
string

Base64-encoded offset for pagination. Use MA== to start; LTE= means no more pages.

Response

Trades matching the supplied filters.

​
data
object[]
required
​
next_cursor
string
required
​
limit
integer
required

Page size used for the query.

​
count
integer
required

Number of items returned in this page.