Skip to main content
GET
/
v1
/
market
/
token-metrics
Token Metrics
curl --request GET \
  --url https://api.asksurf.ai/surf-ai/v1/market/token-metrics \
  --header 'Authorization: <api-key>'
{
  "data": {
    "metrics": [
      {
        "chain": "<string>",
        "metric_id": "<string>",
        "timestamp": "<string>",
        "value": 123
      }
    ],
    "symbol": "<string>"
  },
  "error_code": "FORBIDDEN",
  "message": "success",
  "success": true
}

​
Overview

The Token Metrics API returns a single coalesced metric series in data.metrics for a given symbol.

​
Coalesce order

  • active_addresses_daily
  • transaction_count
  • tokenholders
  • transaction_volume
  • Fallback: turnover_rate
A response may include many timestamps, but only one metric_id series should appear in data.metrics.

​
How to use

1

Provide symbol

Set symbol (required), for example BTC or ETH.
2

Read selected series

Use metrics[0].metric_id to identify which metric was selected by coalesce logic.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
symbol
string
required

Bithumb symbol (e.g. BTC, ETH)

Response

OK

​
data
object
​
error_code
string
Example:

"FORBIDDEN"

​
message
string
Example:

"success"

​
success
boolean
Example:

true