Response Format

Understanding API response structure

Standard Response

All successful responses follow this structure:

{
  "metric_id": "ME10001",
  "metric_name": "Stablecoin Health Index",
  "timestamp": "2026-01-28T12:00:00Z",
  "data": {
    "value": 0.9985,
    "relchg": -0.15,
    "score": 72
  },
  "time_dimension": "now",
  "asset": "USDT"
}

Fields

Field	Type	Description
metric_id	string	Unique metric identifier (e.g., ME10001)
metric_name	string	Human-readable metric name
timestamp	string	ISO 8601 timestamp of data
data	object	Metric values (see below)
time_dimension	string	Requested time period
asset	string	Asset/pair if applicable

Data Object

The data object contains up to three variants:

Variant	Type	Description
value	number	Absolute/raw value
relchg	number	Relative change (%)
score	number	Normalized 0-100 score

Request Specific Variants

Request only the variant you need:

# Get only score
GET /v1/metrics/ME10001?variant=score

# Response
{
  "metric_id": "ME10001",
  "data": {
    "score": 72
  }
}

Time Dimensions

Parameter	Description
now	Current/real-time
past1h	Past 1 hour average
past4h	Past 4 hours average
past8h	Past 8 hours average
past24h	Past 24 hours average
past7d	Past 7 days average
past30d	Past 30 days average

Error Response

{
  "error": "invalid_metric",
  "message": "Metric ID 'ME99999' not found",
  "code": 404
}