OUTRUN

API

ABOUT

Machine-friendly crypto state queries paid via Lightning micropayments.

  • RESOLUTION: 20 seconds
  • HISTORY: 10 days

GET API KEY

Paid Tier (Pay-to-Mint)
10 sats per query. No expiry.
1. ORDER: POST /key/buy { "amount": 1000 }
2. PAY: Pay the Lightning Invoice (bolt11).
3. CLAIM: GET /key/claim/:orderId

Free Endpoint: GET /j/price is open (limited to 10 req/min/IP).
Test Keys: Reach out on Reddit or Nostr for a starter key.

WEBSOCKETS (Real-Time)

Stream full market state every 20 seconds. Cost: 1 sat/min.

  • Connect: ws://<host>/j/stream
  • Auth: Send { "action": "auth", "key": "YOUR_KEY" }
  • Data: Receives full JSON array of all assets.

CRYPTO

Price Consensus (FREE)

Get sanitized multi-source average price (Latest or Historical).

  • symbol (str): Asset (e.g. BTC)
  • time (ISO, opt): Historical timestamp
GET /j/price?symbol=BTC

Threshold Check

Verify if a price condition held true for a specific duration.

  • symbol (str): Asset (e.g. BTC)
  • price (num): Threshold price
  • window (int): Time window in minutes (e.g. 60)
  • condition (str): 'gt' (>) or 'lt' (<)
  • time (ISO, opt): Historical end time
GET /j/threshold?symbol=BTC&price=90000&window=60&condition=gt

Volatility

Calculate standard deviation of price for a rolling window.

  • symbol (str): Asset (e.g. BTC)
  • window (int): Time window in minutes (e.g. 60)
  • time (ISO, opt): Historical end time
GET /j/volatility?symbol=BTC&window=60

Wick Detect

Detect flash crashes or pumps (High/Low spread) in a window.

  • symbol (str): Asset (e.g. BTC)
  • percent (num): Movement threshold %
  • window (int): Time window in minutes (e.g. 1440)
  • time (ISO, opt): Historical end time
GET /j/wick?symbol=BTC&percent=5&window=1440

Correlation

Calculate Pearson correlation (r) between two assets.

  • symbolA (str): Asset A (e.g. BTC)
  • symbolB (str): Asset B (e.g. ETH)
  • window (int): Time window in minutes (e.g. 1440)
GET /j/correlation?symbolA=BTC&symbolB=ETH&window=1440

Volume Anomaly

Compare current 1h volume vs 10-day baseline.
(Note: XMR, MNT, TAO use a 24h-avg estimate).

  • symbol (str): Asset (e.g. SOL)
GET /j/volume?symbol=SOL

Hashrate Curtailment Risk

Real-time correlation of weather conditions in 30 major mining hubs with potential hashrate drops.

  • code (str, opt): Specific Location Code (e.g. TX_RDL)
GET /j/weather
GET /j/weather?code=TX_RDL

WATCHLIST

Assets

BTC ETH XRP BNB SOL TRX DOGE ADA BCH LINK XMR* LTC AVAX SUI HBAR ZEC SHIB TON DOT UNI MNT* TAO* AAVE XLM HYPE XAUT TRUMP ENA ASTER PEPE

* Volume estimated via 24h avg.

Weather Locations

TX: Rockdale (TX_RDL), Odessa (TX_ODS), Midland (TX_MID), Dickens (TX_DIC), Temple (TX_TMP), Vernon (TX_VER)
East/TVA: Dalton (GA_DLT), Sandersville (GA_SND), Paducah (KY_PAD), Calvert City (KY_CAL), Dresden (NY_DRE), Plattsburgh (NY_PLA), Massena (NY_MAS), Wenatchee (WA_WEN)
QC: Baie-Comeau (QC_BAI), Sherbrooke (QC_SHE), Farnham (QC_FAR)
Nordic: Reykjanesbær (IS_REY), Blönduós (IS_BLO), Boden (SE_BOD)
LatAm: Villarrica (PY_VIL), Hernandarias (PY_HER), Yguazú (PY_YGU), Rio Grande (AR_RIO)
Eurasia: Bratsk (RU_BRA), Irkutsk (RU_IRK), Ekibastuz (KZ_EKI), Pavlodar (KZ_PAV), Trongsa (BT_TRO), Gelephu (BT_GEL)