Authentication

How to authenticate with the BlueGamma API using your API key.

All BlueGamma API requests require authentication using an API key provided by our team.

---

Getting an API Key

API keys are issued by the BlueGamma team. To request access:

1. Contact us at [e-mail]

2. Book a demo at bluegamma.io

We'll set you up with a key and help you get started quickly.

---

Using Your API Key

Include your API key in the x-api-key header with every request:

curl -X GET "https://api.bluegamma.io/v1/swap_rate?index=SOFR&tenor=5Y" \
  -H "x-api-key: your_api_key_here"

---

Example Requests

Python:

import requests

headers = {
    "x-api-key": "your_api_key_here"
}

response = requests.get(
    "https://api.bluegamma.io/v1/swap_rate",
    params={"index": "SOFR", "tenor": "5Y"},
    headers=headers
)

print(response.json())

JavaScript:

const response = await fetch(
  "https://api.bluegamma.io/v1/swap_rate?index=SOFR&tenor=5Y",
  {
    headers: {
      "x-api-key": "your_api_key_here"
    }
  }
);

const data = await response.json();
console.log(data);

---

Error Responses

Status Code	Meaning
403	Missing or invalid API key — check your x-api-key header
429	Rate limit exceeded — see Rate Limits

---

Security Best Practices

• Keep your API key secret — Don't commit it to version control or expose it in client-side code

• Use environment variables — Store your key in environment variables rather than hardcoding

• Rotate if compromised — Contact us immediately if you suspect your key has been exposed

# Store in environment variable
export BLUEGAMMA_API_KEY="your_api_key_here"

import os

api_key = os.environ.get("BLUEGAMMA_API_KEY")

---

Need Help?

If you're having trouble authenticating or need a new API key:

• Email: [e-mail]

• Book a call: Schedule here