Skip to main content

​
Client API Key Overview

Decibel’s GET APIs require a Client API Key for authentication. Without a valid Client API key, GET API requests will fail. The Client API key is used to authenticate requests to Decibel’s read-only endpoints.
Required for GET APIs: All GET API requests require a Client API key. Requests without a valid Client API key will be rejected.

​
Getting a Client API Key

To obtain a Client API key, you need to create one on Geomi:
  1. Visit https://geomi.dev
  2. Sign up or log in to your account
  3. Navigate to the client keys section
  4. Generate a new client API key
  5. Copy and securely store your Client API key
Geomi Account: You’ll need a Geomi account to generate Client API keys. If you don’t have one, you can sign up at https://geomi.dev.

​
Using the Client API Key

Once you have your Client API key, include it in the Authorization header of your HTTP requests: 
Authorization: Bearer YOUR_CLIENT_API_KEY

​
Example Requests

Here are examples of making a GET request with the Client API key in different languages: 
curl -X GET "https://api.decibel.trade/v1/markets" \
  -H "Authorization: Bearer YOUR_CLIENT_API_KEY"
Security Best Practices: - Never commit your Client API key to version control - Store API keys in environment variables or secure key management systems - Rotate your API keys regularly - Use different keys for development and production environments

​
Troubleshooting

​
401 Unauthorized Error

If you receive a 401 Unauthorized error:
  1. Verify your Client API key is correct
  2. Ensure you’re using the Bearer token format: Authorization: Bearer YOUR_KEY
  3. Confirm your key hasn’t expired or been revoked on Geomi

​
403 Forbidden Error

If you receive a 403 Forbidden error:
  1. Verify your Client API key is correct
  2. Check that your key has the necessary permissions
  3. Ensure the key is properly formatted in the Authorization header

​
Next Steps

Now that you have your Client API key set up, you can: