Finding assets and metrics

Two endpoints answer “what can I ask for?”, and they’re the fastest way to explore the API.

Step 1: Enumerate a sector

GET /asset/ returns every tracked asset with its sector tags. No API key needed.

curl -s "https://data-svc.artemisxyz.com/asset/" > assets.json

Each asset carries tags.groups, the sector taxonomy:

{
  "artemis_id": "aave",
  "symbol": "aave",
  "title": "Aave",
  "tags": { "groups": [{ "value": "lending", "label": "Lending" }] },
  "metadata": { "about": { "asset_types": [{ "value": "App" }] } }
}

Filter it to get a sector’s members:

import requests

assets = requests.get("https://data-svc.artemisxyz.com/asset/", timeout=180).json()["assets"]

def sector(tag):
    return [
        (a["symbol"], a["title"])
        for a in assets
        if any(g.get("value") == tag for g in (a.get("tags") or {}).get("groups") or [])
    ]

for symbol, title in sector("perpetuals"):
    print(f"{symbol:12} {title}")

Sector tags you’ll most likely want:

Tag	Sector
`lending`	Lending / borrowing protocols
`dex`	Decentralised exchanges
`perpetuals`	Perpetual futures venues
`prediction_markets`	Event-contract venues
`stablecoin`	Stablecoins
`chain`	L1s and L2s
`liquid_staking`	Liquid staking protocols
`cex`	Centralised exchanges

metadata.about.asset_types gives the orthogonal classification (App, Chain, Stablecoin or Equity), which is useful if you’re building your own registry.

Some assets appear under more than one tag, because they genuinely operate in more than one sector. Hyperliquid is tagged both dex and perpetuals; Jupiter is tagged lending and perpetuals. Filter on the metric you care about, not on the tag alone.

Step 2: List an asset’s metrics

GET /supported-metrics/ returns the vocabulary for one asset.

curl -s "https://data-svc.artemisxyz.com/supported-metrics/?symbol=hype&APIKey=$ARTEMIS_API_KEY"

Pull out the fields that matter:

import os, requests

r = requests.get(
    "https://data-svc.artemisxyz.com/supported-metrics/",
    params={"symbol": "hype", "APIKey": os.environ["ARTEMIS_API_KEY"]},
    timeout=60,
).json()

metrics = {k: v for entry in r["metrics"] for k, v in entry.items()}
for name, meta in sorted(metrics.items()):
    if "PERP" in name or name == "OPEN_INTEREST":
        print(f"{name:28} {meta['unit']:10} {meta['aggregation_type']:8} {meta['label']}")

Each entry also carries description, methodology, and a cuts array listing the dimensionType values that metric supports.

Step 3: Fetch it

curl -s "https://data-svc.artemisxyz.com/v2/data/PERP_VOLUME,OPEN_INTEREST?symbols=hype&startDate=2026-07-25&endDate=2026-08-01&APIKey=$ARTEMIS_API_KEY"

Shortcut

If you already know your sector, the Metrics by Sector pages list the metric names and covered protocols directly. No discovery calls needed.

👋 Welcome

📜 Data Reference

🏛️ S&P Pantera Digital Asset Index

🌎 Prediction Markets

🔢 Artemis Sheets

🖥️ API

❄️ Snowflake Share

🖼️ Artemis Terminal

🔍 Research

📞 Contact Us

Step 1: Enumerate a sector

Step 2: List an asset’s metrics

Step 3: Fetch it

Shortcut

​Step 1: Enumerate a sector

​Step 2: List an asset’s metrics

​Step 3: Fetch it

​Shortcut

Step 1: Enumerate a sector

Step 2: List an asset’s metrics

Step 3: Fetch it

Shortcut