API Reference

Pull On Hive network and stablecoin intelligence directly into your own tools and dashboards.

API access is a Pro feature

Upgrade to generate your API key and start making requests.

Upgrade to Pro →

Overview

The On Hive API provides read-only access to the same live scores and snapshots that power the dashboard. Data is updated daily. All endpoints return JSON and support CORS so you can call them directly from browsers or backend services.

Base URL

https://onhive.xyz/api/v1

Auth header

x-api-key: ohive_...

Rate limit

60 requests / minute

Update cadence

Daily (once per day)

Authentication

Every request must include your API key in the x-api-key header. Keys are tied to your Pro account and can be regenerated from the Account page at any time. Keep your key secret — treat it like a password.

bash
curl https://onhive.xyz/api/v1/networks \
  -H "x-api-key: ohive_your_key_here"

Endpoints

GET/api/v1/networks

Returns the latest snapshot for all 20 tracked networks, sorted by institutional grade score descending.

curl
curl https://onhive.xyz/api/v1/networks \
  -H "x-api-key: ohive_your_key_here"
json
{
  "data": [
    {
      "network": "Stellar",
      "institutional_grade_score": 91,
      "cost_efficiency_score": 99,
      "reliability_score": 99,
      "median_tx_cost_usd": 0.00001,
      "tps_current": 1000,
      "uptime_30d": 99.9,
      "recorded_at": "2026-06-15T08:00:00Z"
    },
    ...
  ],
  "count": 20
}
FieldTypeDescription
networkstringNetwork name (e.g. "Solana", "Ethereum")
institutional_grade_scoreintegerComposite institutional score, 0–100
cost_efficiency_scoreintegerCost score derived from median tx cost, 0–100
reliability_scoreinteger30-day uptime score, 0–100
median_tx_cost_usdnumberMedian transaction fee in USD
tps_currentnumberCurrent observed transactions per second
uptime_30dnumber30-day uptime percentage (e.g. 99.9)
recorded_atstringISO 8601 timestamp of this snapshot
GET/api/v1/stablecoins

Returns the latest snapshot for all 16 tracked stablecoins, sorted by market cap descending.

curl
curl https://onhive.xyz/api/v1/stablecoins \
  -H "x-api-key: ohive_your_key_here"
json
{
  "data": [
    {
      "symbol": "USDC",
      "market_cap_usd": 43500000000,
      "volume_24h": 8200000000,
      "price": 1.0001,
      "peg_deviation_percent": 0.01,
      "peg_stability_score": 98,
      "reserve_quality_score": 95,
      "momentum_score": 72,
      "velocity_score": 68,
      "institutional_adoption_score": 95,
      "recorded_at": "2026-06-15T08:00:00Z"
    },
    ...
  ],
  "count": 16
}
FieldTypeDescription
symbolstringTicker symbol (e.g. "USDC", "USDT")
market_cap_usdnumberTotal market capitalisation in USD
volume_24hnumber24-hour trading volume in USD
pricenumberCurrent price in USD
peg_deviation_percentnumber% deviation from $1.00 (positive = above peg)
peg_stability_scoreintegerPeg stability score over 30 days, 0–100
reserve_quality_scoreintegerReserve quality and audit score, 0–100
momentum_scoreintegerMarket cap growth momentum score, 0–100
velocity_scoreintegerVolume/market cap velocity score, 0–100
institutional_adoption_scoreintegerInstitutional integration score, 0–100
recorded_atstringISO 8601 timestamp of this snapshot
GET/api/v1/networks/{network}/history

Daily time series of On Hive scores and cost for one network. This history is proprietary — accumulated daily and not reconstructable from raw data providers. Optional ?days= (default 30, max 365).

curl
curl "https://onhive.xyz/api/v1/networks/Solana/history?days=90" \
  -H "x-api-key: ohive_your_key_here"
json
{
  "network": "Solana",
  "days": 90,
  "count": 90,
  "data": [
    {
      "institutional_grade_score": 78,
      "cost_efficiency_score": 99,
      "reliability_score": 96,
      "median_tx_cost_usd": 0.00025,
      "tps_current": 2100,
      "uptime_30d": 98.5,
      "recorded_at": "2026-04-06T08:00:00Z"
    }
  ]
}
GET/api/v1/stablecoins/{symbol}/history

Daily time series of peg, market cap, and On Hive stability scores for one stablecoin — track how a peg or reserve-quality score has trended over time. Optional ?days= (default 30, max 365).

curl
curl "https://onhive.xyz/api/v1/stablecoins/USDC/history?days=90" \
  -H "x-api-key: ohive_your_key_here"
json
{
  "symbol": "USDC",
  "days": 90,
  "count": 90,
  "data": [
    {
      "market_cap_usd": 43500000000,
      "price": 1.0001,
      "peg_deviation_percent": 0.01,
      "peg_stability_score": 98,
      "reserve_quality_score": 95,
      "momentum_score": 72,
      "velocity_score": 68,
      "recorded_at": "2026-04-06T08:00:00Z"
    }
  ]
}

Code Examples

JavaScript / TypeScript

typescript
const res = await fetch('https://onhive.xyz/api/v1/networks', {
  headers: { 'x-api-key': process.env.ONHIVE_API_KEY! },
});
const { data } = await res.json();
const topNetwork = data[0];
console.log(topNetwork.network, topNetwork.institutional_grade_score);

Python

python
import requests

resp = requests.get(
    'https://onhive.xyz/api/v1/stablecoins',
    headers={'x-api-key': 'ohive_your_key_here'}
)
stablecoins = resp.json()['data']
for coin in stablecoins:
    print(coin['symbol'], coin['peg_deviation_percent'])

Error Codes

200OKRequest succeeded.
401UnauthorizedMissing or invalid x-api-key header.
403ForbiddenKey is valid but the account is not Pro.
500Internal Server ErrorDatabase error. Retry after a few seconds.

Changelog

v1.1newJuly 2026
  • · Added GET /api/v1/networks/{network}/history — daily score and cost time series
  • · Added GET /api/v1/stablecoins/{symbol}/history — daily peg and stability time series
  • · Both accept ?days= (default 30, max 365)
v1.0initialJune 2026
  • · Launched API with GET /api/v1/networks and GET /api/v1/stablecoins
  • · Authentication via x-api-key header, scoped to Pro accounts
  • · Returns latest daily snapshot for all 20 networks and 16 stablecoins
  • · Full CORS support for browser and server-side usage