GET /builder/approval

Check whether an account has approved the authenticated builder.

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

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

Query Parameters

Field	Type	Required	Description
account	string	Yes	Account's Ethereum address. Example: 0xBuilderUserAddress

Example Request

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

Responses

200 — Builder approval status for the account.

Field	Type	Required	Description
account	string	Yes	Account's Ethereum address. Example: 0xBuilderUserAddress
builder_id	string	Yes	Builder ID. Example: builder_0123456789abcdef
approved	boolean	Yes	Whether the account has approved the builder. Example: true
max_fee_rate	string	No	Maximum builder fee rate as a decimal fraction. Uses 6-decimal fixed-point precision; 0.0005 is 5 bps. Example: 0.0005

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