Skip to main content

Authorization

Follow this guide to create a new CoinGecko credential that will allow Nexla to authenticate to and exchange data with your CoinGecko account.
coingecko_api_auth.png

CoinGecko

Prerequisites​

To connect Nexla to the CoinGecko API, you need a CoinGecko API key. CoinGecko offers two categories of API plans: a free Demo plan suitable for development and light usage, and paid Pro plans (Analyst, Lite, Pro, and Pro+) for production workloads requiring higher rate limits and access to the full suite of endpoints.

Obtain a CoinGecko API Key​

  1. Sign in to your CoinGecko account at www.coingecko.com. If you do not yet have an account, click Sign Up and complete the registration process.

  2. Navigate to the CoinGecko Developer Dashboard by clicking your account menu in the top-right corner and selecting Developer Dashboard, or by going directly to https://www.coingecko.com/en/developers/dashboard.

  3. Click the + Add New Key button to generate a new API key.

  4. Provide a descriptive label for the key (for example, "Nexla Integration") to help identify its purpose later.

  5. Click Generate Key. Your new API key will be displayed on the screen.

Important

Copy and store your API key in a secure location immediately. For security reasons, the key will not be fully visible again after you navigate away from the page. Treat the API key as a secret — do not commit it to source control or share it publicly.

  1. Note which plan tier your account is subscribed to, as this determines which header name your API key requires:

    • Demo (free) plan keys: Use the request header x-cg-demo-api-key.
    • Pro paid plan keys: Use the request header x-cg-pro-api-key.

    Nexla uses the API key as a Bearer token in the Authorization header automatically, but if you need to pass additional custom headers for plan-specific requirements, you can add them in the data source configuration.

For complete information about CoinGecko API plans and rate limits, see the CoinGecko API Pricing page. The Demo plan supports up to 100 calls per minute; paid plans offer higher limits starting at 300 calls per minute.

Create a CoinGecko Credential​

  • To create a new CoinGecko credential, after selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key​

  1. Enter your CoinGecko API key in the API Key field. This key authenticates Nexla with the CoinGecko API and should be kept secure. Nexla will include this key in API requests to CoinGecko on your behalf.

Nexla supports both Demo and Pro CoinGecko API keys. Ensure the key you enter corresponds to the plan you are subscribed to. Demo keys provide access to the core set of market data endpoints; Pro keys unlock additional endpoints and higher rate limits. For a full list of endpoints available per plan, see the CoinGecko Endpoint Overview.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source creation and can be selected for use with a new data source.