GetRatesAPI Developer Documentation

GetRatesAPI gives developers a single, provider-agnostic HTTP API for currency exchange rate data, plus a hosted Model Context Protocol (MCP) server exposing the same data and a few extra tools (currency conversion, asset listings, usage) to MCP-capable clients.

This site documents:

• the REST API — currently the current-rate endpoint plus account/usage management,
• the hosted MCP server — get_rate, convert_currency, list_fiat_currencies, list_crypto_assets, get_usage.

Quick start

1. Register an account.

   curl -X POST https://your-getratesapi-host/v1/auth/register \
     -H "Content-Type: application/json" \
     -d '{"email":"you@example.com","password":"a-strong-password"}'

2. Log in to obtain a session token.

   curl -X POST https://your-getratesapi-host/v1/auth/login \
     -H "Content-Type: application/json" \
     -d '{"email":"you@example.com","password":"a-strong-password"}'

   Response:

   {
     "session_token": "gra_sess_0000000000000000000000000000000000000000000",
     "expires_at": "2026-10-09T12:00:00Z"
   }

3. Create an API key using the session token (see Authentication / API keys for the full flow).

4. Call the rate endpoint using the API key:

   curl https://your-getratesapi-host/v1/rates/EUR/USD \
     -H "Authorization: ApiKey gra_live_0000000000000000000000000000000000000000000000000000000000000000"

   or call the equivalent get_rate MCP tool from an MCP client.

What this site covers

A note up front: today, currency conversion and asset-catalog listing exist only as MCP tools (convert_currency, list_fiat_currencies, list_crypto_assets) — there is no REST endpoint for them. See REST API overview and MCP overview for details on why, and use the MCP tools if you need that functionality.

This is a local development instance in this milestone — there is no production docs.getratesapi.com/api.getratesapi.com deployment yet. Use your own local host/port wherever this site shows https://your-getratesapi-host.