# TRC-20 Token API
> Read live data on TRON's TRC-20 tokens — the standard that settles the largest share of the world's USDT (Tether) — straight from the public TronScan API, no key. Resolve any TRC-20 contract to its name, symbol, decimals, total supply, holder count, on-chain verification status and live market data (USD price, market cap, 24-hour volume); stream a token's most recent transfers decoded into from / to / amount; and rank the whole TRC-20 universe by market cap, holders or volume. Where TRON wallet APIs show an account's activity, this is the token-level view — what a token is and how it moves. The TRC-20 data layer every wallet, explorer, trading tool and analytics dashboard needs. Live; short cache only.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/trc20-api/..."
```

## Pricing
- **Free** (Free) — 6,600 calls/Mo, 3 req/s
- **Starter** ($13/Mo) — 127,000 calls/Mo, 8 req/s
- **Pro** ($41/Mo) — 780,000 calls/Mo, 20 req/s
- **Business** ($118/Mo) — 4,900,000 calls/Mo, 50 req/s

## Endpoints

### TRC-20

#### `GET /v1/ranking` — Top TRC-20 tokens by market cap / holders / volume

**Parameters:**
- `order` (query, optional, string) — Sort: marketcap, holders or volume Example: `marketcap`
- `limit` (query, optional, string) — How many (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/trc20-api/v1/ranking?order=marketcap&limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "TRC-20 tokens ranked by marketcap (market cap, holders or volume). Filterable via the order parameter.",
        "count": 25,
        "order": "marketcap",
        "total": 124737,
        "source": "TronScan",
        "tokens": [
            {
                "name": "Wrapped TRX",
                "symbol": "WTRX",
                "holders": 14322,
                "contract": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR",
                "decimals": 6,
                "verified": true,
                "price_usd": 0.3161475774075891,
                "transfers": 20556830,
                "market_cap_usd": 1339782907.133206,
                "volume_24h_usd": 362072208.552265
            },
            {
                "name": "Wrapped BTT",
                "symbol": "WBTT",
                "holders": 47193,
                "contract": "TKfjV9RNKJJCqPvBtK8L7Knykh7DNWvnYt",
                "decimals": 6,
                "verified": true,
                "price_usd": null,
                "transfers": 2041587,
                "market_cap_usd": null,
                "volume_24h_usd": null
            },
            {
                "name": "Bitcoin",
                "symbol": "BTC",
                "holders": 43039,
                "contract": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
                "decimals": 8,
                "verified": true,
                "price_usd": 64379.64164535553,
                "transfers": 1409965,
                "market_c
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/token` — Full TRC-20 token metadata + market data

**Parameters:**
- `contract` (query, required, string) — TRC-20 contract address (base58, starts with T) Example: `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/trc20-api/v1/token?contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
```

**Response:**
```json
{
    "data": {
        "icon": "https://static.tronscan.org/production/logo/usdtlogo.png",
        "name": "Tether USD",
        "note": "Live TRC-20 token metadata and market data from TronScan. total_supply is the raw integer (with decimals applied); divide by decimals for the human amount.",
        "source": "TronScan",
        "symbol": "USDT",
        "holders": 74396776,
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "decimals": 6,
        "verified": false,
        "price_usd": 0.9994104987675522,
        "volume_24h": 42668573581.89,
        "total_supply": "89341574028133753",
        "liquidity_24h": 162078686.81751904,
        "market_cap_usd": 89288907060.13535,
        "issue_timestamp": 0
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:05.130Z",
        "request_id": "649fde03-eca6-437c-bc6c-2b8b448e6d6e"
    },
    "status": "ok",
    "message": "Token retrieved successfully",
    "success": true
}
```

#### `GET /v1/transfers` — A token's most recent transfers, decoded

**Parameters:**
- `contract` (query, required, string) — TRC-20 contract address Example: `TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t`
- `limit` (query, optional, string) — Max results (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/trc20-api/v1/transfers?contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "The token's most recent TRC-20 transfers, decoded into from / to / amount (raw integer). This is the token's transfer feed, not a single wallet's.",
        "count": 20,
        "total": 10000,
        "source": "TronScan",
        "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
        "transfers": [
            {
                "to": "TU3PYfKxNLb4kUVTmimtZHPGxqzW7g1W8L",
                "from": "TEbfjUjsQudgJVPeVSbZsBx4RYqWsoQAmP",
                "block": 83584976,
                "amount": "9619999",
                "confirmed": false,
                "timestamp": 1781424240000,
                "transaction_id": "3c3c27dd6346abc4478fa4c9c05fed8cb57ab2b94698c02005590a8e9189608a"
            },
            {
                "to": "TXe31JpKEjb9Jr1sqNnSssD6gTZd9RHUtJ",
                "from": "TBm4GqjqYsKKLjSJhxwPUqn927qDGhAbj7",
                "block": 83584976,
                "amount": "7001000000",
                "confirmed": false,
                "timestamp": 1781424240000,
                "transaction_id": "90558e61c042ccae2cfb02bb930433a715c8553fdbc0b301d81b5483f7e9b540"
            },
            {
                "to": "TGemQhixbXegnw5AucUL5bhisZwVaJFU7A",
                "from": "TEVbXxJ9mCnv1jWaaTBmCx5bpEpv67rb2U",
                "block": 83584976,
                "amount": "1701050000",
                "confirmed": false,
                "timestamp": 1781424240000,
                "transaction_id": "6817ee8e49dbb2c8d4c3795b5
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata & live sample

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/trc20-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "sample": {
            "symbol": "USDT",
            "holders": 74396776
        },
        "source": "public TronScan API (apilist.tronscanapi.com), keyless",
        "service": "trc20-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/token": "Full TRC-20 token metadata + market data (contract=TR7NHqj...).",
            "GET /v1/ranking": "Top TRC-20 tokens by market cap / holders / volume (order, limit).",
            "GET /v1/transfers": "A token's most recent transfers decoded (contract, limit)."
        },
        "description": "Read live TRC-20 token data on TRON from the public TronScan API: resolve any contract to name/symbol/decimals/supply/holders/verification plus live USD price, market cap and volume; stream a token's recent transfers; or rank the TRC-20 universe by market cap or holders. The token-level view for TRON wallets, explorers and trading tools. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T08:04:05.476Z",
        "request_id": "f90ad65b-3c56-45dd-a9b6-c4b58fbf7ab4"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/trc20-api
OpenAPI spec: https://www.oanor.com/api/trc20-api/openapi.json