/refunds

post

Get refunds for your account. Filter by time range, block range, and payout status. Supports pagination with limit and offset.

Authorizations

ApiKeyQueryBearerAuth

Path parameters

chainstring · enumRequired

Chain to query for

Example: ethPossible values:

Body

application/json

end_blockinteger · nullableOptional

end_timestring · nullableOptional

limitintegerOptionalDefault: 100000

offsetintegerOptional

payout_statusstring · nullableOptional

start_blockinteger · nullableOptional

start_timestring · nullableOptional

Responses

200Success

application/json

post

/v1/{chain}/refunds

HTTPcURLJavaScriptPython

POST /v1/{chain}/refunds HTTP/1.1
Host: api.ofa.titanbuilder.xyz
Content-Type: application/json
Accept: */*
Content-Length: 95

{
  "start_time": "2025-11-25T00:00:00Z",
  "end_time": "2025-11-26T00:00:00Z",
  "limit": 1000,
  "offset": 0
}

200Success

{
  "refunds": [
    {
      "order_hash": "0xc5039a7241d18baa14c04f239ed998371a12e2760d42fb871de28ba5e4f95b92",
      "block_number": 24120019,
      "refunded_amount": "1350000000000000",
      "payout_status": "Pending",
      "payout_tx_hash": null,
      "paid_at": null,
      "is_mev_refund": false,
      "refund_tx_hash": "0xe816e9e88910c670e7cc7378aec77e211f110eed0523ab913c1d7b99910656e1"
    }
  ],
  "count": 1
}