INTERACTIVE DEVELOPER CONSOLE
TEST LIVE CONVERSION & INSPECT PAYLOAD
GET /api/v1/currency/convert
CONVERTED RESULT
HTTP 200 OK • ~12ms
RAW JSON RESPONSE
{
"status": "success",
"from": "USD",
"from_name": "United States Dollar",
"to": "NGN",
"to_name": "Nigerian Naira",
"amount": 100,
"converted_amount": 134621,
"unit_rate": 1346.21,
"inverse_rate": 0.000743,
"formula": "1 USD = 1346.21 NGN",
"last_updated": "2026-11-01 00:35:21"
}
curl -X GET "https://codegreeks.com.ng/api/v1/currency/convert?from=USD&to=NGN&amount=100" \ -H "Accept: application/json"
AUTONOMOUS AI INTEGRATION // MODEL CONTEXT PROTOCOL
🤖 AI AGENTS, CURSOR & CLAUDE MCP SERVER
Empower Claude Desktop, Cursor, ChatGPT, and LangChain agents to autonomously convert currencies, fetch live 175-pair exchange rate matrixes, and audit historical rate shifts. Native JSON-RPC 2.0 MCP server enabled.
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"codegreeks-currency": {
"url": "https://codegreeks.com.ng/api/v1/currency/mcp",
"headers": {
"X-API-KEY": "YOUR_API_KEY"
}
}
}
}
Cursor AI & Windsurf (.cursor/mcp.json)
{
"mcpServers": {
"codegreeks-currency": {
"url": "https://codegreeks.com.ng/api/v1/currency/mcp",
"headers": {
"X-API-KEY": "YOUR_API_KEY"
}
}
}
}
4 Native MCP Tools:
convert_currency, get_exchange_rates, get_historical_rates, get_supported_currencies.
RESTFUL CONTRACT SPECIFICATION
CORE API ENDPOINTS
GET
High-Frequency Engine
/api/v1/currency/convert
Converts any specified numerical amount from an origin currency to a destination currency based on live institutional exchange rates.
QUERY PARAMETERS
from(string, optional, default:USD): The 3-letter ISO origin currency code (e.g.,EUR,USD,GBP).to(string, optional, default:NGN): The 3-letter ISO destination currency code (e.g.,NGN,CAD,KES).amount(numeric, optional, default:1): The positive numerical quantity to convert.
GET
Bulk Catalog
/api/v1/currency/rates
Retrieves the full dictionary of all 175 active exchange rates. Can dynamically re-base rates to any supported asset.
QUERY PARAMETERS
base(string, optional, default:USD): Re-bases all 175 exchange rates relative to this currency.
GET
Audit Telemetry
/api/v1/currency/history
Returns timestamped historical rate movements and audit logs stored in the database whenever an exchange rate moves.
QUERY PARAMETERS
currency(string, required, default:NGN): The 3-letter currency code to fetch audit logs for.limit(int, optional, default:25, max:100): Number of recent change events to return.
GET
Telemetry Counter
/api/v1/currency/count
Returns the exact count of actively tracked world currencies (172 assets), base asset, and failover redundancy telemetry in real-time.
SAMPLE RESPONSE
{ "status": "success", "currency_count": 172, "total_currencies": 172, "base": "USD", "redundancy_tiers": 4 }
GET
Asset Catalog
/api/v1/currency/currencies
Lists all 172 supported currency ISO codes alongside their full official names, symbols, and current rate relative to USD.
DATABASE AUDIT TELEMETRY
RECENT PRICE MOVEMENT LOGS
| ASSET / PAIR | PREVIOUS RATE | NEW RATE (USD) | MOVEMENT | LOGGED TIMESTAMP | STATUS |
|---|---|---|---|---|---|
ZMW
/ USD
|
20.1674 | 20.1401 | ▼ -0.0273 (-0.1356%) | Oct 31, 12:59:54 UTC | Verified |
ZAR
/ USD
|
16.7064 | 16.7197 | ▲ +0.0133 (0.0795%) | Oct 31, 12:59:54 UTC | Verified |
|
⚙️
XPT
/ USD
|
0.0007 | 0.0007 | ▼ 0.0000 (-0.2865%) | Oct 31, 12:59:54 UTC | Verified |
XPF
/ USD
|
106.9005 | 106.5510 | ▼ -0.3495 (-0.3270%) | Oct 31, 12:59:54 UTC | Verified |
XOF
/ USD
|
587.6233 | 585.7020 | ▼ -1.9213 (-0.3270%) | Oct 31, 12:59:54 UTC | Verified |
XCG
/ USD
|
1.8024 | 1.8000 | ▼ -0.0024 (-0.1329%) | Oct 31, 12:59:54 UTC | Verified |
|
🥈
XAG
/ USD
|
0.0203 | 0.0204 | ▲ +0.0001 (0.2808%) | Oct 31, 12:59:54 UTC | Verified |
XAF
/ USD
|
587.6233 | 585.7020 | ▼ -1.9213 (-0.3270%) | Oct 31, 12:59:54 UTC | Verified |
UZS
/ USD
|
11,995.4309 | 11,979.3336 | ▼ -16.0974 (-0.1342%) | Oct 31, 12:59:54 UTC | Verified |
UYU
/ USD
|
40.1830 | 40.1992 | ▲ +0.0162 (0.0402%) | Oct 31, 12:59:54 UTC | Verified |
UGX
/ USD
|
4,360.1385 | 4,250.4515 | ▼ -109.6870 (-2.5157%) | Oct 31, 12:59:54 UTC | Verified |
UAH
/ USD
|
45.3619 | 45.3000 | ▼ -0.0619 (-0.1365%) | Oct 31, 12:59:54 UTC | Verified |
CURRENCY REST API PLANS
DEVELOPER TIERS & API KEYS
Institutional exchange rates and conversion engine. Developer API keys never expire — request allowances refresh rolling monthly.
COMMUNITY FREE
PUBLIC
₦0.00
/ Free
Free Forever • No Card Needed
MONTHLY API ALLOWANCE
⚡ 1,000 Calls / Mo
~33 calls/day • Rate: 20 req/min
Instant access for open-source builders, hobbyists, and non-commercial prototyping.
● Non-Expiring Developer Key
GET FREE KEY →
DEVELOPER STARTER
STARTER
₦40,000
/ mo
≈ $25.00 USD / mo
MONTHLY API ALLOWANCE
⚡ 50,000 Calls / Mo
~1,667 calls/day • Rate: 60 req/min
Ideal for fintech startups, mobile apps, and e-commerce stores needing reliable live exchange rates.
● Non-Expiring Key • Commercial SLA
ACTIVATE STARTER →
DEVELOPER PRO
★ POPULAR
₦120,000
/ mo
≈ $75.00 USD / mo
MONTHLY API ALLOWANCE
⚡ 250,000 Calls / Mo
~8,333 calls/day • Rate: 300 req/min
Engineered for high-frequency e-commerce, AI agent tool-calling loops, and multi-tenant SaaS platforms.
● Non-Expiring Key • 99.98% SLA
ACTIVATE PRO KEY →
ENTERPRISE HIGH-LOAD
DEDICATED
₦400,000
/ mo
≈ $250.00 USD / mo
MONTHLY API ALLOWANCE
⚡ Unlimited Calls
Uncapped • High-Load Node • Rate: 1,000+ req/min
Unlimited volume for institutional trading, payment gateways, custom webhooks & direct WhatsApp SLA.
● Non-Expiring Key • Dedicated Node
ACTIVATE ENTERPRISE →
🔒
Permanent Non-Expiring API Keys: CodeGreeks Currency API access does NOT expire after 30 days. Developer keys remain permanently active, and monthly request allowances reset automatically on the 1st of each calendar month.
