Skip to main content
Glama

MarketTrace agent-feed

get_market_state

Read-only

Single normalized perpetual-futures microstructure snapshot for one crypto symbol, aggregated across Binance, Bybit, OKX and Hyperliquid. Answers: "What's the market state for BTC?", "Is ETH positioning stretched?". Covers BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC, ENA. Returns funding+2y-percentile, OI, volume, CVD aggression, order-book imbalance, recent liquidation pressure, basis, and key drivers. Scales: _ratio fields are 0..1, percentiles are 0-100, rel. are multipliers of the trailing median (1.4 = 140%), obi.skew is -1..+1 (positive = bid-heavy), cvd.delta_usd positive = net taker buying, basis_bps positive = perp above spot index. Every metric carries a coverage entry (venues, window depth, partial reason) — weight confidence by it. Read-only, ~30s fresh. Use first for market context; for the historical base rate of a condition you observe here (e.g. funding percentile ≥ 90), follow with get_conditional_outcomes. For volume-profile levels (POC, value area, naked POCs) use get_volume_profile; for large aggressive orders use get_big_trades. For absorbed or pulled order-book walls use get_footprint_events. For stacked buy or sell imbalances in the footprint use get_stacked_imbalances.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
symbolYesAsset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted, e.g. `BTCUSDT`).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
oiYes
cvdYes
liqYes
obiYes
feedYesServer self-description: compare `feed.tools` with the tools you can call — fewer on your side means a stale connector catalog (reconnect).
as_ofYesAssembly wall-time, RFC3339 UTC.
depthYes
priceYes
symbolYesUppercase asset symbol, e.g. `BTC`.
venuesYes
volumeYes
driversYesFact-strings for fields that have data; no verdict.
fundingYes
calendarYes
coverageYes
basis_bpsNoPerp-vs-spot basis in bps: POSITIVE = perp trades ABOVE the spot index ((mark − index) / index × 1e4).
age_secondsYesWorst-case age (seconds) across the live sources that fed the non-null live fields.
stale_venuesYesVenues currently degraded / dropped from consensus this cycle.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.