ONondoperps
Builder Code

Get Recent Builder Code Fills

Changed on

Returns the most recent fills attributed to the builder code owned by the authenticated account, newest first, across every account that traded with that code. The exchange retains at most 200 fills per builder code.

Use this endpoint to resynchronize after a builderFills WebSocket disconnect: reconnect, subscribe, then call this endpoint and de-duplicate by fillId. It is a short recovery window, not a fill history. For totals over an arbitrary period, use the builder-code statistics endpoint instead.

The retained window is rebuilt when the exchange restarts, so a response can contain fewer than 200 fills shortly afterwards.

get/v1/builder_code/fills

Request

  • Base URL
    https://api.ondoperps.xyz
  • URL
    https://api.ondoperps.xyz/v1/builder_code/fills
  • Auth
    • HTTP bearer
    • or API key in header ONDO-KEY-ID

Response

Recent fills attributed to the caller's builder code, newest first

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": [
    {
      "builderCodeFee": "0.2275",
      "fillId": "70a37d8f972f2494837f9dba8364cbb4",
      "orderId": "a4c2e9f17b3d4e8c9f0a1b2c3d4e5f60",
      "clientOrderId": "my-order-123",
      "market": "AAPL-USD.P",
      "price": "227.50",
      "size": "5.00",
      "side": "buy",
      "time": "2026-09-28T14:32:07.123456Z"
    }
  ]
}

Changes