Integrator fees and payouts

Integrators can now charge their own fee on the trades their users make through them, see it on every quote and settled trade, and claim it in USDC through four new routes under /payouts. All of it needs an integrator key.

What changed

• Your fee on every quote made with your key. Treasures configures a default fee and a ceiling for your key; send integrator_fee_bps on POST /quote/buy, POST /quote/sell or POST /quote/preview to use a different fee on one quote. Each leg reports it as cost_breakdown_bps.integrator_fee_bps, and estimated_output_* already allows for it.
• Submit with the key that quoted. A quote that carries your fee is refused at POST /trade/submit with 403 quote_integrator_mismatch if it arrives without that key.
• New quote refusals: 400 invalid_integrator_fee, 400 integrator_fee_requires_api_key and 503 integrator_fee_misconfigured.
• Settlements: GET /settlements gains an integrator_fee entry in fee_costs, with the payout_id it went out in, and two filters, payout_id and payout_status.
• Payouts, general tik_ key only: GET /payouts/accrued (what you are owed and whether you can claim it), POST /payouts (claim all of it to your registered address; Idempotency-Key required), GET /payouts and GET /payouts/{payoutId}.

What to do

Nothing, if you do not charge a fee: a quote without your key is unchanged, and with it your configured default applies. To charge or claim fees, read Integrator Fees and Payouts, and always submit fee-carrying quotes with the key that requested them.