BULK Alpha API: Public Market Intelligence & Wallet Tracking

The BULK Alpha API (https://alpha-api.builtonbulk.xyz) is a public, unauthenticated intelligence layer for BULK Exchange — live trade firehose, wallet rankings, account tracking, market context, risk surfaces, regime, and liquidation impact curves. No API key, no wallet, no auth.

It is arguably the most complete public data surface on BULK Exchange available outside the protocol’s own docs, and it is what powers the BULK Alpha Dashboard and the @BulkIntelBot Telegram alerts. This guide documents what it exposes today.

Getting Started

All data is served over HTTP from https://alpha-api.builtonbulk.xyz. No API key, no sign-up, no wallet connection — it reads public BULK Exchange market data (per docs.bulk.trade) and republishes it as analytics.

Endpoints in use today:

• GET /api/candles?symbol=<SYMBOL> — OHLC candles computed from the live fill stream
• GET /api/signals/correlation-breaks?threshold=<value> — correlation break detector
• GET /api/market-context/regimes — per-symbol regime state on a volatility-intensity scale
• GET /api/health — per-stream liveness
• Plus the ranked-wallet and account-metrics endpoints that drive the leaderboard and wallet tables

Underlying BULK endpoints consumed (public): exchange-api.bulk.trade REST, wss://exchange-ws1.bulk.trade, via trades.{symbol}, account.{pubkey}, frontendContext, risk.{symbol}, ticker.{symbol}.

The Three Tiers

Tier 0 — Discovery: trade firehose & wallet ranking

Every trade on every listed market, with liquidation/ADL fills flagged, ranked by rolling notional volume. This is the “who is actually moving size” view.

Tier 1 — Deep monitoring: account stream

Batch-subscribed account.{pubkey} updates for the top wallets: live positions, margin, PnL, liquidation price, and an event log of fills/liquidations/ADL/order updates. This powers smart-money scores (realized PnL / volume) and the cascade map.

Tier 2 — Market context

All-symbol OI / funding / volume, per-market risk surfaces (mmr + correlations), and per-market regime. Combined into cascade-zone computation — joining tracked wallets’ liquidation prices against each market’s price-impact curve to estimate which liquidations would set off more liquidations.

Data Notes & Verified Corrections

The Alpha Engine was built live against real traffic and corrected several inaccuracies in earlier vendor SDKs:

• Account message envelope — the real discriminator is data.type (accountSnapshot, marginUpdate, positionUpdate, fill, liquidation, adl, orderUpdate), not the outer envelope.
• Margin field names — live snapshots use totalMargin / availableMargin, not totalBalance / availableBalance.
• Trade event shape — data.trades[] with side boolean + reason / liq flags for liquidations/ADL.

These are the kind of details that only surface by running against real traffic, and they’re already baked into the API’s output.

The Alpha Dashboard

The dashboard (https://alpha.builtonbulk.xyz) is the visualization layer on top of this API: correlation chord diagram, liquidation cascade map, wallet rank table with time-range picker, an OHLC chart with regime tint and lq/adl markers, and a live engine-health badge. It polls the API every 10–60s per chart — deliberately not WS-pushed, because a human reading a dashboard can’t perceive that latency on these signals.

Integration Partners & Tooling

This API already powers:

• @BulkIntelBot — liquidation alerts, smart-money follows, and the 6-hour market pulse
• Alpha Dashboard — correlation, cascade map, wallet rankings, regime-chart

Related Reading

• BULK Intel Bot (@BulkIntelBot)
• BULK Exchange Mainnet Launch & Genesis Phase
• BULK Smart-Money & Wallet Analysis
• BULK SDK Guide
• State of Solana Perps 2026

Pair live order-flow with a pre-mainnet AURA position → early.bulk.trade/deposit