Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

maxBuilderFee

Returns the approval a user has granted to one builder: its status and the maximum fee rate the builder may charge. A builder calls this during account setup to confirm that approveBuilderFee took effect, and before sending orders that carry a builder fee.

POST/infotype maxBuilderFee

Check that a user has approved your builder, and at what cap, before sending orders with a builder fee.

Request body
builderstring · addressrequired

Builder address to look up.

typestringrequired

Must be `maxBuilderFee`.

"maxBuilderFee"
userstring · addressrequired

Account that granted the approval.

Request example
curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "type": "maxBuilderFee",
  "user": "0x95761f4d19B906B3B09da3EeE0BF30B337f4dB88",
  "builder": "0x2e4d75df2ee2653ea7a113cc1fa36d45e923061f"
}'
Try it
POST https://rpc.txflow-testnet.xyz/info
Response 200
codeinteger

`0` on success.

dataobject
maxFeeRateinteger

Approved maximum in tenths of a basis point: `10` is `0.01%`. `0` unless `status` is `ACTIVE`.

statusstring

`ACTIVE` while the approval is in force; `NONE` when the user never approved this builder.

"ACTIVE""REVOKED""NONE"
successboolean

`false` on error, with `code` set and the text in `message` instead of `data`.

Response example
{
  "success": true,
  "code": 0,
  "data": {
    "maxFeeRate": 10,
    "status": "ACTIVE"
  }
}

maxFeeRate is an integer in tenths of a basis point: 10 is 0.01%. Keep the builder fee on each order at or below this cap.

statusMeaning
ACTIVEThe approval is in force; maxFeeRate is the cap.
REVOKEDThe user revoked the approval; maxFeeRate is 0.
NONEThe user has never approved this builder; maxFeeRate is 0.

Next steps