Skip to main content

Authorization

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

Finnhub

Prerequisites​

To connect Nexla to Finnhub, you will need a Finnhub API key. Finnhub provides a free tier that includes 60 API calls per minute, real-time US stock quotes, company news, basic fundamentals, and more. Paid plans are available for higher rate limits and additional data coverage.

Obtain a Finnhub API Key​

Follow these steps to create a Finnhub account and generate your API key:

  1. Navigate to finnhub.io/register to create a free Finnhub account.

  2. Enter your email address and create a password, then click Sign Up. Alternatively, sign in with your Google account.

  3. Check your email inbox for a verification message from Finnhub and click the verification link to activate your account.

  4. Once your account is verified, log in to the Finnhub Dashboard.

  5. Your API key is displayed directly on the dashboard. Copy this key — it will be entered into Nexla during credential setup.

Your Finnhub API key grants access to all endpoints permitted by your plan tier. Treat your API key as a secret — do not share it publicly or commit it to source control. If your key is compromised, you can regenerate it from the Finnhub dashboard.

Review Rate Limits​

Finnhub enforces rate limits based on your subscription plan. The free tier allows 60 API calls per minute. For high-volume or real-time data use cases, review Finnhub's pricing page to determine the plan that best fits your needs.

Create a Finnhub Credential​

  • To create a new Finnhub credential, after selecting the data source/destination 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 Authentication​

Finnhub uses API key authentication. The API key is passed as the X-Finnhub-Token HTTP request header on every API call Nexla makes to the Finnhub API.

  1. Enter your Finnhub API key in the API Key Value field. This is the key you copied from the Finnhub dashboard in the Prerequisites section above. The key is a unique alphanumeric string that identifies your account and authorizes access to the Finnhub API.

    The API key is stored securely and is used by Nexla to authenticate all requests sent to the Finnhub API on your behalf. Nexla automatically includes the key as the X-Finnhub-Token header, so no additional configuration is needed.

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/destination creation and can be selected for use with a new data source or destination.