QFqfex
user
builder

Create Builder Code

Changed on

Create the authenticated user's builder code. The code is generated server-side as a UUID and stored with active=true. Specify both QFEX and builder fee shares in basis points; they need not sum to 10000. QFEX share must be at least 5000 (50%), builder share must be >= 0, and their sum must be at most 10000. After create, reload builder-code mappings on clearing house.

post/user/builder-code

Request

  • Base URL
    https://api.qfex.com
  • URL
    https://api.qfex.com/user/builder-code
  • Auth
    API key in header x-qfex-hmac-signature and API key in header x-qfex-nonce and API key in header x-qfex-public-key and API key in header x-qfex-timestamp

Query parameters

api_versionstring
Example:2026-10-30

Published API contract date. Omit or use latest for the latest contract; explicit dates stay pinned. Applies to request validation and response format.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

builder_fee_share_bpsinteger required
qfex_fee_share_bpsinteger required

Example request

{
  "$schema": "https://api.qfex.com/contracts/2026-10-30/schemas/CreateBuilderCodeRequestBody.json",
  "builder_fee_share_bps": 3000,
  "qfex_fee_share_bps": 5000
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

builder_codestring required
builder_fee_share_bpsinteger required
builder_fee_share_percentnumber double required
created_atstring date-time required
qfex_fee_share_bpsinteger required
qfex_fee_share_percentnumber double required
updated_atstring date-time required

Example response

{
  "$schema": "https://api.qfex.com/contracts/2026-10-30/schemas/BuilderCodeDetails.json"
}

Changes