{
  "x402Version": 2,
  "id": 1447,
  "slug": "1447",
  "resource": "https://omniterminal.app/api/x402/v1/market-risk/:symbol",
  "description": "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.",
  "type": "http",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:84532",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
      "amount": "10000",
      "maxTimeoutSeconds": 300
    },
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x733f40A4FA0cd13d59aBADE04b9eD2e9acAc6457",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "pathParams": {
            "symbol": "BTC"
          },
          "queryParams": {
            "event_window_minutes": 60,
            "limit": 5,
            "scope": "current"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "data_as_of": "2026-07-15T12:00:00.000Z",
            "freshness": {
              "age_seconds": 0,
              "component_statuses": [
                "fresh",
                "fresh"
              ],
              "data_as_of": "2026-07-15T12:00:00.000Z",
              "max_age_seconds": 300,
              "status": "fresh"
            },
            "funding": {
              "canonical_symbol": "hyperliquid:BTC:USDC:perp",
              "carry": {
                "annualization_method": "simple_current_hourly_rate_x_8760",
                "funding_annualized_pct": 10.95,
                "funding_apr_pct": 10.95,
                "funding_direction": "longs_pay_shorts",
                "funding_rate_1d": 0.0003,
                "funding_rate_8h": 0.0001,
                "funding_rate_per_hour": 0.0000125,
                "premium": -0.0002979165,
                "projection_basis": "current_hourly_rate_mechanical_projection",
                "settlement_interval": "1h"
              },
              "data_as_of": "2026-07-28T11:59:55.000Z",
              "dex": "main",
              "freshness": {
                "age_seconds": 5,
                "data_as_of": "2026-07-28T11:59:55.000Z",
                "max_age_seconds": 120,
                "status": "fresh"
              },
              "generated_at": "2026-07-28T12:00:00.000Z",
              "market_type": "perp",
              "positioning": {
                "day_base_volume": 35060.91552,
                "day_notional_volume_usd": 2255876954.93,
                "open_interest_base": 36639.5983,
                "open_interest_usd": 2324264117.62
              },
              "prices": {
                "mark": 63440.5,
                "mark_oracle_basis_bps": 0,
                "midpoint": 63440.5,
                "oracle": 63440.5,
                "previous_day": 65087,
                "price_change_24h_pct": -2.5297
              },
              "product_version": "v1",
              "quote": "USDC",
              "schema": "hyperliquid_market_carry.v1",
              "service": "omni.hyperliquid_market_carry",
              "symbol": "BTC",
              "usage": {
                "current_snapshot_only": true,
                "historical_series_included": false
              },
              "venue": "hyperliquid"
            },
            "generated_at": "2026-07-15T12:00:00.000Z",
            "liquidations": {
              "data_as_of": 1784116800000,
              "freshness": {
                "age_seconds": 0,
                "data_as_of": "2026-07-15T12:00:00.000Z",
                "max_age_seconds": 300,
                "status": "fresh"
              },
              "generated_at": "2026-07-15T12:00:00.000Z",
              "levels": {
                "available_buy_count": 2,
                "available_sell_count": 2,
                "buy": [
                  {
                    "absolute_distance_from_reference_pct": 3.902439,
                    "distance_from_reference_bps": -390.2439,
                    "distance_from_reference_pct": -3.902439,
                    "distance_from_reference_usd": -4000,
                    "liquidation_flow": "sell",
                    "liquidation_price": 98500,
                    "position_count": 18,
                    "position_side": "long",
                    "reference_price": 102500,
                    "reference_price_source": "hyperliquid_mark_px",
                    "relative_to_reference": "below",
                    "size": 120.5,
                    "value": 12350000
                  },
                  {
                    "absolute_distance_from_reference_pct": 5.121951,
                    "distance_from_reference_bps": -512.1951,
                    "distance_from_reference_pct": -5.121951,
                    "distance_from_reference_usd": -5250,
                    "liquidation_flow": "sell",
                    "liquidation_price": 97250,
                    "position_count": 14,
                    "position_side": "long",
                    "reference_price": 102500,
                    "reference_price_source": "hyperliquid_mark_px",
                    "relative_to_reference": "below",
                    "size": 88.25,
                    "value": 9045625
                  }
                ],
                "complete": true,
                "order": "strongest",
                "published_buy_count": 2,
                "published_sell_count": 2,
                "sell": [
                  {
                    "absolute_distance_from_reference_pct": 4.390244,
                    "distance_from_reference_bps": 439.0244,
                    "distance_from_reference_pct": 4.390244,
                    "distance_from_reference_usd": 4500,
                    "liquidation_flow": "buy",
                    "liquidation_price": 107000,
                    "position_count": 11,
                    "position_side": "short",
                    "reference_price": 102500,
                    "reference_price_source": "hyperliquid_mark_px",
                    "relative_to_reference": "above",
                    "size": 95.25,
                    "value": 9763125
                  },
                  {
                    "absolute_distance_from_reference_pct": 6.829268,
                    "distance_from_reference_bps": 682.9268,
                    "distance_from_reference_pct": 6.829268,
                    "distance_from_reference_usd": 7000,
                    "liquidation_flow": "buy",
                    "liquidation_price": 109500,
                    "position_count": 8,
                    "position_side": "short",
                    "reference_price": 102500,
                    "reference_price_source": "hyperliquid_mark_px",
                    "relative_to_reference": "above",
                    "size": 76.5,
                    "value": 7841250
                  }
                ],
                "side_meaning": {
                  "buy": "legacy_key_for_long_position_liquidation_levels",
                  "sell": "legacy_key_for_short_position_liquidation_levels"
                },
                "side_semantics": {
                  "buy": {
                    "liquidation_flow": "sell",
                    "position_side": "long"
                  },
                  "sell": {
                    "liquidation_flow": "buy",
                    "position_side": "short"
                  }
                }
              },
              "margin_stress": {
                "interpretation": "Public market liquidation exposure estimate; not an account margin requirement or liquidation guarantee.",
                "method": "liquidation_buckets_crossed_from_reference_price",
                "reference_price": 102500,
                "reference_price_source": "hyperliquid_mark_px",
                "scenarios": [
                  {
                    "crossed_bucket_count": 18,
                    "estimated_liquidation_notional_usd": 21395625,
                    "estimated_liquidation_size": 208.75,
                    "estimated_position_count": 32,
                    "liquidated_side": "long",
                    "move_pct": -5,
                    "target_price": 97375
                  },
                  {
                    "crossed_bucket_count": 9,
                    "estimated_liquidation_notional_usd": 9763125,
                    "estimated_liquidation_size": 95.25,
                    "estimated_position_count": 11,
                    "liquidated_side": "short",
                    "move_pct": 5,
                    "target_price": 107625
                  }
                ],
                "trigger_basis": "hyperliquid_mark_price"
              },
              "market_reference": {
                "mark": 102500,
                "midpoint": 102510,
                "oracle": 102480,
                "price": 102500,
                "source": "hyperliquid_mark_px",
                "trigger_basis": "hyperliquid_mark_price"
              },
              "product_version": "v1",
              "schema": "hyperliquid_liquidation_map.v1",
              "scope": "current",
              "service": "omni.hyperliquid_liquidation_map",
              "summary": {
                "buy_lvwap_by_value": 86100,
                "legacy_liquidation_distribution_mid_proxy": 101250,
                "positions_with_liquidation_price": 24410,
                "reference_price": 102500,
                "reference_price_source": "hyperliquid_mark_px",
                "sell_lvwap_by_value": 119400,
                "total_positions": 27875,
                "total_size": 15240.25,
                "total_value": 1562125625
              },
              "symbol": "BTC",
              "usage": {
                "item_limit": 20,
                "published_level_count": 4,
                "published_levels_complete": true
              },
              "view": "clusters"
            },
            "news": {
              "data_as_of": "2026-07-15T12:00:00.000Z",
              "freshness": {
                "age_seconds": 0,
                "data_as_of": "2026-07-15T12:00:00.000Z",
                "max_age_seconds": 7200,
                "status": "fresh"
              },
              "generated_at": "2026-07-15T12:00:00.000Z",
              "items": [
                {
                  "analysis": {
                    "model": "omni-news-model",
                    "prompt_version": "public-v1",
                    "schema_version": "public-v1",
                    "validation_status": "validated"
                  },
                  "analysis_type": "news_pulse",
                  "confidence": 0.84,
                  "direction": "neutral",
                  "headline": "BTC market update: liquidity and volatility remain in focus",
                  "id": "example_market_update_001",
                  "impact": "medium",
                  "importance": 0.72,
                  "sentiment": 0.08,
                  "summary": "Representative compact result showing the fields returned after a successful x402 settlement.",
                  "theme": "market_update",
                  "tickers": [
                    "BTC"
                  ],
                  "timestamp": 1784116800000,
                  "topics": [
                    "market_structure",
                    "macro"
                  ]
                }
              ],
              "market": "crypto",
              "market_context": {
                "cadence_minutes": 15,
                "confidence": 0.81,
                "direction": "BULLISH",
                "generated_at": "2026-07-15T11:45:00.000Z",
                "notable_tickers": [
                  "BTC",
                  "ETH",
                  "HYPE"
                ],
                "object": "market_context.v1",
                "sentiment_rating": 2,
                "source_window_hours": 24,
                "summary": "Liquidity is constructive across majors, while macro sensitivity keeps positioning selective.",
                "timeline": [],
                "topics": [
                  "market_structure",
                  "macro"
                ]
              },
              "product_version": "v1",
              "schema": "news_pulse.v1",
              "service": "omni.ai_news_pulse",
              "symbol": "BTC",
              "usage": {
                "event_window_minutes": 60,
                "from_timestamp": null,
                "item_count": 1,
                "lookback_hours": 24,
                "mode": "latest",
                "nearest_timestamp": null,
                "offset": 0,
                "order": "recent",
                "requested_date": null,
                "selection_mode": "latest",
                "to_timestamp": null
              }
            },
            "product_version": "v1",
            "schema": "market_risk_snapshot.v1",
            "scope": "current",
            "service": "omni.market_risk_snapshot",
            "symbol": "BTC"
          },
          "type": "json"
        }
      },
      "routeTemplate": "/api/x402/v1/market-risk/:symbol",
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "pathParams": {
                "properties": {
                  "symbol": {
                    "description": "Allowlisted market symbol, for example BTC",
                    "type": "string"
                  }
                },
                "required": [
                  "symbol"
                ],
                "type": "object"
              },
              "queryParams": {
                "properties": {
                  "event_window_minutes": {
                    "default": 60,
                    "description": "Recent enriched-news horizon joined to the liquidation summary.",
                    "enum": [
                      15,
                      60
                    ],
                    "type": "integer"
                  },
                  "limit": {
                    "default": 5,
                    "description": "Maximum rows retained in each bounded component.",
                    "maximum": 10,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "scope": {
                    "default": "current",
                    "enum": [
                      "current",
                      "aggregate"
                    ],
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    },
    "builder-code": {
      "info": {
        "a": "bc_wttcxbb6"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar",
    "builder-code"
  ],
  "sourceHost": "omniterminal.app",
  "lastUpdated": "2026-09-18T01:37:39.135Z",
  "quality": {
    "calls30d": 42,
    "uniquePayers30d": 6,
    "lastCalledAt": "2026-09-18T01:37:38.374Z"
  },
  "liveness": {},
  "verified": false,
  "featured": false,
  "provider": {
    "host": "omniterminal.app",
    "manifest_name": "omniterminal.app",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-09-18T22:00:31.484Z"
  }
}