Skip to main content
GET
/
data
/
trades
List trades for the authenticated account
curl --request GET \
  --url https://clob.kuest.com/data/trades
[
  {
    "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>"
  }
]
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.
Filters can be combined. Omitted parameters are ignored, and empty strings are treated as if the filter were not supplied.

​
Response fields

Each element in the returned array 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.

​
id
string
required
​
taker_order_id
string
required
​
market
string
required
​
asset_id
string
required
​
side
string
required

Side of the taker order (buy or sell).

​
size
string
required

Quantity executed, represented as decimal shares.

​
fee_rate_bps
string
required
​
price
string
required

Executed price between 0 and 1.

​
status
string
required
​
match_time
string<date-time>
required
​
last_update
string<date-time>
required
​
maker_address
string
required

Wallet address that funded the taker order.

​
owner
string
required

Identifier of the taker account.

​
bucket_index
integer<int32>
required
​
maker_orders
object[]
required
​
type
enum<string>
required

Perspective of the authenticated account.

Available options:
TAKER,
MAKER
​
outcome
string

Optional, human-readable outcome label.

​
transaction_hash
string | null