/orders_stats

post

Aggregated order statistics over a given timeframe. The time is inclusive of start_time and exclusive of end_time, and is capped at a maximum window of 1 day by default. Repeatedly calling with a high limit may cause rate limiting.

Authorizations

Path parameters

chainstring · enumRequired

Chain to query for

Example: ethPossible values:

Query parameters

api_keystringRequiredExample: docs-demo

Body

end_timestring · date-timeRequired

include_unminedbooleanOptional

If true, all orders are returned. If false, only mined orders are returned.

limitinteger · nullableOptional

Maximum number of orders to aggregate.

Default: 10000

offsetintegerOptional

start_timestring · date-timeRequired

Responses

200Success

application/json

block_0_inclusion_ratenumber · doubleRequired

Percentage of eligible txs that were included on the same block as they arrived

block_1_inclusion_ratenumber · doubleRequired

Percentage of eligible txs that were included on the next block after they arrived

included_ordersinteger · int64Required

Total number of mined orders

inclusion_ratenumber · doubleRequired

Ratio of included orders / total orders

mev_refundsnumber · doubleRequired

Captured MEV generated by these orders

priority_fee_refundsnumber · doubleRequired

Total refunded priority fees

priority_fees_paidnumber · doubleRequired

Total fees paid (priority fees + block fee recipient payments) for orders that generated a priority fee based refund

total_ordersinteger · int64Required

Total number of received orders

total_refunds_receivednumber · doubleRequired

Equal to mev_refunds + priority_fee_refunds

post/v1/{chain}/order_stats

POST /v1/{chain}/order_stats?api_key=text HTTP/1.1
Host: api.novarpc.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_orders": 1440000,
  "included_orders": 1379563,
  "inclusion_rate": 0.958029861,
  "block_0_inclusion_rate": 0.915610417,
  "block_1_inclusion_rate": 0.032418952618453865,
  "total_refunds_received": "525600000",
  "mev_refunds": 59077440,
  "priority_fee_refunds": 466522560,
  "priority_fees_paid": 480951092
}