Skip to main content
GET
/
builder
/
trades
List builder trades
curl --request GET \
  --url https://clob.kuest.com/builder/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>"
  }
]
Return trades attributed to the builder key.
Builder requests should include headers generated by the builder signing SDK.
If next_cursor is supplied, the response is paginated with { data, next_cursor }.

Query Parameters

​
id
string

Filter by trade identifier.

​
maker_address
string

Return trades matching this maker address.

​
market
string

Filter by condition (market) identifier.

​
asset_id
string

Filter by token 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