Market Risk
by Omni Terminal in Markets & finance
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.
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
Reliability
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=currentParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
event_window_minutes | integer | No | Recent enriched-news horizon joined to the liquidation summary. One of: 15, 60. Default: 60. |
limit | integer | No | Maximum rows retained in each bounded component. Default: 5. |
scope | string | No | 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 --decodeJavaScript: 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
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 2 h ago | Expected HTTP 402, got 400 | 400 | 291 ms | - |
| 8 h ago | Expected HTTP 402, got 400 | 400 | 270 ms | - |
| 13 h ago | Expected HTTP 402, got 400 | 400 | 224 ms | - |
| 19 h ago | Expected HTTP 402, got 400 | 400 | 272 ms | - |
| 25 h ago | Expected HTTP 402, got 400 | 400 | 267 ms | - |
Show 10 older checks
| 31 h ago | Expected HTTP 402, got 400 | 400 | 242 ms | - |
| 36 h ago | Expected HTTP 402, got 400 | 400 | 281 ms | - |
| 42 h ago | Expected HTTP 402, got 400 | 400 | 282 ms | - |
| 47 h ago | Expected HTTP 402, got 400 | 400 | 228 ms | - |
| 2 days ago | Expected HTTP 402, got 400 | 400 | 357 ms | - |
| 2 days ago | Expected HTTP 402, got 400 | 400 | 292 ms | - |
| 3 days ago | Expected HTTP 402, got 400 | 400 | 304 ms | - |
| 3 days ago | Expected HTTP 402, got 400 | 400 | 96 ms | - |
| 3 days ago | Expected HTTP 402, got 400 | 400 | 296 ms | - |
| 3 days ago | Expected HTTP 402, got 400 | 400 | 364 ms | - |