16trust / 100

Market Risk

by Omni Terminal in Markets & finance

x402 APIFailing, checked 2 h ago

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.

GET
https://omniterminal.app/api/x402/v1/market-risk/:symbol
Price
$0.01
per call in USDC
Uptime
0.0%
last 30 days
Response time
-
no timed checks yet
Last check
Failed
2 h ago, next any minute now

Run a free test callHow to call it

Reliability

All checks passedSome failedAll failedNot checked

Latest check failed 2 h ago: Expected HTTP 402, got 400

Status and outage history · Atom feed · Watch with other listings

How to call it

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

Each call costs $0.01 in USDC on Base Sepolia, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

GET https://omniterminal.app/api/x402/v1/market-risk/:symbol?event_window_minutes=60&limit=5&scope=current

Parameters

ParameterTypeRequiredDescription
event_window_minutesintegerNoRecent enriched-news horizon joined to the liquidation summary. One of: 15, 60. Default: 60.
limitintegerNoMaximum rows retained in each bounded component. Default: 5.
scopestringNo One of: current, aggregate. Default: "current".

Example response

The provider's example. We can't check it without paying.

Example response, 297 lines
{
  "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"
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.01.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://omniterminal.app/api/x402/v1/market-risk/:symbol?event_window_minutes=60&limit=5&scope=current'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://omniterminal.app/api/x402/v1/market-risk/:symbol?event_window_minutes=60&limit=5&scope=current' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fomniterminal.app%2Fapi%2Fx402%2Fv1%2Fmarket-risk%2F%3Asymbol
const res = await pay("https://omniterminal.app/api/x402/v1/market-risk/:symbol?event_window_minutes=60&limit=5&scope=current");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://omniterminal.app/api/x402/v1/market-risk/:symbol?event_window_minutes=60&limit=5&scope=current")
    print(res.status_code, res.text)

Security scan

No findings

We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
2 h agoExpected HTTP 402, got 400400291 ms-
8 h agoExpected HTTP 402, got 400400270 ms-
13 h agoExpected HTTP 402, got 400400224 ms-
19 h agoExpected HTTP 402, got 400400272 ms-
25 h agoExpected HTTP 402, got 400400267 ms-
Show 10 older checks
31 h agoExpected HTTP 402, got 400400242 ms-
36 h agoExpected HTTP 402, got 400400281 ms-
42 h agoExpected HTTP 402, got 400400282 ms-
47 h agoExpected HTTP 402, got 400400228 ms-
2 days agoExpected HTTP 402, got 400400357 ms-
2 days agoExpected HTTP 402, got 400400292 ms-
3 days agoExpected HTTP 402, got 400400304 ms-
3 days agoExpected HTTP 402, got 40040096 ms-
3 days agoExpected HTTP 402, got 400400296 ms-
3 days agoExpected HTTP 402, got 400400364 ms-