# Algorand ASA Token Registry API
> Algorand Standard Assets (ASAs) — Algorand's native token standard — live from the public Algonode indexer, no key, nothing cached. Every fungible and non-fungible token on Algorand, including Circle's USDC and Tether's USDt, is an ASA. The Algorand on-chain reader looks up a single asset, but there is no ASA registry in the marketplace; this opens it. Browse the ASA space paginated, each asset with its id, name, unit, total supply and decimals. Look up a single ASA in full — its name, unit, total supply (raw and decimal-adjusted), project URL and the on-chain role addresses that govern it: the manager (can reconfigure or destroy), the reserve, the freeze address and the clawback address. And search ASAs by name to find a token (with a reminder to verify the creator, since anyone can mint an ASA with any name). The token layer for Algorand wallets, DEXs, token explorers and analytics. Live from mainnet-idx.algonode.cloud.

## 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/algorandasa-api/..."
```

## Pricing
- **Free** (Free) — 7,600 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 130,500 calls/Mo, 9 req/s
- **Pro** ($33/Mo) — 820,000 calls/Mo, 22 req/s
- **Business** ($95/Mo) — 4,910,000 calls/Mo, 55 req/s

## Endpoints

### Assets

#### `GET /v1/asset` — One ASA in full: supply, decimals, URL, role addresses

**Parameters:**
- `id` (query, optional, string) — ASA id (omit for USDC) Example: `31566704`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/algorandasa-api/v1/asset?id=31566704"
```

**Response:**
```json
{
    "data": {
        "id": 31566704,
        "url": "https://www.centre.io/usdc",
        "name": "USDC",
        "note": "A single Algorand Standard Asset in full: its name, unit, total supply (raw and decimal-adjusted), project URL and the role addresses — manager (can reconfigure), reserve, freeze and clawback — that control it. Omit id for USDC.",
        "freeze": "3ERES6JFBIJ7ZPNVQJNH2LETCBQWUPGTO4ROA6VFUR25WFSYKGX3WBO5GE",
        "source": "Algonode indexer",
        "creator": "2UEQTE5QDNXPI7M3TU44G6SYKLFWLPQO7EBZM7K7MHMQQMFI4QJPLHQFHM",
        "deleted": false,
        "manager": "37XL3M57AXBUJARWMT5R7M35OERXMH3Q22JMMEFLBYNDXXADGFN625HAL4",
        "reserve": "2UEQTE5QDNXPI7M3TU44G6SYKLFWLPQO7EBZM7K7MHMQQMFI4QJPLHQFHM",
        "clawback": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAY5HFKQ",
        "decimals": 6,
        "unit_name": "USDC",
        "total_supply": 18446744073709.55,
        "default_frozen": false,
        "created_at_round": 8874561,
        "total_base_units": "18446744073709552000"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:27.475Z",
        "request_id": "0e716742-e75a-43fd-af7d-014affec3c25"
    },
    "status": "ok",
    "message": "Asset retrieved successfully",
    "success": true
}
```

#### `GET /v1/assets` — Browse the ASA space, paginated

**Parameters:**
- `limit` (query, optional, string) — Page size (1-100) Example: `20`
- `next` (query, optional, string) — Pagination token from a previous response

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/algorandasa-api/v1/assets?limit=20"
```

**Response:**
```json
{
    "data": {
        "next": "17466",
        "note": "Browse the Algorand Standard Asset (ASA) space, paginated. Each ASA carries a name, unit name, total supply and decimals. Pass the returned next token to page forward; use /v1/asset for an ASA's full details.",
        "count": 20,
        "assets": [
            {
                "id": 5,
                "name": "Joe-Coin",
                "total": "10000",
                "creator": "L226FSG3LTZR4V2MI5M4SDKJSF5HP2TQFAYD6L2HOKYGJB6GARLETV3B4A",
                "decimals": 0,
                "unit_name": "JC"
            },
            {
                "id": 6,
                "name": "Cartan",
                "total": "100000000000000",
                "creator": "QYQYXRJ7FLQCRRGE3WH5CIAAL56LLMIN6GHRMN6PR45A44E6XA4QQ3JC64",
                "decimals": 0,
                "unit_name": "CTN"
            },
            {
                "id": 235,
                "name": "Optional hash ",
                "total": "1",
                "creator": "QA75IQ76F6H2T55G65BY7BPLF5QNWSLT5XGI62COZSYB4ZQ3MSKI3EQ25A",
                "decimals": 0,
                "unit_name": "ertrng"
            },
            {
                "id": 236,
                "name": "Optional hash ",
                "total": "1",
                "creator": "QA75IQ76F6H2T55G65BY7BPLF5QNWSLT5XGI62COZSYB4ZQ3MSKI3EQ25A",
                "decimals": 0,
                "unit_name": "ertrng"
            },
            {
                "id": 237,
            
…(truncated, see openapi.json for full schema)
```

### Search

#### `GET /v1/search` — Search ASAs by name

**Parameters:**
- `name` (query, required, string) — Asset name to search (min 2 chars) Example: `USDC`
- `limit` (query, optional, string) — Max results (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/algorandasa-api/v1/search?name=USDC&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "Algorand Standard Assets whose name matches the query. Use /v1/asset with an id for full details. Note that anyone can create an ASA with any name, so verify the creator address for well-known tokens.",
        "count": 20,
        "query": "USDC",
        "assets": [
            {
                "id": 31566704,
                "name": "USDC",
                "total": "18446744073709552000",
                "creator": "2UEQTE5QDNXPI7M3TU44G6SYKLFWLPQO7EBZM7K7MHMQQMFI4QJPLHQFHM",
                "decimals": 6,
                "unit_name": "USDC"
            },
            {
                "id": 359314135,
                "name": "Tinyman Pool USDC-ALGO",
                "total": "18446744073709552000",
                "creator": "W3RTY34WM3WNAPESJX3NCHX6KP32O6V2RI5WNB3RBKKZE3RQAXYTLNUWCI",
                "decimals": 6,
                "unit_name": "TM1POOL"
            },
            {
                "id": 359330978,
                "name": "Tinyman Pool USDC-USDt",
                "total": "18446744073709552000",
                "creator": "527D3Q5UFOFDLQPF2ADXIHL4GSSBAKOR7ZAXPMDKWLT7L34SIIZEHCVXOU",
                "decimals": 6,
                "unit_name": "TM1POOL"
            },
            {
                "id": 359363312,
                "name": "Tinyman Pool SMILE-USDC",
                "total": "18446744073709552000",
                "creator": "A7TATMOKFGPEXRDRZIGISD7O3GXBNEM7D3KI32UXV2FHLKKSXRSCGB6YNI",
                "decimal
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "sample": {
            "name": "USDC",
            "default_asset": 31566704
        },
        "source": "public Algonode indexer (mainnet-idx.algonode.cloud), keyless",
        "service": "algorandasa-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/asset": "One ASA in full: supply, decimals, URL, role addresses (id; omit for USDC).",
            "GET /v1/assets": "Browse the ASA space, paginated (limit, next).",
            "GET /v1/search": "Search ASAs by name (name, limit)."
        },
        "description": "Read Algorand Standard Assets (ASAs) — Algorand's native token standard — live from the public Algonode indexer: browse the ASA space paginated, look up a single ASA in full (name, unit, supply, decimals, URL and the manager/reserve/freeze/clawback role addresses) and search ASAs by name. The token layer for Algorand wallets, DEXs and token explorers. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:04:27.941Z",
        "request_id": "28b433c4-899e-4fd9-af78-019326fb40dc"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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