Get Crypto Metrics Screener Time Range

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/crypto/screener/metrics/timerange \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "date": "2024-01-01",
      "items": [
        {
          "metric": "MARKET_CAP",
          "snapshot_time": 1705276800,
          "symbol": "BTC",
          "value": 100000000
        }
      ]
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Crypto

Get Crypto Metrics Screener Time Range

OpenAPI JSON Spec Retrieve tokens filtered by metrics over a time range. Returns tokens matching the specified metric type and value range, grouped by date.

Overview: This endpoint filters tokens based on various metrics over a specified time range. Results are grouped by date (YYYY-MM-DD format).

Valuation Metrics (2 metrics):

MARKET_CAP: Market Capitalization
FDV: Fully Diluted Valuation

Volume Metrics (1 metric):

SHARES_VOLUME: Trading volume (shares)

Price Change Metrics (9 metrics):

PRICE_CHANGE_1D: Price change over 1 day (percentage)
PRICE_CHANGE_1W: Price change over 1 week (percentage)
PRICE_CHANGE_1M: Price change over 1 month (percentage)
PRICE_CHANGE_3M: Price change over 3 months (percentage)
PRICE_CHANGE_6M: Price change over 6 months (percentage)
PRICE_CHANGE_YTD: Price change year-to-date (percentage)
PRICE_CHANGE_1Y: Price change over 1 year (percentage)
PRICE_CHANGE_3Y: Price change over 3 years (percentage)
PRICE_CHANGE_5Y: Price change over 5 years (percentage)

Moving Averages - Simple Moving Average (MA) (6 metrics):

MA_5: 5-day Simple Moving Average
MA_10: 10-day Simple Moving Average
MA_20: 20-day Simple Moving Average
MA_60: 60-day Simple Moving Average
MA_120: 120-day Simple Moving Average
MA_200: 200-day Simple Moving Average

Moving Averages - Exponential Moving Average (EMA) (6 metrics):

EMA_5: 5-day Exponential Moving Average
EMA_10: 10-day Exponential Moving Average
EMA_20: 20-day Exponential Moving Average
EMA_60: 60-day Exponential Moving Average
EMA_120: 120-day Exponential Moving Average
EMA_200: 200-day Exponential Moving Average

Momentum Indicators (1 metric):

RSI_14: Relative Strength Index (14-period) - Momentum oscillator that measures speed and magnitude of price changes (typically ranges from 0 to 100)

MACD (Moving Average Convergence Divergence) Components (3 metrics):

MACD_DIF: MACD Line (DIF) - Difference between 12-day EMA and 26-day EMA
MACD_DEA: Signal Line (DEA) - 9-day EMA of the MACD line
MACD_HIST: MACD Histogram - Difference between MACD line and signal line

Bollinger Bands Components (3 metrics):

BOLLINGER_UPPER: Upper Bollinger Band - Upper band of Bollinger Bands (20-day MA + 2 standard deviations)
BOLLINGER_MID: Middle Bollinger Band - 20-day Simple Moving Average
BOLLINGER_LOWER: Lower Bollinger Band - Lower band of Bollinger Bands (20-day MA - 2 standard deviations)

Other Indicators (4 metrics):

BETA: Beta - Measure of token’s volatility relative to the crypto market. Beta of 1 means token moves with market
VOLATILITY_20: Volatility (20-period) - Standard deviation of returns over 20 periods (annualized)
VOLATILITY_60: Volatility (60-period) - Standard deviation of returns over 60 periods (annualized)
VOLATILITY_90: Volatility (90-period) - Standard deviation of returns over 90 periods (annualized)

Filtering:

Use range_min to filter for tokens where the metric value is greater than or equal to the minimum
Use range_max to filter for tokens where the metric value is less than or equal to the maximum
Both filters can be used together to create a range
If neither filter is provided, all tokens matching the metric type will be returned

Limit Parameter:

Use limit to further limit the maximum number of results returned per day (optional, defaults to no limit)
This is useful for pagination or when you only need the top N results per day

Response Format: Returns an array of date-grouped data items. Each item contains a date (YYYY-MM-DD format) and an array of tokens with their symbol, snapshot time (ISO 8601 format), metric type, and metric value for that date.

GET

crypto

screener

metrics

timerange

Get Crypto Metrics Screener Time Range

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/crypto/screener/metrics/timerange \
  --header 'X-API-Key: <api-key>'

{
  "data": [
    {
      "date": "2024-01-01",
      "items": [
        {
          "metric": "MARKET_CAP",
          "snapshot_time": 1705276800,
          "symbol": "BTC",
          "value": 100000000
        }
      ]
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key

string

header

required

API Key authentication. Example: "your-api-key-here"

Query Parameters

start_time

integer

required

Start time (Unix timestamp in seconds, UTC)

end_time

integer

required

End time (Unix timestamp in seconds, UTC)

metric_type

string

required

Metric type. See description for valid values.

range_min

number<float64>

Minimum value filter (optional). Returns only tokens where metric value >= range_min

range_max

number<float64>

Maximum value filter (optional). Returns only tokens where metric value <= range_max

order_by

string

Sort order (optional). Valid values: ASC (ascending), DESC (descending). Defaults to DESC

limit

integer

Maximum number of results per day (optional, defaults to no limit)

Response

Successfully retrieved crypto metrics screener time range data

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get Crypto Metrics Screener Get Token Supply History