# API keys

Source: https://soheil.fi/developers/docs/keys/

One key per app: it carries your fee address, your fee and your limits.

## Getting a key

1.  Create a free account in the [developer dashboard](https://soheil.fi/developers/dashboard/) (email and password, confirmed with a code).
2.  In **API keys**, make a key: its name, the address that receives your fee, and your fee (0 to 90 bps).
3.  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.

```bash
-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.