Step 1: Open the Console
๐ https://console.defindex.io/ Create your account with an email and a password, or log in if you already have one.Step 2: Generate the Key
In the console, open the API Keys section and click Generate API Key. The key looks likesk_1234567890abcdef..., and it is the only credential your backend needs. Copy it when it is shown.
You hold one active API key at a time. Generating a new key revokes the previous one immediately, so any service still sending the old value starts receiving 403. There is no overlap window: roll the new key out as soon as you generate it.
Keep it secret. The key carries your accountโs permissions. Store it in an environment variable, never commit it, and never ship it in client-side code.
Step 3: Use the API Key in Requests
Include the key as a Bearer token in theAuthorization header:
GET /health and GET /vault/discover?network=mainnet need no key. Everything else returns 403 without a valid one.
Key Lifetime and Rotation
The API key does not expire on a timer. It stays valid until it is revoked, and there are only two ways that happens:- You generate a new key, which revokes the previous one.
- You revoke it explicitly from the API Keys section of the console.
403 Forbidden resource, the key was replaced or revoked, not expired. Check the current value in the console.
refresh_tokenis unrelated to your API key./loginand/refreshissue short-lived JWT access tokens, which is how the console authenticates its own session. If you authenticate with an API key, you never call/refresh.