Developer

API Access

Programmatic access to the HEVEA Genius signals feed. Available on the INSTITUTIONAL plan — integrate our on-chain signals directly into your portfolio system or dashboard.

Get INSTITUTIONAL access → Contact us

Authentication

Authentication — Bearer TokenINSTITUTIONAL

# Include your API key in every request header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Endpoints

GET/api/v1/signals/latestLatest published signals

// Query parameters
tier=hodl|pulse|nexus    // Filter by signal tier
asset=btc|xau|eth     // Filter by asset
limit=10            // Number of results (max 100)

GET/api/v1/signals/{id}Single signal by ID

GET/api/v1/indicators/liveLive indicator readings

POST/api/v1/webhooksRegister webhook endpoint

Example Response

GET /api/v1/signals/latest?tier=pulse&limit=1

{

  « id »: « hg_pulse_20240315_001 »,

  « tier »: « PULSE »,

  « asset »: « BTC/USD »,

  « direction »: « LONG »,

  « entry_zone »: { « low »: 82000, « high »: 85000 },

  « stop_loss »: 76000,

  « targets »: { « tp1 »: 94000, « tp2 »: 108000, « tp3 »: 128000 },

  « conviction »: { « score »: 6, « max »: 7, « level »: « HIGH » },

  « validity_hours »: 72,

  « published_at »: « 2024-03-15T08:00:00Z »,

  « blockchain_tx »: « bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh »,

  « status »: « OPEN »

}

Rate Limits

1,000 requests/hour per API key. Webhook delivery for real-time signal events with no polling required.

Uptime SLA

99.9% uptime SLA for API endpoints. Status available at heveagenius.io/status.

Support

Dedicated technical support for Institutional API users. Priority response within 2 hours during trading hours.

Also explore

🏛Institutional PlanFull features for funds & family offices 📚DocumentationPlatform guides and onboarding 🔒SecurityBlockchain verification architecture

Public API — Live Data

HGX Score API

Loading HGX Score…

GET /wp-json/hg/v1/public/score

Returns HGX composite score, components, BTC price and cycle phase. Rate-limited to 60 requests/hour per IP. No API key required.

{

  "hgx_score": 58,

  "label": "Neutral",

  "components": { "sentiment": 42, "performance": 76, "cycle": 78, "momentum": 40 },

  "btc_price_usd": 84200,

  "cycle_phase": "Accumulation",

  "rate_remaining": 59,

  "rate_limit": 60,

  "api_version": "1.0"

}

GET /hg-feed.xml RSS 2.0

Intelligence Feed — HGX updates, cycle position, HODL macro signal summaries. Compatible with any RSS reader or aggregator.

Subscribe RSS → JSON Feed →

GET /wp-json/hg/v1/transparency

Full transparency report — all-time signal stats, monthly breakdown, win rate. No authentication required.

View full report →