> ## Documentation Index
> Fetch the complete documentation index at: https://artemis.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Finding assets and metrics

> Enumerate a sector with GET /asset/, then list an asset's metric vocabulary with GET /supported-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/`](/docs/docs/api-reference/discovery/list-assets) returns every tracked asset with its sector tags. No API key needed.

```bash theme={null}
curl -s "https://data-svc.artemisxyz.com/asset/" > assets.json
```

Each asset carries `tags.groups`, the sector taxonomy:

```json theme={null}
{
  "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:

```python theme={null}
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.

<Note>
  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.
</Note>

## Step 2: List an asset's metrics

[`GET /supported-metrics/`](/docs/docs/api-reference/discovery/list-supported-metrics) returns the vocabulary for one asset.

```bash theme={null}
curl -s "https://data-svc.artemisxyz.com/supported-metrics/?symbol=hype&APIKey=$ARTEMIS_API_KEY"
```

Pull out the fields that matter:

```python theme={null}
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

```bash theme={null}
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](/docs/artemis-api/metrics/lending) pages list the metric names and covered protocols directly. No discovery calls needed.