Wallet-graph intelligence as an API

ORANGE GENIE ORACLE

Real-time conviction scores per token, aggregated from dozens of proprietary signals across CEXs, DEXs, derivatives, on-chain flows, and a labeled wallet network we grow ourselves. Subscribe once. Query freely.

What it is

Orange Genie Oracle answers one question — for any token, right now: what is the on-chain wallet network doing, and is it bullish or bearish?

You get a single number per token, between −1 and +1, with direction and a confluence breakdown. Behind the scalar: a multi-class signal engine, a labeled wallet network we grow ourselves, and macro context. The score is what you trade. The recipe is ours.

What we are not. Not a trading signal service. Not financial advice. This is on-chain analytics — same category as Nansen, Arkham, Glassnode — packaged as a clean REST API.

Tiers

Free

$0/mo

Get a feel for the oracle.

BTC, ETH, SOL only
10 requests/min
No paid tokens
No wallet lookups
No signal stream

No signup

Trader

$29/mo

For active traders.

All 23 tokens (BTC, ETH, SOL, memes, alts)
100 requests/min
50 wallet fingerprint lookups/day
Signal stream access
Confluence class breakdown
No chain stats

Pro

$99/mo

For desks + power users.

Everything in Trader
1,000 requests/min
500 wallet lookups/day
Webhook subscriptions on threshold crossings
Chain stats API
Full confluence breakdown by class

Fund

$499/mo

Institutional use.

Everything in Pro
10,000 requests/min
5,000 wallet lookups/day
Custom watchlists
Dedicated Telegram channel
SLA + email support

Endpoints

Base URL: https://orangegenie-api-production.up.railway.app

Auth: send your key in the x-api-key header (or ?key= query param).

GET /api/v1/oracle/{token}

Current oracle score for a token. Returns direction, conviction, signal count, confluence class breakdown, and macro multiplier.

Free: BTC, ETH, SOL Trader+: all 23 tokens

curl -H "x-api-key: og_t_..." \
  https://orangegenie-api-production.up.railway.app/api/v1/oracle/PEPE

{
  "token": "PEPE",
  "oracle": 0.94,
  "direction": "LONG",
  "raw_signal": 0.94,
  "macro_mult": 1.0,
  "decision": "AUTO_FIRE",
  "signal_count": 11,
  "confluence": ["wallet_graph", "cex_flow", "derivatives"],
  "ts": 1778480750,
  "ts_iso": "2026-05-11T06:25:50Z",
  "tier": "trader"
}

GET /api/v1/wallet/{address}

Behavioral fingerprint of any tracked wallet: activity rhythm, token diet, hold horizon, cluster classification.

Trader: 50/day Pro: 500/day Fund: 5,000/day

curl -H "x-api-key: og_p_..." \
  https://orangegenie-api-production.up.railway.app/api/v1/wallet/0xd8da6bf26964af9d7eed9e03e53415d37aa96045

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "chain": "eth",
  "rhythm_entropy": 2.681,
  "median_amount_usd": 30.15,
  "token_diet": { "unique": 11, "meme": 11, ... },
  "median_hold_seconds": null,
  "funder": "unknown",
  "clusters": [
    { "cluster": "smart_retail", "match_score": 0.62, "status": "PROVISIONAL" }
  ],
  "tier": "pro"
}

GET /api/v1/signals/recent

Last 100 oracle signals across all tokens. Real-time stream of every conviction reading.

Trader+ only

curl -H "x-api-key: og_t_..." \
  "https://orangegenie-api-production.up.railway.app/api/v1/signals/recent?limit=20"

GET /api/v1/chain/stats

Labeled-wallet network growth: total fingerprinted wallets, cluster distribution, 24h signal volume.

Pro+ only

How the oracle thinks

The oracle compounds conviction across dozens of signals spanning five classes. Multiple signals confirming the same direction stack multiplicatively — single-source noise is weighted low; confluence is rewarded.

Wallet graph ProprietaryOur edge — labels grow daily

Derivatives Funding · OI · options skewWhere size positions

CEX flow Exchange in/out · stablecoin mintsBuy fuel landing

On-chain TVL · bridge · staking flowsCapital rotation

Macro + sentiment F&G · NFT · listings · unlocksRegime context

Specific signal weights, source lists, and the wallet-graph composition are proprietary. Subscribers see the score, direction, and confluence breakdown — not the recipe.

Getting started

1. Try the free tier

curl https://orangegenie-api-production.up.railway.app/api/v1/oracle/BTC

2. Subscribe

Subscribe at orangegenie.bot/subscribe. After payment verifies, your API key is revealed once on the success page. Save it.

3. Use your key

curl -H "x-api-key: YOUR_KEY" \
  https://orangegenie-api-production.up.railway.app/api/v1/oracle/PEPE

4. Or just try it in Telegram

Join our Telegram and type /oracle BTC in the group. Free tier of the same oracle, no signup needed.

Rate limits + errors

Code	Meaning	What to do
200	OK	—
401	Invalid or revoked API key	Check the key. Get a new one from your dashboard.
403	Tier-locked endpoint/token	Upgrade. Free tier is BTC/ETH/SOL only.
404	No recent reading	The oracle hasn't seen a signal in the last hour for this token.
429	Rate-limited	Wait, or upgrade tier.