# TokenGuard Exchange Rankings API

> TokenGuard Exchange Rankings API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a ranked list of cryptocurrency exchanges with trust scores, trading volumes, and country of incorporation

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/exchange
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-exchange-rankings-api-96072c65
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ELVa8oDx8LeqVQZQIEtgm

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 tokenguard-exchange-rankings-api-96072c65 -d '<json body>'
```

Example prompt: Give me the top 10 cryptocurrency exchanges ranked by trust score, including their daily BTC trading volume and country of registration.

## When to prefer this

Use this endpoint when you need ranked, trust-scored cryptocurrency exchange data including 24h BTC volume in a single call, especially within an agentic workflow that already handles x402 micropayments on Base. Prefer this over free alternatives when trust scores and country metadata matter, and when you need structured JSON ready for downstream DeFi analytics or compliance checks.

## Known failure modes

- Payment not received — x402 micropayment of $0.005 USDC on Base required before response is returned
- Invalid POST body — malformed JSON may return 400 error
- Service unavailable — Hugging Face Space may be sleeping or at capacity
- Rate limiting — too many rapid successive calls may be throttled
- Empty result — no exchanges match applied filters

## How this service works

Top CEX/DEX by trust score and 24h BTC volume (CoinGecko, free, no key). Exchange rank, country, year established, trading pairs count.

## Output

A JSON object containing a count of exchanges returned, an array of exchange objects each with name, rank, country, trust score (0–10), and 24h BTC volume, plus an aggregate total_volume_24h_btc across all returned exchanges.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max exchanges 1-50 (default 10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "exchanges": [
   {
    "name": "Binance",
    "rank": 1,
    "country": "Cayman Islands",
    "trust_score": 10,
    "volume_24h_btc": 45000
   }
  ],
  "total_volume_24h_btc": 123456.7
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-exchange-rankings-api-96072c65/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)