API Documentation

Access Buildix data programmatically. All endpoints return JSON with CORS enabled.

Base URL

https://www.buildix.trade/api/v1

GET/api/v1/screener

All Hyperliquid pairs with price, volume, funding, OI.

{
  "count": 311,
  "data": [
    {
      "symbol": "BTC",
      "price": 68957.0,
      "change24h": -2.35,
      "volume24h": 1282780165,
      "openInterest": 1802345000,
      "funding": -0.0000132,
      "fundingAnnualized": -1.45
    }
  ],
  "timestamp": 1711108800000
}

GET/api/v1/pair/{symbol}

Detailed data for a single pair (e.g. /api/v1/pair/BTC).

{
  "symbol": "BTC",
  "price": 68957.0,
  "change24h": -2.35,
  "volume24h": 1282780165,
  "openInterest": 1802345000,
  "funding": -0.0000132,
  "fundingAnnualized": -1.45,
  "markPrice": 68957.0,
  "oraclePrice": 68960.5,
  "maxLeverage": 50,
  "deepViewUrl": "https://www.buildix.trade/pair/BTC"
}

GET/api/v1/liquidation-mapWHALE

On-chain liquidation clusters with cascade simulation. Query params: symbol (required), exchange (optional, default hyperliquid), price_range_pct (optional, 1-20, default 10), scenarios (optional, CSV of integers 1-50, default 5,10,15 — generates symmetric down/up entries for each value).

curl -H "x-api-key: bx_xxx" \
  "https://www.buildix.trade/api/v1/liquidation-map?symbol=BTC&scenarios=5,10,15"

{
  "symbol": "BTC",
  "exchange": "hyperliquid",
  "timestamp": 1761177600,
  "current_price": 68957.0,
  "price_range_pct": 10,
  "clusters": [
    {
      "price": 67572.1,
      "side": "long",
      "estimated_liquidation_size_usd": 225293125,
      "cumulative_size_usd": 225293125,
      "distance_pct": -1.33
    }
  ],
  "cascade_scenarios": [
    { "move_pct": -15, "price_target": 58613.45, "side_triggered": "long",  "liquidations_triggered_usd": 1080000000, "clusters_count": 4 },
    { "move_pct": -10, "price_target": 62061.30, "side_triggered": "long",  "liquidations_triggered_usd":  900000000, "clusters_count": 3 },
    { "move_pct":  -5, "price_target": 65509.15, "side_triggered": "long",  "liquidations_triggered_usd":  540000000, "clusters_count": 2 },
    { "move_pct":   5, "price_target": 72404.85, "side_triggered": "short", "liquidations_triggered_usd":  540000000, "clusters_count": 2 },
    { "move_pct":  10, "price_target": 75852.70, "side_triggered": "short", "liquidations_triggered_usd":  900000000, "clusters_count": 3 },
    { "move_pct":  15, "price_target": 79300.55, "side_triggered": "short", "liquidations_triggered_usd": 1080000000, "clusters_count": 4 }
  ]
}

GET/api/v1/docs

This documentation as JSON (machine-readable).

MCP/api/mcpAI agents

Model Context Protocol server for AI agents (Claude, ChatGPT, Cursor). Five read-only tools: screener, pair, signals, smart money, liquidation map. Anonymous access at free-tier limits. Connection snippet & full docs →

Rate Limits

Free

100/day

Pro ($39/mo)

5K/day

Whale ($79/mo)

50K/day

Authentication

Currently open access with IP-based rate limits. API key authentication coming soon. Generate your key at Account Settings.

Questions? Contact hello@buildix.trade