# CodeGreeks Real-Time Currency Converter & FX REST API

> CodeGreeks provides an ultra-low latency (<15ms), institutional-grade exchange rate and conversion REST API covering 172 world currencies, cryptocurrencies (BTC, ETH), and precious metals (Gold, Silver, Platinum, Palladium) with automated 4-tier failover redundancy and database audit telemetry.

## Base URL
https://codegreeks.com.ng/api/v1/currency

## Model Context Protocol (MCP) Server Endpoint
https://codegreeks.com.ng/api/v1/currency/mcp

## Machine-Readable AI Documentation
- Full Documentation for AI Agents: https://codegreeks.com.ng/agents.md
- Full LLM Specification: https://codegreeks.com.ng/llms-full.txt
- Tool Schemas: https://codegreeks.com.ng/api/v1/currency/tools

## Core Endpoints
- `GET /convert?from=USD&to=NGN&amount=100`: Converts between any two world currencies.
- `GET /rates?base=USD`: Returns all 172 exchange rates rebased to any asset.
- `GET /count`: Returns total count of tracked currencies (172) and cluster telemetry.
- `GET /history?currency=NGN&limit=25`: Returns historical rate shift audit logs from the database.
- `GET /currencies`: Returns dictionary of all 172 currencies with names and symbols.

## Authentication
Pass your API Key via header `X-API-KEY: YOUR_API_KEY` or Bearer Token.
Free playground requests are supported at https://codegreeks.com.ng/developers/currency-api.