# Crypto Address Validator API
> Validate cryptocurrency wallet addresses before you send funds or store them. Check an address against a specific coin — Bitcoin (legacy base58check and bech32 SegWit), Ethereum (with EIP-55 checksum), Litecoin, Dogecoin, Bitcoin Cash, XRP, Cardano, Tron, Monero and 100+ others — or let it auto-detect the likely currency across the most popular coins. Optionally restrict to mainnet or testnet. Catches typos, wrong-network mistakes and malformed addresses. Pure local validation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. Built for payment and checkout forms, exchanges and wallets, withdrawal validation and KYT pre-checks. Distinct from blockchain-data and market-price APIs.

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

## Pricing
- **Free** (Free) — 1,180 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 12,000 calls/Mo, 8 req/s
- **Pro** ($23/Mo) — 150,000 calls/Mo, 20 req/s
- **Mega** ($59/Mo) — 770,000 calls/Mo, 50 req/s

## Endpoints

### Validate

#### `GET /v1/validate` — Validate a crypto wallet address

**Parameters:**
- `address` (query, required, string) — Wallet address Example: `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa`
- `currency` (query, optional, string) — Coin symbol (btc, eth, …) or auto Example: `btc`
- `network` (query, optional, string) — mainnet|testnet

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptoaddr-api/v1/validate?address=1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa&currency=btc"
```

**Response:**
```json
{
    "data": {
        "valid": true,
        "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
        "currency": "btc"
    },
    "meta": {
        "timestamp": "2026-06-02T16:51:52.634Z",
        "request_id": "10b236f0-f3fa-43ce-88e6-fb7eb3189466"
    },
    "status": "ok",
    "message": "Validate a crypto address",
    "success": true
}
```

### Reference

#### `GET /v1/coins` — Auto-detect currency set

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

**Response:**
```json
{
    "data": {
        "note": "Auto-detection tries these; pass any of 100+ symbols explicitly as ?currency= (e.g. btc, eth, ltc, doge, bch, xrp, ada, trx, xmr, …).",
        "auto_detect": [
            "btc",
            "eth",
            "ltc",
            "doge",
            "bch",
            "dash",
            "xrp",
            "xlm",
            "trx",
            "ada",
            "xmr",
            "zec",
            "etc",
            "bnb",
            "neo",
            "qtum",
            "xtz",
            "atom",
            "algo",
            "dot"
        ]
    },
    "meta": {
        "timestamp": "2026-06-02T16:51:52.747Z",
        "request_id": "d17d8173-c031-4eec-aa9e-bfdbfabd8596"
    },
    "status": "ok",
    "message": "Auto-detect currency set",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "auth": "none upstream; this gateway requires x-api-key",
        "name": "Crypto Address Validator API",
        "note": "Validate cryptocurrency wallet addresses. /v1/validate?address=...&currency=btc (or eth, ltc, doge, …; omit or use auto to auto-detect across popular coins). Checks base58check / bech32 (Bitcoin) and EIP-55 checksum (Ethereum), with optional ?network=mainnet|testnet. /v1/coins lists the auto-detect set. Instant, nothing stored. Distinct from blockchain-data and market-data APIs.",
        "source": "Local address validation (multicoin-address-validator) — no key, no upstream",
        "endpoints": 3
    },
    "meta": {
        "timestamp": "2026-06-02T16:51:52.830Z",
        "request_id": "8a8798a5-01ae-4264-b09c-a603891b47f2"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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