/refunds_stats

post

Get aggregated refund statistics for your account. Returns totals and counts broken down by payout status and refund type.

Authorizations

ApiKeyQueryBearerAuth

Path parameters

chainstring · enumRequired

Chain to query for

Example: ethPossible values:

Body

application/json

end_blockinteger · nullableOptional

end_timestring · nullableOptional

start_blockinteger · nullableOptional

start_timestring · nullableOptional

Responses

200Success

application/json

post

/v1/{chain}/refunds_stats

HTTPcURLJavaScriptPython

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

{
  "start_time": "2025-11-25T00:00:00Z",
  "end_time": "2025-11-26T00:00:00Z"
}

200Success

{
  "total_refund_amount": "525600000000000000",
  "pending_refund_amount": "125600000000000000",
  "paid_amount": "400000000000000000",
  "mev_refund_amount": "59077440000000000",
  "priority_fee_refund_amount": "466522560000000000",
  "total_refund_count": 1440,
  "pending_count": 340,
  "paid_count": 1100
}