GET /builder/users

Return builder-attributed users sorted by volume descending, then account ascending. Send either period=24h|7d|30d|90d or a custom start_time/end_time range up to 180 days. Use cursor or offset pagination, not both.

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

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
limit	integer	No	Rows per page. Defaults to 50, maximum 200. On /builder/markets, omit both limit and offset to get every market. Example: 10
offset	integer	No	Rows to skip, for numbered pages (ceil(count / limit) pages). Use this or cursor, not both. Example: 10
cursor	string	No	Opaque cursor: pass the previous response's next_cursor. Use this or offset, not both. Example: MTcwMDAwMDAwMDAwMDAwMDAwMDoweHRyYWRlOjB4b3JkZXI

Example Request

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

Responses

200 — Builder user statistics.

Field	Type	Required	Description
users	array[object]	No
count	string	Yes	Total rows matching the filters, before pagination. Example: 5
next_cursor	string	No	Cursor for the next page. Returned only for cursor pagination, and only when more rows exist. Example: MTcwMDAwMDAwMDAwMDAwMDAwMDoweHRyYWRlOjB4b3JkZXI

users items:

Field	Type	Required	Description
account	string	Yes	Account's Ethereum address. Example: 0xBuilderUserAddress
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
first_fill_timestamp	string	Yes	First-ever attributed fill timestamp for this builder and account. Example: 1672531200000000000
last_fill_timestamp	string	Yes	Last attributed fill timestamp for this builder and account inside the requested window. Example: 1672534800000000000

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