POST & PATCH /v1/keys

Which key goes where: Public and secret keys.

Create a key: POST /v1/keys

The signup form calls this for you. No key needed; 5 signups a minute per IP.

string

required

Where your key and partnership follow-ups go.

string

required

string

required

A valid URL.

string

required

string

required

integer

Your fee, 0 to 100 bps. Default 0.

Optional: discord, blurb, category, chains, apisPlanned.

curl -s -X POST https://app.ravn.exchange/api/v1/keys \
  -H 'content-type: application/json' -d '{
    "email": "you@project.xyz",
    "projectName": "Your Project",
    "website": "https://project.xyz",
    "telegram": "@yourproject",
    "twitter": "@yourproject"
  }'

{ "data": { "apiKey": "rvn_live_…", "secretKey": "rvn_sk_…", "partnerId": "…", "feeBps": 0 } }

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 as x-api-key. Include at least one field.

integer

0 to 100 bps. See Pricing.

object

Any of evm, solana, thorchain (thor1…), bitcoin. A new or changed address takes effect 24 hours later. See Getting paid.

string

An https:// URL. See Webhooks.

string[]

Up to 20 sites (https://app.example.com) your public key works from in a browser. [] allows any.

curl -s -X PATCH https://app.ravn.exchange/api/v1/keys \
  -H 'x-api-key: rvn_sk_your_secret_key' \
  -H 'content-type: application/json' -d '{
    "feeBps": 25,
    "payoutAddresses": { "evm": "0xYourPayoutAddress" },
    "webhookUrl": "https://your-service.example/ravn-webhook"
  }'

{ "data": { "feeBps": 25, "payoutAddresses": { "evm": "0xYourPayoutAddress" },
            "webhookUrl": "https://your-service.example/ravn-webhook", "webhookSecret": "a1b2c3…" } }

webhookSecret comes back whenever you set webhookUrl. Enterprise keys: feeBps, webhookUrl and allowedOrigins answer 404 NOT_FOUND (RAVN sets your fee). 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.

curl -s -X POST https://app.ravn.exchange/api/v1/keys/secret \
  -H 'x-api-key: rvn_sk_your_current_secret_key'

{ "data": { "secretKey": "rvn_sk_…" } }

Errors

Code	When
`400 INVALID_REQUEST`	No field, or a bad value: `feeBps` out of range, a malformed address, a non-`https` webhook
`401 UNAUTHORIZED`	No key, or a secret key that was already rotated
`403 FORBIDDEN`	A public key, or not your current secret key
`404 NOT_FOUND`	A self-serve-only field on an enterprise key

​Create a key: POST /v1/keys

​Update a key: PATCH /v1/keys

​Rotate your secret key

​Errors

Create a key: POST /v1/keys

Update a key: PATCH /v1/keys

Rotate your secret key

Errors