Skip to main content
Glama

MarketTrace agent-feed

get_volume_profile

Read-only

Volume-profile reference levels for a symbol, from the consolidated trade tape of Binance, Bybit, OKX and Hyperliquid. Answers: "Where are the key volume levels on BTC?", "Is price inside yesterday's value area?", "Any untested POCs nearby?". Sessions are UTC days. poc = price row with the most traded volume; vah/val = top and bottom of the value area, the band around the POC that holds 70% of the session's volume. Returns today (the session still forming, developing:true, its levels still move), days (the last N complete days, days 1..=30, default 7, oldest first), composite (one profile over those days plus today) and naked_pocs (POCs of the last 30 complete days that price has not traded back to since). Per profile: poc/vah/val in USD (lower edge of a bucket-wide price row), va_width_pct = (vah − val) / poc × 100, volume in BASE units (BTC, ETH, ...), taker_buy_ratio 0..1 (share of volume that was aggressive buying). va_width_rank.percentile (0-100) ranks the latest complete day's va_width_pct among the last n_days complete days: low = an unusually tight day; null below 12 days. Levels only, no histogram. For where price sits against these levels read price.last from get_market_state. ZEC and ENA were added later, so fewer days come back for them: count what is returned and read coverage. Read-only.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysNoComplete UTC days to return, 1..=30 (default 7). Out of range is an error, not a clamp.
symbolYesAsset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted).

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
daysYesThe last N complete UTC days that have data, oldest first.
as_ofYesCoverage time of today's session, RFC3339 UTC (build time when today is `null`).
todayNoToday's developing session; `null` when it could not be served.
bucketYesPrice-row width, USD.
symbolYesUppercase asset symbol, e.g. `BTC`.
coverageYes
compositeYes
naked_pocsYesAscending by date.
va_width_rankYes
naked_lookback_daysYesComplete days actually checked for naked POCs (≤ 30).

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.