Skip to main content
A builder code names you on an RFQ. The positions it opens, and the fees they pay, count toward your revenue share. Codes look like tot_rfq_production_ followed by 32 hex characters, with staging in place of production on Staging. Totalis issues them: see Get access.

Which code an RFQ records

A refused code is 400 INVALID_REQUEST with a field violation on /builder_code, and no RFQ is created. A code is recorded once, when the RFQ is created, and never changes. Cash-out RFQs take no builder fields: a position keeps the attribution of the RFQ that opened it. An admitted account needs nothing from you on each RFQ. Signing is only for accounts you did not admit.

Sign an origin code

For an account no partner admitted, an origin code works only on a browser request from its origin: a wallet session that signed in on your page. An API key request carries no origin, so a signed code is refused there. An account you admitted needs no origin code: its API key RFQs record your account code. Create RFQ takes three extra fields:
The message is six lines joined by \n, with no trailing newline:
The request JSON is minified, with the keys in this order: intent_id and intent_generation only when you send them, then stake, legs, builder_code and origin. Each leg is {"outcome_id","side"} in that order. origin is the page’s origin, exactly as the browser sends it in Origin. intent_generation is a decimal string. Send the legs in strictly increasing outcome_id order, as Create RFQ requires.
Sign on your server, where the builder signer’s key lives. Your page sends the RFQ terms (with intent_id and intent_generation when the RFQ carries them), its chosen Idempotency-Key and the account_id; your server checks them and returns the two fields.
The SDK’s openPosition does not send builder fields. Create the RFQ with totalis.client.POST("/v1/rfqs") under the signed Idempotency-Key, then take a quote from watchQuotes, and sign and send it with signEntry and sendAcceptance (SDK).

Reports and payouts

Totalis pays you a share of the total fees on positions your codes opened, in USDC on HyperEVM, to the payout address you registered. Your share is agreed with Totalis and recorded as terms: each terms entry prices every fee from its UTC day until the next one. Read your report from your server with your server key. It holds the figures Totalis pays from.
Amounts are atomic USDC decimal strings, 6 decimals: "1500000" is 1.50 USDC. A payout counts as paid in full from the moment Totalis queues it; if less lands on-chain, the rest returns to owed. Totalis decides when to pay, so owed is what you have earned and not yet been paid, not a schedule. A per-position list of fees, each with its transaction hash, is by email: ask founders@totalis.trade. To change your payout address, email us from your registered contact.

Rotation and revocation

To rotate a code or your signer, or to revoke a code, email founders@totalis.trade.