# Oblique Markets Token Metrics

> Oblique Markets Token Metrics is a paid API for AI agents from api.oblique.markets, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns fundamental token data including holder metrics for a specified crypto token

## Facts

- Endpoint: POST https://api.oblique.markets/api/v1/paid/token-metrics
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oblique-markets-token-metrics-dc404127
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_boHGMAD1BQScLcM8q8xXh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oblique-markets-token-metrics-dc404127 -d '<json body>'
```

Example prompt: Pull the token fundamental data and holder metrics for the PEPE token so I can evaluate whether the holder base is healthy before making an investment decision.

## When to prefer this

Choose this endpoint when you need structured, fundamental token data with holder metrics in a single call — particularly useful for token research, pre-investment due diligence, or evaluating holder concentration risk. Prefer over raw on-chain SQL queries (like the Dune analytics sibling) when you want pre-aggregated fundamentals without writing custom queries. Use instead of sentiment or trading signals endpoints when the focus is on on-chain holder structure rather than market momentum.

## Known failure modes

- Invalid or unrecognized token address returns an error or empty result
- Token not indexed on the supported chain returns no data
- Missing required query parameters results in a 400-level error
- Payment not processed (x402 flow incomplete) returns a 402 Payment Required
- Rate limiting or quota exceeded returns a 429 error
- Network or upstream data provider outage returns a 503

## How this service works

Use when an agent needs token metrics. Returns Token price and on-chain market metrics from public DeFi data, including chain TVL, DEX volume, fees, yields and protocol context. $0.003.

## Output

A JSON response containing fundamental token data such as holder count, holder distribution breakdown, market-related metrics, and other on-chain fundamentals relevant to evaluating a token's health and community spread.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string"
  },
  "symbol": {
   "type": "string"
  },
  "token_address": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "Base",
  "price": {
   "source": "DefiLlama",
   "symbol": "WETH",
   "price_usd": 2500
  },
  "market": {
   "source": "DefiLlama",
   "fees_24h_usd": 900000,
   "chain_tvl_usd": 5000000000,
   "dex_volume_24h_usd": 120000000
  },
  "yields": [],
  "freshness": {
   "sources": [
    "DefiLlama"
   ],
   "retrieved_at": "2026-09-01T12:00:00.000Z"
  },
  "protocols": [],
  "token_address": "0x4200000000000000000000000000000000000006"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oblique-markets-token-metrics-dc404127/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.oblique.markets](https://www.zero.xyz/host/api.oblique.markets/llms.txt)