GET /builder/stats

Return aggregate fill statistics for the authenticated builder. Send either period=24h|7d|30d|90d or a custom start_time/end_time range up to 180 days.

GET https://api.aevo.xyz/builder/stats

Authentication required. Include your AEVO-KEY and AEVO-SECRET headers. See Authentication.

Query Parameters

Field	Type	Required	Description
period	string	No	Builder analytics period. Use this or start_time and end_time, not both. Example: 24h
start_time	integer	No	Window start, Unix nanoseconds. Use with end_time, or use period. Example: 1672531200000000000
end_time	integer	No	Window end, Unix nanoseconds. Defaults to now. Example: 1675036800000000000

Example Request

curl --request GET \
     --url https://api.aevo.xyz/builder/stats \
     --header 'accept: application/json' \
     --header 'AEVO-KEY: <your-api-key>' \
     --header 'AEVO-SECRET: <your-api-secret>'

Responses

200 — Builder fill statistics.

Field	Type	Required	Description
builder_id	string	Yes	Builder ID. Example: builder_0123456789abcdef
name	string	Yes	Builder display name. Example: Example Builder
fee_account	string	Yes	Builder fee account. Example: 0xBuilderFeeAccountAddress
status	string	Yes	Builder status.
period	string	Yes	Builder analytics period. Use this or start_time and end_time, not both.
start_time	integer	Yes	Window start, Unix nanoseconds. Use with end_time, or use period. Example: 1672531200000000000
end_time	integer	Yes	Window end, Unix nanoseconds. Defaults to now. Example: 1675036800000000000
volume	string	Yes	Volume in USDC terms. Example: 12.23
fees	string	Yes	Builder fees in USDC. Example: 12.23
unique_traders	integer	Yes	Number of unique trader accounts. Example: 10
fills	integer	Yes	Number of builder fills. Example: 12
active_traders	integer	Yes	Number of trader accounts with at least one attributed fill in the window. Example: 10
new_traders	integer	Yes	Number of active trader accounts whose first-ever attributed fill for this builder is inside the window. Example: 3
returning_traders	integer	Yes	Active traders minus new traders. Example: 7
maker_volume	string	Yes	Attributed USDC volume where the builder-attributed order was maker-side. Example: 100
taker_volume	string	Yes	Attributed USDC volume where the builder-attributed order was taker-side. Example: 250
previous	object	No
markets	array[object]	No
series	array[object]	No

previous items:

Field	Type	Required	Description
volume	string	Yes	Volume in USDC terms. Example: 12.23
fees	string	Yes	Builder fees in USDC. Example: 12.23
unique_traders	integer	Yes	Number of unique trader accounts. Example: 10
fills	integer	Yes	Number of builder fills. Example: 12

markets items:

Field	Type	Required	Description
instrument	string	Yes	Instrument name. Example: ETH-PERP
volume	string	Yes	Volume in USDC terms. Example: 12.23
fees	string	Yes	Builder fees in USDC. Example: 12.23
fills	integer	Yes	Number of builder fills. Example: 12

series items:

Field	Type	Required	Description
timestamp	string	Yes	Timestamp in UNIX in nanoseconds. Example: 1680249600000000000
volume	string	Yes	Volume in USDC terms. Example: 12.23
fees	string	Yes	Builder fees in USDC. Example: 12.23

400 — Bad request.

Field	Type	Required	Description
error	string	Yes	Error message. Example: ERR_MALFORMED_REQUEST

401 — Unauthorized.

Field	Type	Required	Description
error	string	Yes	Error message. Example: UNAUTHORIZED

429 — Rate limit exceeded.

Field	Type	Required	Description
error	string	Yes	Error message. Example: RATE_LIMIT_EXCEEDED

500 — Internal server error.

Field	Type	Required	Description
error	string	Yes	Error message. Example: INTERNAL_ERROR