BTC$64,678.00▼ 0.27%ETH$1,817.69▲ 0.28%USDT$0.9993▼ 0.04%BNB$591.04▼ 0.37%USDC$0.9996▼ 0.01%XRP$0.9550▼ 0.64%SOL$71.64▲ 0.12%TRX$0.3051▲ 0.61%FIGR_HELOC$1.04▼ 1.70%HYPE$69.05▲ 3.49%ZEC$904.04▲ 1.51%XMR$493.69▼ 0.53%DOGE$0.0589▼ 0.33%LEO$9.21▲ 0.54%USDS$0.9999▲ 0.01%WBT$62.51▼ 0.33%LINK$9.11▼ 0.63%ADA$0.1523▼ 0.31%XLM$0.1373▼ 1.51%USDE$0.9993▼ 0.03%DAI$1.0000▲ 0.02%RAIN$0.006105▲ 76.24%BCH$207.82▼ 0.46%NEAR$3.13▼ 0.52%LTC$44.46▼ 1.11%CC$0.0818▼ 3.33%AVAX$7.09▼ 1.35%UNI$5.13▲ 0.49%XAUT$3,838.62▼ 0.56%USD1$0.9984▼ 0.01%GRAM$1.04▼ 1.77%SUI$0.7160▼ 1.30%RLUSD$1.0000▲ 0.00%USDG$0.9999▲ 0.01%HBAR$0.0569▼ 3.08%PYUSD$0.9999▲ 0.01%USDY$1.15▼ 0.01%SHIB$0.000004▼ 1.72%CRO$0.0431▲ 0.36%TAO$190.82▼ 0.38%BTC$64,678.00▼ 0.27%ETH$1,817.69▲ 0.28%USDT$0.9993▼ 0.04%BNB$591.04▼ 0.37%USDC$0.9996▼ 0.01%XRP$0.9550▼ 0.64%SOL$71.64▲ 0.12%TRX$0.3051▲ 0.61%FIGR_HELOC$1.04▼ 1.70%HYPE$69.05▲ 3.49%ZEC$904.04▲ 1.51%XMR$493.69▼ 0.53%DOGE$0.0589▼ 0.33%LEO$9.21▲ 0.54%USDS$0.9999▲ 0.01%WBT$62.51▼ 0.33%LINK$9.11▼ 0.63%ADA$0.1523▼ 0.31%XLM$0.1373▼ 1.51%USDE$0.9993▼ 0.03%DAI$1.0000▲ 0.02%RAIN$0.006105▲ 76.24%BCH$207.82▼ 0.46%NEAR$3.13▼ 0.52%LTC$44.46▼ 1.11%CC$0.0818▼ 3.33%AVAX$7.09▼ 1.35%UNI$5.13▲ 0.49%XAUT$3,838.62▼ 0.56%USD1$0.9984▼ 0.01%GRAM$1.04▼ 1.77%SUI$0.7160▼ 1.30%RLUSD$1.0000▲ 0.00%USDG$0.9999▲ 0.01%HBAR$0.0569▼ 3.08%PYUSD$0.9999▲ 0.01%USDY$1.15▼ 0.01%SHIB$0.000004▼ 1.72%CRO$0.0431▲ 0.36%TAO$190.82▼ 0.38%

Developer API

Programmatic access to the same measured data the site runs on. Key-based, scoped, rate-limited — currently in preview while plans are finalized.

Endpoints
4
Auth
API key
Status
Preview

Authentication

Every request carries your key in the X-API-Key header. Keys are scoped — a key minted for prices cannot read patterns — and rate-limited per minute according to plan. Keys are issued by the Heriux team during the preview; request one through the contact page.

# every request carries your key
curl https://heriux.com/api/v1/public/prices/crypto/bitcoin \\
  -H "X-API-Key: YOUR_KEY"

Endpoints

GET/api/v1/public/prices/{category}/{slug}pricesLatest price, 24h change, volume and market cap for one asset, with its freshness classification.
GET/api/v1/public/ohlcv/{category}/{slug}?timeframe=1d&limit=100ohlcvStored candles (1h / 4h / 1d), up to 500 per request.
GET/api/v1/public/score/{category}/{slug}scoreHeriux Market Score with full component breakdown and algorithm version.
GET/api/v1/public/patterns?category=crypto&timeframe=4HpatternsQuality-gated confirmed chart patterns with backtested statistics.

Errors and limits

{ "error": { "code": "...", "message": "..." } }

Every error uses one shape: { "error": { "code": "...", "message": "..." } }. Missing key → 401 missing_api_key; wrong scope → 403 insufficient_scope; over budget → 429 rate_limited. Usage is metered per endpoint per day and visible to us both — the future billing model will be built on those meters, not on surprises.

Data honesty

The API serves exactly what the site serves: freshness-labeled prices, statistics with sample sizes and baselines, patterns only after the quality gate. Nothing in this API is investment advice.