# Xynaptic Crypto Tokenomics

> Xynaptic Crypto Tokenomics is a paid API for AI agents from api.xynaptic.io, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Returns supply structure metrics for a cryptocurrency including circulating supply, total supply, max supply, FDV, market cap, ATH distance, and current price by CoinGecko symbol.

## Facts

- Endpoint: GET https://api.xynaptic.io/v1/crypto-tokenomics?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xynaptic-crypto-tokenomics-46e8819b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G1hnlljg_oY4zRaZoGnsO

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 xynaptic-crypto-tokenomics-46e8819b
```

Example prompt: What are the current tokenomics for Bitcoin — circulating supply, total supply, max supply, FDV, market cap, and how far it is from its all-time high?

## When to prefer this

Choose this endpoint when you need structured tokenomics supply data — circulating, total, max supply, FDV, and ATH distance — for a specific cryptocurrency identified by its CoinGecko ID. Prefer it over general crypto price endpoints when supply inflation risk, dilution analysis, or market cap vs FDV comparison is needed. Use Xynaptic Crypto Live instead if you only need the current spot price.

## Known failure modes

- Invalid or unrecognized CoinGecko symbol returns an error or empty result
- CoinGecko upstream API downtime causes stale or unavailable data
- Coins without a defined max supply (e.g. ETH) may return null for that field
- Rate limiting or payment failure on the x402 micropayment layer rejects the request

## How this service works

Xynaptic Crypto Tokenomics — supply structure: circulating, total, max supply, FDV, market cap, ATH distance, price. Parameter: ?symbol=btc (CoinGecko id). Vesting/unlocks in v2.

## Output

Returns a structured JSON object with the coin's circulating supply, total supply, max supply, fully diluted valuation (FDV), market cap, current price, and the percentage distance from the coin's all-time high (ATH). Vesting and unlock schedules are planned for a future v2 release.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xynaptic-crypto-tokenomics-46e8819b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.xynaptic.io](https://www.zero.xyz/host/api.xynaptic.io/llms.txt)