Authentication

Authenticate API requests with a Bearer secret key. Never expose secret keys in client-side code — use them only on your server.

API keys

Keys live under Developers → API Keys. Test keys start with sw_test_, live keys with sw_live_. Publishable keys (sw_pk_) are reserved for future client SDKs.

cURL
curl https://api.swellpayments.com/v1/balance \
  -H "Authorization: Bearer sw_test_..."

IP restrictions

Attach an allowlist to live keys so only your servers can call the API. Requests from other IPs return 403.