API keys are optional. All public endpoints work without authentication, and you can create and complete swaps without one.
An API key gives you two things:
- Attribution & tracking — every swap created with your key is attributed to you, so you can track your integration’s volume in the developer dashboard.
- Fee markup — you can add your own surcharge on top of Satora’s swap fee and earn revenue on each swap routed through your integration.
Get an API Key
Sign up at developer.satora.io and create a key. Each key has two fee settings:
default_extra_fee_bps — the markup (in basis points) applied when a swap doesn’t specify one.max_extra_fee_bps — the cap for per-swap markups. Requests above this cap are rejected with 400.
Set the key once on the ClientBuilder — every getQuote / createSwap call is then attributed to it automatically:
Alternatively, pass the key on individual calls. A per-call referralCode always wins over the client-level default:
Add a Fee Markup
To charge a per-swap markup, pass extraFees (basis points, up to your key’s max_extra_fee_bps). If you omit it, the key’s default_extra_fee_bps applies.
Pass the same extraFees value to both getQuote and the matching
createSwap — otherwise the quoted amount won’t match what the swap
actually charges.
getReferralFee:
REST API
If you call the HTTP API directly, pass the key as the ref query parameter on GET /quote (with optional extra_fees in bps), and as referral_code / extra_fees in the body when creating a swap. See the API Reference for the exact schemas. 
