Premium Analysis

GET /v1/premium

Compare exchange VWAP against the synthetic cross-rate to measure the local market premium over time.

Access: Builder, Professional, Enterprise. Free tier returns 403.

Parameters

Parameter	Type	Required	Description
pair	string	Yes	Pair identifier (e.g., BTCNGN).
start	string	No	Start date YYYY-MM-DD.
end	string	No	End date YYYY-MM-DD.
interval	string	No	5m, 1h, or 1d. Default: 1h.

Example

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

{
  "pair": "BTCNGN",
  "current": {
    "local_price": 92893027.67,
    "synthetic_price": 91959575.75,
    "premium": 933451.92,
    "premium_pct": 1.0049,
    "status": "verified",
    "timestamp": "2026-04-03T01:40:00+00:00"
  },
  "interval": "1h",
  "start": "2026-04-02",
  "end": "2026-04-03",
  "data": [
    {
      "timestamp": "2026-04-02T00:00:00+00:00",
      "avg_premium_pct": 0.6387,
      "max_premium_pct": 0.8678,
      "min_premium_pct": 0.4636,
      "avg_vwap": 94811096.61,
      "avg_synthetic": 94205162.45,
      "data_points": 12
    }
  ],
  "meta": {
    "avg_premium_pct": 0.89,
    "max_premium_pct": 1.90,
    "min_premium_pct": 0.0045,
    "data_points": 24
  }
}

Response fields

Field	Description
current	Latest snapshot: local_price, synthetic_price, premium, premium_pct, status, timestamp.
data[]	Time series of premium buckets per interval. Each has avg_premium_pct, max_premium_pct, min_premium_pct, avg_vwap, avg_synthetic, data_points.
meta	Aggregate stats across the full range: avg_premium_pct, max_premium_pct, min_premium_pct, data_points.