Get started
API keys
One key per app: it carries your fee address, your fee and your limits.
Getting a key
- Create a free account in the developer dashboard (email and password, confirmed with a code).
- In API keys, make a key: its name, the address that receives your fee, and your fee (0 to 90 bps).
- Copy the key: it is shown only once. While keys are approved by hand, it works once we approve it (usually within a day).
You get a key like sk_<prefix>_<secret>.
Using it
Send it in the x-api-key header on every call that needs one.
-H "x-api-key: sk_xxxxxxxx_…"We keep only a hash of the secret, so a lost key is replaced, not recovered. Keep it on your server.
Changing a key
Each key carries its fee address, its default fee, its fee ceiling and its limits. Change the name, fee address and fee in the dashboard, switch a key off or delete it there at once if it leaks; write to developers [at] soheil.fi for higher limits.
Turn on two-factor sign-in in the dashboard's Settings: your account controls where your fees go.