Аутентификация (x-api-key)

SwapKit принимает опциональный заголовок x-api-key из Partner Dashboard (Monetization).

На портале#

Источник	Приоритет
Файл data/swapkit.api-key (0o600)	1
Env SWAPKIT_API_KEY	2

Установка: /api-keys-install. Прокси /api/proxy/swapkit/* сам подставляет ключ; ответ содержит x-swapkit-auth: key|anonymous.

Что даёт ключ#

• Affiliate / fee tiers из дашборда на /v3/quote.
• Надёжный доступ к quote: без ключа POST /v3/quote с части сетей/IP отвечает 403 Cloudflare (проверено с бокса портала 2026-09-13).
• Каталог GET /providers и GET /tokens обычно доступны анонимно.

Override affiliate#

В теле quote можно передать affiliateFee (bps, 0–1000) — перекрывает тиры дашборда. На конструкторе маршрутов: пресет fees.swapkit.bps.

Правила#

• Ключ не коммитится, не показывается в UI целиком.
• Клиентские auth-заголовки прокси отбрасывает.