Skip to main content

Quickstart

1. Get an API key​

Sign up at the moxie Dashboard to generate your API key. The free tier gives you 10 requests per minute and 5,000 requests per month.

See Pricing for plan details.

2. Fetch a live rate​

curl "https://api.moxiemetrx.com/v1/rates/live?pairs=BTCNGN" \
  -H "X-API-Key: your_key"

Response (Free tier):

{
  "data": {
    "BTCNGN": {
      "rate": 92745268.5,
      "calculation": "vwap",
      "data_freshness_seconds": 7,
      "sources": [
        {"exchange": "luno", "rate": 92948735.0, "time": "2026-04-03T01:45:00+00:00"},
        {"exchange": "quidax", "rate": 92541802.0, "time": "2026-04-03T01:45:00+00:00"}
      ],
      "status": "verified",
      "data_quality": "high"
    }
  },
  "meta": {
    "request_id": "e75175fc-...",
    "timestamp": "2026-04-03T01:45:07.818376+00:00",
    "latency_ms": 5
  }
}

Access the rate: response.data.BTCNGN.rate

3. Fetch historical data​

curl "https://api.moxiemetrx.com/v1/rates/historical?pair=BTCNGN&start=2026-04-02&end=2026-04-03&interval=1h&limit=2" \
  -H "X-API-Key: your_key"

Response:

{
  "pair": "BTCNGN",
  "interval": "1h",
  "start": "2026-04-02",
  "end": "2026-04-03",
  "data": [
    {
      "time": "2026-04-02T00:00:00+00:00",
      "pair": "BTCNGN",
      "open": 94400037.0,
      "high": 95655881.0,
      "low": 93909641.90,
      "close": 95480686.0,
      "vwap": null,
      "total_volume": 0.0,
      "verification": {
        "status": "verified",
        "data_quality": "high"
      }
    }
  ],
  "meta": {
    "request_id": "...",
    "row_count": 2,
    "has_more": true,
    "next_cursor": "2026-04-02T01:00:00+00:00",
    "limit": 2,
    "limit_max": 2500
  }
}

Paginate by passing cursor=<meta.next_cursor> on the next request until has_more is false.

Next steps​