Omni Terminal

Omni Terminal assesses one Hyperliquid market before entering, sizing, or reducing a position using all published mark-anchored liquidation levels, explicit flow direction, margin stress, current funding/carry, and enriched AI news.

Resource: omniterminal.app/api/x402/v1/market-risk/:symbol

Network: eip155:84532, eip155:8453 · Asset: 0x036CbD53842c5426634e7929541eC2318f3dCF7e · Pay to: 0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457

Payment methods: — · Last validation: 2026-09-14 12:11:14.398+00

{
  "input": {
    "type": "http",
    "method": "GET",
    "pathParams": {
      "symbol": "BTC"
    },
    "queryParams": {
      "limit": 5,
      "scope": "current",
      "event_window_minutes": 60
    }
  },
  "output": {
    "type": "json",
    "example": {
      "news": {
        "items": [
          {
            "id": "example_market_update_001",
            "theme": "market_update",
            "impact": "medium",
            "topics": [
              "market_structure",
              "macro"
            ],
            "summary": "Representative compact result showing the fields returned after a successful x402 settlement.",
            "tickers": [
              "BTC"
            ],
            "analysis": {
              "model": "omni-news-model",
              "prompt_version": "public-v1",
              "schema_version": "public-v1",
              "validation_status": "validated"
            },
            "headline": "BTC market update: liquidity and volatility remain in focus",
            "direction": "neutral",
            "sentiment": 0.08,
            "timestamp": 1784116800000,
            "confidence": 0.84,
            "importance": 0.72,
            "analysis_type": "news_pulse"
          }
        ],
        "usage": {
          "mode": "latest",
          "order": "recent",
          "offset": 0,
          "item_count": 1,
          "to_timestamp": null,
          "from_timestamp": null,
          "lookback_hours": 24,
          "requested_date": null,
          "selection_mode": "latest",
          "nearest_timestamp": null,
          "event_window_minutes": 60
        },
        "market": "crypto",
        "schema": "news_pulse.v1",
        "symbol": "BTC",
        "service": "omni.ai_news_pulse",
        "freshness": {
          "status": "fresh",
          "data_as_of": "2026-07-15T12:00:00.000Z",
          "age_seconds": 0,
          "max_age_seconds": 7200
        },
        "data_as_of": "2026-07-15T12:00:00.000Z",
        "generated_at": "2026-07-15T12:00:00.000Z",
        "market_context": {
          "object": "market_context.v1",
          "topics": [
            "market_structure",
            "macro"
          ],
          "summary": "Liquidity is constructive across majors, while macro sensitivity keeps positioning selective.",
          "timeline": [],
          "direction": "BULLISH",
          "confidence": 0.81,
          "generated_at": "2026-07-15T11:45:00.000Z",
          "cadence_minutes": 15,
          "notable_tickers": [
            "BTC",
            "ETH",
            "HYPE"
          ],
          "sentiment_rating": 2,
          "source_window_hours": 24
        },
        "product_version": "v1"
      },
      "scope": "current",
      "schema": "market_risk_snapshot.v1",
      "symbol": "BTC",
      "funding": {
        "dex": "main",
        "carry": {
          "premium": -0.0002979165,
          "funding_apr_pct": 10.95,
          "funding_rate_1d": 0.0003,
          "funding_rate_8h": 0.0001,
          "projection_basis": "current_hourly_rate_mechanical_projection",
          "funding_direction": "longs_pay_shorts",
          "settlement_interval": "1h",
          "annualization_method": "simple_current_hourly_rate_x_8760",
          "funding_rate_per_hour": 0.0000125,
          "funding_annualized_pct": 10.95
        },
        "quote": "USDC",
        "usage": {
          "current_snapshot_only": true,
          "historical_series_included": false
        },
        "venue": "hyperliquid",
        "prices": {
          "mark": 63440.5,
          "oracle": 63440.5,
          "midpoint": 63440.5,
          "previous_day": 65087,
          "price_change_24h_pct": -2.5297,
          "mark_oracle_basis_bps": 0
        },
        "schema": "hyperliquid_market_carry.v1",
        "symbol": "BTC",
        "service": "omni.hyperliquid_market_carry",
        "freshness": {
          "status": "fresh",
          "data_as_of": "2026-07-28T11:59:55.000Z",
          "age_seconds": 5,
          "max_age_seconds": 120
        },
        "data_as_of": "2026-07-28T11:59:55.000Z",
        "market_type": "perp",
        "positioning": {
          "day_base_volume": 35060.91552,
          "open_interest_usd": 2324264117.62,
          "open_interest_base": 36639.5983,
          "day_notional_volume_usd": 2255876954.93
        },
        "generated_at": "2026-07-28T12:00:00.000Z",
        "product_version": "v1",
        "canonical_symbol": "hyperliquid:BTC:USDC:perp"
      },
      "service": "omni.market_risk_snapshot",
      "freshness": {
        "status": "fresh",
        "data_as_of": "2026-07-15T12:00:00.000Z",
        "age_seconds": 0,
        "max_age_seconds": 300,
        "component_statuses": [
          "fresh",
          "fresh"
        ]
      },
      "data_as_of": "2026-07-15T12:00:00.000Z",
      "generated_at": "2026-07-15T12:00:00.000Z",
      "liquidations": {
        "view": "clusters",
        "scope": "current",
        "usage": {
          "item_limit": 20,
          "published_level_count": 4,
          "published_levels_complete": true
        },
        "levels": {
          "buy": [
            {
              "size": 120.5,
              "value": 12350000,
              "position_side": "long",
              "position_count": 18,
              "reference_price": 102500,
              "liquidation_flow": "sell",
              "liquidation_price": 98500,
              "relative_to_reference": "below",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": -390.2439,
              "distance_from_reference_pct": -3.902439,
              "distance_from_reference_usd": -4000,
              "absolute_distance_from_reference_pct": 3.902439
            },
            {
              "size": 88.25,
              "value": 9045625,
              "position_side": "long",
              "position_count": 14,
              "reference_price": 102500,
              "liquidation_flow": "sell",
              "liquidation_price": 97250,
              "relative_to_reference": "below",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": -512.1951,
              "distance_from_reference_pct": -5.121951,
              "distance_from_reference_usd": -5250,
              "absolute_distance_from_reference_pct": 5.121951
            }
          ],
          "sell": [
            {
              "size": 95.25,
              "value": 9763125,
              "position_side": "short",
              "position_count": 11,
              "reference_price": 102500,
              "liquidation_flow": "buy",
              "liquidation_price": 107000,
              "relative_to_reference": "above",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": 439.0244,
              "distance_from_reference_pct": 4.390244,
              "distance_from_reference_usd": 4500,
              "absolute_distance_from_reference_pct": 4.390244
            },
            {
              "size": 76.5,
              "value": 7841250,
              "position_side": "short",
              "position_count": 8,
              "reference_price": 102500,
              "liquidation_flow": "buy",
              "liquidation_price": 109500,
              "relative_to_reference": "above",
              "reference_price_source": "hyperliquid_mark_px",
              "distance_from_reference_bps": 682.9268,
              "distance_from_reference_pct": 6.829268,
              "distance_from_reference_usd": 7000,
              "absolute_distance_from_reference_pct": 6.829268
            }
          ],
          "order": "strongest",
          "complete": true,
          "side_meaning": {
            "buy": "legacy_key_for_long_position_liquidation_levels",
            "sell": "legacy_key_for_short_position_liquidation_levels"
          },
          "side_semantics": {
            "buy": {
              "position_side": "long",
              "liquidation_flow": "sell"
            },
            "sell": {
              "position_side": "short",
              "liquidation_flow": "buy"
            }
          },
          "available_buy_count": 2,
          "published_buy_count": 2,
          "available_sell_count": 2,
          "published_sell_count": 2
        },
        "schema": "hyperliquid_liquidation_map.v1",
        "symbol": "BTC",
        "service": "omni.hyperliquid_liquidation_map",
        "summary": {
          "total_size": 15240.25,
          "total_value": 1562125625,
          "reference_price": 102500,
          "total_positions": 27875,
          "buy_lvwap_by_value": 86100,
          "sell_lvwap_by_value": 119400,
          "reference_price_source": "hyperliquid_mark_px",
          "positions_with_liquidation_price": 24410,
          "legacy_liquidation_distribution_mid_proxy": 101250
        },
        "freshness": {
          "status": "fresh",
          "data_as_of": "2026-07-15T12:00:00.000Z",
          "age_seconds": 0,
          "max_age_seconds": 300
        },
        "data_as_of": 1784116800000,
        "generated_at": "2026-07-15T12:00:00.000Z",
        "margin_stress": {
          "method": "liquidation_buckets_crossed_from_reference_price",
          "scenarios": [
            {
              "move_pct": -5,
              "target_price": 97375,
              "liquidated_side": "long",
              "crossed_bucket_count": 18,
              "estimated_position_count": 32,
              "estimated_liquidation_size": 208.75,
              "estimated_liquidation_notional_usd": 21395625
            },
            {
              "move_pct": 5,
              "target_price": 107625,
              "liquidated_side": "short",
              "crossed_bucket_count": 9,
              "estimated_position_count": 11,
              "estimated_liquidation_size": 95.25,
              "estimated_liquidation_notional_usd": 9763125
            }
          ],
          "trigger_basis": "hyperliquid_mark_price",
          "interpretation": "Public market liquidation exposure estimate; not an account margin requirement or liquidation guarantee.",
          "reference_price": 102500,
          "reference_price_source": "hyperliquid_mark_px"
        },
        "product_version": "v1",
        "market_reference": {
          "mark": 102500,
          "price": 102500,
          "oracle": 102480,
          "source": "hyperliquid_mark_px",
          "midpoint": 102510,
          "trigger_basis": "hyperliquid_mark_price"
        }
      },
      "product_version": "v1"
    }
  },
  "paymentRequirements": [
    {
      "raw": {
        "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
        "extra": {
          "name": "USDC",
          "version": "2"
        },
        "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
        "amount": "10000",
        "scheme": "exact",
        "network": "eip155:84532",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "scheme": "exact",
      "network": "eip155:84532",
      "amountAtomic": "10000"
    },
    {
      "raw": {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
        "amount": "10000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 300
      },
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "scheme": "exact",
      "network": "eip155:8453",
      "amountAtomic": "10000"
    }
  ]
}

Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.