Create a key: POST /v1/keys
The signup form calls this for you. No key needed; 5 signups a minute per IP. Optional:discord, blurb, category, chains, apisPlanned.
apiKey is your public key. secretKey is shown only in this response: store it on your server.
Update a key: PATCH /v1/keys
Send your secret key asx-api-key. Include at least one field.
0 to 100 bps. See Pricing.
Any of
evm, solana, thorchain (thor1…), bitcoin. A new or changed address takes effect 24 hours later. See Getting paid.An
https:// URL. See Webhooks.Up to 20 sites (
https://app.example.com) your public key works from in a browser, replacing the current list. [] allows any, except in the widget, which needs your site listed.webhookSecret comes back whenever you set webhookUrl.
Enterprise keys: feeBps, webhookUrl and allowedOrigins answer 404 NOT_FOUND (RAVN sets
your fee), so an enterprise key doesn’t work in the widget yet. payoutAddresses works.
Rotate your secret key
POST /v1/keys/secret, no body, with your current secret key as x-api-key. The old secret stops
working within a minute. A key from before secret keys existed claims its first secret the same way,
before 1 December 2026. Lost your secret key? Contact RAVN.

