Skip to main content
GET
/
gateway
/
v1
/
market
/
onchain-indicator
On-Chain Indicator
curl --request GET \
  --url https://api.ask.surf/gateway/v1/market/onchain-indicator
{
  "data": [
    {
      "timestamp": 123,
      "value": 123,
      "metric": "<string>",
      "symbol": "<string>"
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

Query Parameters

​
symbol
enum<string>
required

Token ticker symbol. Can be BTC or ETH.

Available options:
BTC,
ETH
Example:

"BTC"

​
metric
enum<string>
required

On-chain metric name. Can be nupl, sopr, mvrv, puell-multiple, nvm, nvt, nvt-golden-cross, or exchange-flows/{inflow,outflow,netflow,reserve}.

Available options:
nupl,
sopr,
mvrv,
puell-multiple,
nvm,
nvt,
nvt-golden-cross,
exchange-flows/inflow,
exchange-flows/outflow,
exchange-flows/netflow,
exchange-flows/reserve
Example:

"nupl"

​
granularity
enum<string>
default:day

Aggregation granularity.

Available options:
day
Example:

"day"

​
from
string

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Defaults to 90 days ago when omitted. Maximum range is 365 days.

Example:

"2026-01-01"

​
to
string

End of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Defaults to today when omitted. Maximum range is 365 days.

Example:

"2026-03-01"

​
exchange
enum<string>
default:all_exchange

Exchange filter (only applies to exchange-flow metrics). Can be all_exchange, spot_exchange, derivative_exchange, binance, bybit, kraken, or okx.

Available options:
all_exchange,
spot_exchange,
derivative_exchange,
binance,
bybit,
kraken,
okx
Example:

"all_exchange"

Response

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/SimpleListResponseMarketMetricPoint.json"