> For the complete documentation index, see [llms.txt](https://www.bluegamma.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.bluegamma.io/documentation/use-cases/fintech-api.md).

# Fintech & API Integration

How fintechs and platforms integrate BlueGamma's REST API and MCP server to embed live swap rates, forward curves and FX data in their products.

BlueGamma's REST API gives fintechs and platforms programmatic access to live forward curves, swap rates, and FX data across 30+ currencies, plus an MCP server for AI agent integration.

## Why Fintechs Need Programmatic Rate Access

If you're building a lending platform, treasury tool, or financial analytics product, you need reliable interest rate data in your stack — not in a spreadsheet. Common use cases:

* **Embed live swap rates** in client-facing dashboards
* **Automate loan pricing** with real-time forward curves
* **Power hedging recommendation engines** with current market data
* **Feed financial models** with discount factors and zero rates
* **Build AI agents** that can query rate data autonomously

## BlueGamma API Overview

* **Protocol:** REST (HTTPS)
* **Authentication:** `x-api-key` header
* **Coverage:** interest rate indices in 30+ currencies ([full list](https://www.bluegamma.io/documentation/data-coverage/whats-available/available-indices.md)), plus FX and government bonds
* **Response format:** JSON
* **Endpoints:** Forward curves, swap rates, discount factors, zero rates, FX forwards, government bond yields, and more

Full documentation: [API Reference →](https://www.bluegamma.io/documentation/integrations/api/api-reference.md)

## Quick Start

### cURL — Fetch a SOFR Swap Rate

```bash
curl -X GET "https://api.bluegamma.io/v1/swap_rate?index=SOFR&start_date=SPOT&maturity_date=5Y" \
  -H "x-api-key: your_api_key"
```

### Python — Fetch a SOFR Swap Rate

```python
import requests

response = requests.get(
    "https://api.bluegamma.io/v1/swap_rate",
    params={
        "index": "SOFR",
        "start_date": "SPOT",      # the index's spot date
        "maturity_date": "5Y",
    },
    headers={"x-api-key": "your_api_key"},
)

data = response.json()
print(f"5Y SOFR swap rate: {data['swap_rate']}")
```

More examples: [How to Price a Swap Using the API →](https://www.bluegamma.io/documentation/integrations/api/how-to-guides/how-to-price-a-swap-using-the-api.md)

## Authentication

Create your API key under **API Keys** in the app sidebar. Pass it via the `x-api-key` header on every request. [Authentication guide →](https://www.bluegamma.io/documentation/integrations/api/authentication.md)

## Rate Limits & Best Practices

BlueGamma enforces rate limits to ensure fair usage. Cache responses where possible and avoid polling for unchanged data. [Rate limits & best practices →](https://www.bluegamma.io/documentation/integrations/api/rate-limits.md)

## MCP Server for AI Agents

BlueGamma provides a [Model Context Protocol (MCP)](https://www.bluegamma.io/documentation/integrations/model-context-protocol.md) server, allowing AI agents and LLM-powered tools to query interest rate data directly. If you're building AI-powered financial tools, the MCP server lets your agents fetch curves and swap rates without custom API integration code.

## Available Data

| Data Type              | Example Endpoint       |
| ---------------------- | ---------------------- |
| Forward curves         | `/v1/forward_curve`    |
| Swap rates             | `/v1/swap_rate`        |
| Discount factors       | `/v1/discount_factors` |
| Zero rates             | `/v1/zero_rates`       |
| FX forward rates       | `/v1/fx_forward`       |
| Government bond yields | `/v1/gov_yield`        |
| Fixing rates           | `/v1/fixing`           |

Full endpoint reference: [API Reference →](https://www.bluegamma.io/documentation/integrations/api/api-reference.md)

## Frequently Asked Questions

### What's the API latency?

Typical response times are under 500ms for most endpoints. Forward curves and swap pricing may take slightly longer depending on the complexity of the request.

### Can I stream real-time data?

Yes — BlueGamma supports real-time FX data streaming. [Streaming guide →](https://www.bluegamma.io/documentation/integrations/api/how-to-guides/streaming-real-time-fx-data.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.bluegamma.io/documentation/use-cases/fintech-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
