How to Configure Gene-FinancialIntelligence — API Key Setup & Vault Configuration

Overview

Gene-FinancialIntelligence requires configuring API keys for the tools that use third-party financial data services. This guide walks you through signing up for free API keys, configuring them in Feluda Vault, and verifying that your setup is working correctly.

Important: Two tools work without any API keys at all. The Frankfurter API tools (frankfurterRates and frankfurterRate) give you immediate access to exchange rate data from 84 central banks covering 201 currencies. You can start using the gene right away with no configuration.

API Keys Required

The following five API keys are used by Gene-FinancialIntelligence. All are free:

Secret Name	Service	Sign Up URL	Free Tier Limits
OPENEXCHANGE_API_KEY	OpenExchangeRates	https://openexchangerates.org/signup	1,000 requests/month
EXCHANGERATE_API_KEY	ExchangeRate-API	https://exchangerate-api.com/signup	1,500 requests/month
ALPHA_VANTAGE_KEY	Alpha Vantage	https://www.alphavantage.co/support/#api-key	5 requests/minute, 500/day
FINNHUB_API_KEY	Finnhub	https://finnhub.io/register	60 requests/minute
CURRENCYAPI_KEY	CurrencyAPI	https://currencyapi.com/signup	300 requests/month

No-API-Key Option: Frankfurter

The Frankfurter API requires no API key and is completely free. It provides:

• Exchange rates for 201 currencies
• Data from 84 central banks
• Historical rates back to 1948
• No rate limits (requests are rate-limited to prevent abuse, but no monthly caps)

You can start using Gene-FinancialIntelligence immediately with the Frankfurter tools.

Step 1: Sign Up for API Keys (Optional)

Skip this step if you only want to use the Frankfurter tools.

OPENEXCHANGE_API_KEY (OpenExchangeRates)

1. Go to https://openexchangerates.org/signup
2. Create a free account
3. Once logged in, navigate to your dashboard
4. Your API key will be displayed in the "API Keys" section
5. Copy the key for use in Feluda Vault

EXCHANGERATE_API_KEY (ExchangeRate-API)

1. Go to https://exchangerate-api.com/signup
2. Sign up for a free account
3. Once logged in, your API key will be displayed on the dashboard
4. Copy the key for use in Feluda Vault

ALPHA_VANTAGE_KEY (Alpha Vantage)

1. Go to https://www.alphavantage.co/support/#api-key
2. Enter your email address and complete the form
3. You'll receive an email with your API key
4. Copy the key for use in Feluda Vault

FINNHUB_API_KEY (Finnhub)

1. Go to https://finnhub.io/register
2. Create a free account
3. Once logged in, navigate to your dashboard
4. Your API key will be displayed in the "API Keys" section
5. Copy the key for use in Feluda Vault

CURRENCYAPI_KEY (CurrencyAPI)

1. Go to https://currencyapi.com/signup
2. Create a free account
3. Once logged in, navigate to your dashboard
4. Your API key will be displayed in the "API Keys" section
5. Copy the key for use in Feluda Vault

Step 2: Configure Secrets in Feluda Vault

Once you have the API keys, configure them in Feluda Vault.

Method 1: Through Feluda Desktop Application

1. Open the Feluda Desktop Application
2. Navigate to the Vault section
3. Click "Add Secret"
4. For each secret, add the following key-value pairs:

Secret Name	Value
OPENEXCHANGE_API_KEY	Your OpenExchangeRates API key
EXCHANGERATE_API_KEY	Your ExchangeRate-API key
ALPHA_VANTAGE_KEY	Your Alpha Vantage API key
FINNHUB_API_KEY	Your Finnhub API key
CURRENCYAPI_KEY	Your CurrencyAPI key

5. Save each secret after adding it

Method 2: Using the Gene Builder Tool

When you deploy Gene-FinancialIntelligence, the secrets are automatically detected and listed in the Vault. You can configure them through the Feluda UI.

Step 3: Verify Your Configuration

Test Tools Without API Keys (Immediate Access)

These tools work immediately after deployment:

1. frankfurterRate

   • Run: tool:frankfurterRate with base=USD, quote=EUR
   • Expected: Real exchange rate for USD/EUR

2. frankfurterRates

   • Run: tool:frankfurterRates with base=USD
   • Expected: Exchange rates for USD against all currencies

3. forexAnalyst (Prompt)

   • Run: prompt:forexAnalyst with base=USD, quote=EUR, period=30d
   • Expected: Guided forex analysis workflow

Test Tools With API Keys

1. stockQuote (requires ALPHA_VANTAGE_KEY)

   • Run: tool:stockQuote with symbol=AAPL
   • Expected: Real-time stock data for Apple

2. companyOverview (requires ALPHA_VANTAGE_KEY)

   • Run: tool:companyOverview with symbol=AAPL
   • Expected: Company fundamentals for Apple

3. exchangeRate (requires OPENEXCHANGE_API_KEY)

   • Run: tool:exchangeRate with base=USD
   • Expected: Exchange rates for USD

4. currencyConvert (requires EXCHANGERATE_API_KEY)

   • Run: tool:currencyConvert with from=USD, to=EUR, amount=100
   • Expected: Converted amount

5. stockSearch (requires FINNHUB_API_KEY)

   • Run: tool:stockSearch with query=Apple
   • Expected: List of matching stocks

6. marketNews (requires FINNHUB_API_KEY)

   • Run: tool:marketNews with category=general
   • Expected: Latest market headlines

7. currencyRates (requires CURRENCYAPI_KEY)

   • Run: tool:currencyRates with base=USD
   • Expected: Currency rates

Troubleshooting

Tool Returns "Secret Not Configured"

This means the API key is not set in Feluda Vault.

• Check that you've added the secret to Vault
• Verify the secret name matches exactly (e.g., ALPHA_VANTAGE_KEY)
• Restart Feluda after adding secrets

Tool Returns HTTP 401 or 403 Error

This means the API key is invalid or expired.

• Verify you copied the correct API key
• Check if the API key has expired
• Regenerate the key if necessary

Tool Returns HTTP 429 (Too Many Requests)

This means you've exceeded the rate limit for the free tier.

• Wait for the rate limit window to reset
• Consider upgrading to a paid tier if you need higher limits
• Use Frankfurter tools for currency data (no rate limits)

Tool Returns HTTP 404 (Not Found)

This is a normal response when:

• A stock symbol doesn't exist (stockQuote)
• A currency pair is not supported

Next Steps

Once your API keys are configured, you can:

1. Use the AI prompts — marketAnalyst, currencyStrategist, investmentAdvisor, and forexAnalyst — for guided financial analysis
2. Integrate the tools into your investment research workflows
3. Create RunFlows that automate common analysis patterns
4. Explore the Frankfurter tools for historical currency analysis

Start immediately by using the Frankfurter tools. You don't need any API keys to begin accessing exchange rate data. Configure only the keys you need and add more later.