> For the complete documentation index, see [llms.txt](https://docs.swapper.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.swapper.finance/integrator-dashboard/overview.md).

# Overview

The **Integrator Dashboard** at [`https://swapper.finance/dashboard`](https://swapper.finance/dashboard) is where you manage your integration yourself: see your volume and API traffic, create API keys, configure webhooks, set payout addresses, and manage your team. On the Swapper site it's linked as **Partner Login**.

## Getting access

Anyone can sign up.&#x20;

* Enter your work email in the [dashboard](https://swapper.finance/dashboard/) and confirm with the one-time code.\
  A new email creates a new integrator, and you become its owner.
* Owners can then add the rest of the team under Settings → Team.

### Signing in

There are no passwords. Sign in with a **one-time code**:

1. Enter the work email.
2. Swapper emails you a **6-digit code**, valid for **10 minutes**.
3. Enter the code **in the same browser** you requested it from — the code is tied to that browser, so nobody else can use or burn it. After 5 wrong attempts a code stops working — request a new one.

The sign-in page always says a code was sent, whether or not the email has access, so it never reveals who's a member. If no code arrives, check your spam folder and the address you entered. To join an existing team instead of creating a new integrator, ask one of its owners to add you. Code requests are throttled per email and per network.

A session lasts **7 days**. Sign out from the sidebar or **Settings → Session**. If your email belongs to more than one integrator, switch between them in the sidebar.

## Roles

Every team member is an **owner** or a **member**.

| Action                                                              | Member | Owner |
| ------------------------------------------------------------------- | :----: | :---: |
| View Overview, API usage, Fees & earnings                           |    ✓   |   ✓   |
| View the API key list and webhook deliveries                        |    ✓   |   ✓   |
| View settings and the team                                          |    ✓   |   ✓   |
| Create and revoke API keys                                          |        |   ✓   |
| Edit webhook endpoints; reveal, create or rotate the signing secret |        |   ✓   |
| Edit allowed origins and payout addresses                           |        |   ✓   |
| Add and remove team members                                         |        |   ✓   |

An integrator always keeps at least one owner — the last owner can't be removed.

## Pages

All charts and tables use **UTC** days. Pick the period at the top of the page: the last 7, 30 (default) or 90 days, or a custom range of up to a year.

### Overview

**Completed deposits** through your integration — from the widget and from the API — for the selected period:

* **Volume** (USD), **transactions**, **unique wallets**, and **integrator fees earned**;
* **daily volume**;
* volume **by deposit method** — fiat on-ramp, transfer crypto (QR to a smart wallet), deposit address (QR or API) and wallet deposit — and **by chain**.

### API usage

Requests attributed to your integrator: made with your API key, from Swapper's hosted widget or your allowed origins, or naming your public `integratorId`.

* requests per day, with **4xx**, **5xx** and **rate-limited (429)** counts;
* a breakdown **by endpoint**, with average latency;
* how requests were **authenticated** — API key, widget, or public;
* **your rate limits** — the per-minute limits that apply to you, including any increases. See [Rate Limits](https://docs.swapper.finance/api-v1/rate-limits.md).

{% hint style="info" %}
Because your `integratorId` is public, "public" traffic can include requests other people made with your id. Use [allowed origins](https://docs.swapper.finance/api-v1/authentication.md#browser-requests-and-allowed-origins) and API keys to keep your traffic clearly yours.
{% endhint %}

### API keys

Secret keys for calling the [API](https://docs.swapper.finance/api-v1/authentication.md) from your servers — needed for [integrator fees](https://docs.swapper.finance/api-v1/integrator-fees.md) and higher [rate limits](https://docs.swapper.finance/api-v1/rate-limits.md).

* The list shows each key's **name**, **prefix** (e.g. `swp_AbCd1234`), when it was created and by whom, when it was **last used** (updated every few minutes), and whether it's **revoked**.
* **Create key** (owners): give it a name that says where it lives. The full key is shown **once** — copy it into your secret manager before closing the dialog.
* Up to **10 active keys**; all of them share your rate-limit budget.
* **Revoke** (owners): requests using the key start failing within a minute. This can't be undone.
* Keys work against production only.

### Webhooks

Self-service configuration for [webhooks](https://docs.swapper.finance/tracking-deposits/webhooks.md):

* **Endpoints** (owners): up to **5** HTTPS URLs on public hosts. Every completed deposit is POSTed to each of them as a `transaction.completed` event.
* **Signing secret** (owners): reveal and copy it, generate one if you don't have one yet, or **rotate** it. Without a secret, deliveries are **unsigned**. Rotating takes effect immediately — the old secret stops being used for new deliveries — so update your handler right away.
* **Recent deliveries**: the last 50 events sent to your endpoints, with time, event type, deposit id and endpoint. This lists what Swapper **sent**; check your own logs for how your endpoint responded.

### Fees & earnings

Your [integrator fee](https://docs.swapper.finance/api-v1/integrator-fees.md) earnings:

* your **Swapper fee** and your **maximum integrator fee** per quote;
* **earned**, **paid** and **pending** totals;
* **monthly earnings** (UTC calendar months; the current month is still accruing);
* every **payout**, with its date, amount and transaction hash;
* **payout addresses** (owners): an EVM address — the same address is used on every EVM chain — and/or a Solana address. Accrued fees are paid out there periodically.

### Settings

* **Integrator** — your `integratorId`, with a copy button. Pass it to the widget, the SDK and the API. It's public: it identifies you, it doesn't authenticate you.
* **Allowed origins** (owners) — lock browser use of your `integratorId` to your own sites. Opt-in; up to 20 origins. See [Authentication → Allowed origins](https://docs.swapper.finance/api-v1/authentication.md#browser-requests-and-allowed-origins).
* **Team** — everyone who can sign in, with their role and last sign-in. Owners add members by email (as owner or member) and remove them.
* **Session** — sign out.
