FOCSAL API · Phase 1

Programmatic access to crypto market intelligence

Multi-venue normalized data. Pre-computed analytics. Complete trade plans from our 5-engine Intelligence model. The same engines that power FOCSAL OS — exposed as a clean API.

LIVE · Phase 1 ready for launch
0
Layers
0
REST endpoints
0
WebSocket channels
0+
Assets
01 · What you actually get

Not data. Interpretation.

CoinGlass and Laevitas sell raw market data. FOCSAL sells understanding. Every metric arrives with statistical context, and Layer 4 generates complete trade plans you can act on directly.

📊

Context, not just numbers

Every metric returns with percentile_30d, z_score, and interpretation. No more guessing if 0.01% funding is high or low.

Multi-venue normalized

One API for Binance, Bybit, Deribit, OKX, Hyperliquid. Funding, OI, liquidations, basis — aggregated consistently across all five exchanges.

🎯

Complete trade plans

Layer 4 outputs full plans: entry zones, stops, targets, sizing hints, invalidation conditions — generated by a 5-engine ensemble model. Nothing comparable exists.

02 · Architecture

Four layers, clean segmentation

Each layer addresses a distinct domain without mixing concerns. Pro unlocks the base. Enterprise unlocks the full stack.

L4
Intelligence
L3
Options
L2
Analytics
+ WebSocket
L1
Futures Foundation
REST · multi-venue

Build from the ground up

Start with Layer 1 on Pro tier — multi-venue normalized futures data with percentile context. Upgrade to Enterprise to unlock the full pyramid.

  • L1 Futures Foundation — Funding, OI, liquidations, basis, OHLCV, positioning, volume-flow across 5 exchanges.
  • L2 Futures Analytics — Liquidation maps (4 modes), liquidity walls, orderbook, footprint, CVD + WebSocket.
  • L3 Options Analytics — Chain with greeks, IV surface, term structure, smile, skew, GEX. BTC/ETH/SOL/XRP.
  • L4 Intelligence — Complete trade plans from 5-engine MI model. Unique to FOCSAL.
03 · Layer-by-layer

Pick your level of depth

From basic multi-venue data to fully algorithmic trade plans. Each layer is a thin façade on top of existing FOCSAL OS engines.

Layer 01 · Foundation

Multi-venue futures data

Pro Enterprise

Funding rates, open interest, liquidations, basis, OHLCV — normalized across Binance, Bybit, Deribit, OKX, and Hyperliquid. Every metric arrives with percentile_30d, z_score, and plain-English interpretation. 65 assets covered.

  • GET/v1/markets/funding
  • GET/v1/markets/open-interest
  • GET/v1/markets/liquidations
  • GET/v1/markets/basis · ohlcv · positioning · volume-flow
Response — markets/funding
{
  "asset": "BTC",
  "aggregate": {
    "value": 0.0089,
    "percentile_30d": 0.78,
    "z_score": 1.45,
    "interpretation": "elevated"
  },
  "venues": {
    "binance": 0.0092,
    "bybit": 0.0085
  }
}
Layer 02 · Analytics

Order flow & liquidation maps

Enterprise + WebSocket

Pre-computed liquidation maps in 4 rendering modes. Multi-venue depth aggregated liquidity walls. Order flow footprint with bid/ask volume per level, absorption events, liquidity sweeps. CVD comparative, delta volume, OI clusters. Plus 5 WebSocket channels.

  • GET/v1/futures/liquidation-map
  • GET/v1/futures/liquidity-walls
  • GET/v1/futures/orderflow/footprint
  • WSliquidations · orderbook · liquidation-map · walls · footprint
WebSocket — liquidations.BTC
{
  "channel": "liquidations.BTC",
  "ts": "2026-05-17T20:14:33Z",
  "data": {
    "side": "long",
    "amount_usd": 5240000,
    "price": 67120,
    "exchange": "binance"
  }
}
// Push within 200ms of exchange event
Layer 03 · Options

Complete options analytics

Enterprise + WebSocket

Full chain with Black-Scholes greeks per strike. 3D volatility surface, term structure, smile per expiry, IV/RV spread. 25-delta skew, butterfly, risk reversal. GEX index, signed by strike, all expirations. Max pain, probability above strike. BTC, ETH, SOL, XRP on Deribit.

  • GET/v1/options/chain · instruments · market-map
  • GET/v1/options/volatility · skew · gamma · activity
  • WSoptions.gamma · volatility · activity
Response — options/gamma
{
  "asset": "BTC",
  "net_gex": "negative",
  "gamma_flip": 65200,
  "max_pain": 64000,
  "critical_strikes": [
    { "strike": 70000, "type": "resistance" },
    { "strike": 60000, "type": "support" }
  ]
}
★ UNIQUE
Layer 04 · Intelligence

Complete trade plans

Enterprise ★ Unique to FOCSAL

5-engine ensemble (structure 0.33 · indicator 0.24 · options 0.24 · liquidity 0.14 · COT 0.05) produces complete trade plans: entry zones, stop loss with structural reason, primary & secondary targets, risk-reward, sizing hint, invalidation conditions. Plus options multi-leg strategy generation. Educational material.

  • GET/v1/intel/futures/{asset}?tf=4h
  • GET/v1/intel/options/{asset}?expiry=7MAY26
  • WSintel.futures · intel.options · regime-change
Response — intel/futures/BTC?tf=4h
{
  "verdict": "LEAN_UP",
  "execution": {
    "bias": "UP",
    "confidence": 0.74,
    "quality_grade": "B"
  },
  "trade_plan": {
    "side": "long",
    "entry_low": 67200,
    "entry_high": 67800,
    "stop": 65500,
    "target_primary": 70200,
    "risk_reward": 1.84
  }
}
04 · The killer feature

Layer 4 is what makes FOCSAL different

CoinGlass and Laevitas sell data. FOCSAL sells plans. A 5-engine ensemble produces complete, evaluatable trade plans — entry zones, stops, targets, sizing hints, invalidation conditions. Nothing comparable exists on the market.

How the engine thinks

Five independent sub-engines analyze the market through different lenses. Each produces its own bias and confidence. The final verdict is a weighted blend — and quality grade A-F further filters high-conviction setups from noise.

structure
0.33
Break of Structure, Change of Character, pivots
indicator
0.24
SMA, ADX, funding extremes, OI delta
options
0.24
GEX regime, gamma flip, max pain, P/C skew
liquidity
0.14
Densest cluster, wall asymmetry
cot
0.05
CFTC Asset Manager / Leveraged Funds positioning

Important: confidence: 0.74 means the model is 74% confident the current market state aligns with the bias — not 74% probability of profit.

GET /v1/intel/futures/BTC?tf=4h 200 OK
{
  "asset": "BTC",
  "timeframe": "4h",
  "spot": 67340,
  "snapshot_ts": "2026-05-17T11:58:00Z",
  "freshness": "fresh",

  "verdict": "LEAN_UP",
  "aligned_timeframes": ["1h", "4h", "1d"],

  "execution": {
    "bias": "UP",
    "confidence": 0.74,
    "quality_grade": "B",
    "rationale": [
      "BOS bullish at 67200 on 4h",
      "SMA20 above SMA50, ADX 28"
    ]
  },

  "trade_plan": {
    "side": "long",
    "entry_low": 67200,
    "entry_high": 67800,
    "stop": 65500,
    "stop_reason": "below liquidity wall",
    "target_primary": 70200,
    "target_secondary": 72500,
    "risk_reward": 1.84,
    "sizing_hint": "half",
    "invalidation_notes": [
      "funding flip below 0",
      "OI unwind below 65000"
    ]
  },

  "disclaimer": {
    "summary": "Educational. Not investment advice."
  }
}
05 · Get started

Your first call in 5 minutes

Subscribe, get your key in email, copy code below, you're calling production. No setup fees, no separate API plan to buy.

1

Subscribe

Choose Pro or Enterprise

2

Get your key

Emailed within 30 seconds

3

Make first call

Use X-API-Key header

4

Monitor usage

Track in app.focsal.com/account/api

# Get BTC funding rate aggregated across 5 exchanges
curl -H "X-API-Key: fk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://api.focsal.com/v1/markets/funding?asset=BTC&aggregate=true"
import requests

resp = requests.get(
    "https://api.focsal.com/v1/markets/funding",
    headers={"X-API-Key": "fk_live_xxx..."},
    params={"asset": "BTC", "aggregate": True}
)
data = resp.json()
print(data["aggregate"]["interpretation"])
# => "elevated"
const resp = await fetch(
  "https://api.focsal.com/v1/markets/funding?asset=BTC&aggregate=true",
  {headers: {"X-API-Key": "fk_live_xxx..."}}
);
const data = await resp.json();
console.log(data.aggregate.interpretation);
// => "elevated"
# Enterprise tier — WebSocket subscription
import websockets, asyncio, json

async def consume():
    uri = "wss://api.focsal.com/v1/ws?api_key=fk_live_xxx"
    async with websockets.connect(uri) as ws:
        await ws.send(json.dumps({
            "op": "subscribe",
            "channel": "intel.futures.BTC.4h"
        }))
        async for msg in ws:
            print(json.loads(msg))

asyncio.run(consume())

Full documentation at docs.focsal.com

06 · What you get

Pro for solo developers. Enterprise for quant teams.

API access is included in Pro and Enterprise plans — no separate purchase.

Solo dev
Pro

REST polling, multi-venue normalized data. Perfect for solo developers building futures bots on 2-3 assets.

Daily quota25,000 calls
Monthly quota750,000 calls
Rate limit40 req/min
API keysUp to 3
  • Layer 1 — all 7 Foundation endpoints
  • Multi-venue normalized (5 exchanges)
  • Percentile context on every metric
  • 65 assets (HOT 15 + COLD 50)
  • 90-day usage log retention
  • WebSocket subscriptions
  • Layer 2 — Analytics
  • Layer 3 — Options
  • Layer 4 — Intelligence
Start with Pro →
Full stack
Enterprise

Full stack — REST + WebSocket across all 4 layers. For quant teams, options traders, and funds running multi-strategy workflows.

Daily quota200,000 calls
Monthly quota6,000,000 calls
Rate limit300 req/min
API keysUp to 10
  • Layer 1 — all 7 Foundation endpoints
  • Layer 2 — 6 REST + 5 WebSocket
  • Layer 3 — 7 REST + 3 WebSocket
  • Layer 4 — Intelligence trade plans
  • Unlimited WebSocket subscriptions
  • BTC/ETH/SOL/XRP options on Deribit
  • 365-day usage log retention
  • Priority support + Slack channel
Subscribe to Enterprise →

Quota scope: Daily and monthly quotas are per-account (shared across all your API keys). Rate limit is per-key. Limits subject to adjustment based on launch data — existing customers receive 30-day notice of changes.

07 · Asset coverage

What's covered

Five exchanges normalized into one consistent API. 65 futures assets, full options stack on Deribit.

Futures — 65 assets

5 exchanges · multi-venue normalized
Binance
Bybit
Deribit
OKX
Hyperliquid
HOT
15
Top liquidity · 60s refresh · MI 5-min
COLD
50
5-min refresh · MI 30-min

Options — 4 assets

Deribit · liquidity concentration
  • BTC Full
  • ETH Full
  • SOL Partial
  • XRP Partial

Crypto options liquidity is overwhelmingly concentrated on Deribit BTC and ETH. SOL and XRP have some expiries unavailable — response includes a coverage flag.

08 · Read before using

What FOCSAL is not

Three principles every user must accept before relying on Layer 4 trade plans.

Pillar 01

Educational only

All materials, analyses, signals, and trade plans are educational and analytical in nature. They do not constitute investment advice or recommendations under MiFID II or the Polish Act of 29 July 2005 on Trading in Financial Instruments.

Pillar 02

Risk warning

Cryptocurrency markets are extremely volatile. Trading involves substantial risk of capital loss. Trading with leverage multiplies this risk. Invest only funds whose potential loss you can accept without significant financial harm.

Pillar 03

DYOR

Conduct your own market analysis (DYOR — Do Your Own Research) before any investment decision. Verify FOCSAL outputs against other sources. Consider consulting a licensed financial adviser. You are responsible for your trading decisions.

09 · FAQ

Common questions

No. API access is included in Pro and Enterprise tiers of FOCSAL — no separate API plan, no add-on charge. When you subscribe, your API key is auto-generated and emailed to you within 30 seconds of payment.
FOCSAL provides data and analytical outputs (including trade plans). It does not place orders on exchanges. You build your execution layer using your broker's API (Binance, Bybit, Deribit, etc). FOCSAL is the brain; you build the hands.
Daily and monthly quotas are per-account — all your keys share the same pool (Pro: 25k/day total, Enterprise: 200k/day total). Rate limit is per-key — each key has its own counter. This protects you from key compromise while preventing quota gaming through extra keys.
Confidence measures how well the current market state matches the algorithmic model's pattern recognition. It says "this is a clear setup according to our model" — not "this trade will profit". Profitability also depends on risk management, execution, slippage, fees, and what happens in the future after the snapshot.
MI snapshots refresh every 5 minutes for HOT 15 assets and every 30 minutes for COLD 50. The API caches responses for 60 seconds. Every Layer 4 response includes snapshot_ts, staleness_seconds, and freshness flag (fresh / stale / very_stale). Polling faster than the cadence returns the same data.
Enterprise → Pro: keys remain valid, but Layer 2/3/4 endpoints return HTTP 403 and WebSocket connections terminate. Pro → Plus or Free: all keys are revoked. In both cases you have 30 days to export usage logs and historical data.
CoinGlass and Laevitas sell market data — funding rates, GEX, options chains. FOCSAL also includes these, but the key differentiator is Layer 4 (Intelligence) which generates complete trade plans with entry zones, stops, targets, and sizing hints from a 5-engine ensemble model. No competitor offers this. The liquidation map (4 rendering modes) and order flow footprint via API are also unique.
No. FOCSAL is a SaaS analytics platform, not a financial institution. We are not registered as an investment adviser, broker-dealer, or commodity trading advisor in any jurisdiction. Our outputs are educational and analytical, not regulated financial advice. See the disclaimer above for details.
10 · What's next

The roadmap

Phase 1 ships first. Subsequent phases extend coverage based on customer demand. Subscribers receive announcements as features ship.

SHIPPING
Phase 01 · Now

Foundation & Intelligence

  • 22 REST endpoints across 4 layers
  • 12 WebSocket channels
  • Auto-activation after Stripe payment
  • Full Mintlify documentation
  • Better Stack status page
Phase 03 · Later

Research-grade additions

  • Historical analogs lookup
  • Vol cone (IV percentile vs DTE)
  • Macro overlays (WALCL, DXY, H41)
  • Multi-source sentiment aggregation
  • Extended asset coverage beyond 65
Ready when you are

Start in five minutes.

Subscribe to Pro or Enterprise. Your API key arrives within 30 seconds. First call takes minutes, not days. No setup fees, no add-on tiers.

22 endpoints · 12 channels · ready for production