# MultiversX API
> Live on-chain data from the MultiversX network (EGLD), a high-throughput Layer 1 built on adaptive state sharding, via its public REST API. MultiversX has three execution shards plus a metachain and a native fungible-token standard, ESDT. Resolve an address's EGLD balance, its nonce, the shard it lives on, its human-readable herotag username if it has one, and the contract that owns it. Read the ESDT tokens an account holds, each decimal-adjusted with its identifier, ticker and name. Get EGLD's live monetary picture — total and circulating supply, the amount staked and the staking ratio, the price and market cap, and the staking APR. Read the live chain state — the shard count, total blocks, accounts and transactions, the current epoch and the round refresh rate. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Hedera, Kaspa, Cosmos, Sui, NEAR, Solana and EVM on-chain APIs and from price feeds — this is MultiversX account state, ESDT holdings, EGLD economics and sharded chain stats. Perfect for wallets, explorers and analytics apps.

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

## Pricing
- **Free** (Free) — 6,800 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 138,000 calls/Mo, 5 req/s
- **Pro** ($37/Mo) — 860,000 calls/Mo, 15 req/s
- **Business** ($84/Mo) — 4,550,000 calls/Mo, 40 req/s

## Endpoints

### Account

#### `GET /v1/account` — Account EGLD balance + herotag

**Parameters:**
- `address` (query, required, string) — MultiversX address (erd1…) Example: `erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/multiversx-api/v1/account?address=erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p"
```

**Response:**
```json
{
    "data": {
        "nonce": 216,
        "shard": 0,
        "source": "MultiversX",
        "address": "erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p",
        "username": null,
        "balance_raw": "3512650228333772454782933",
        "balance_egld": 3512650.228334,
        "owner_address": null,
        "is_smart_contract": false,
        "developer_reward_egld": 0
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:20.099Z",
        "request_id": "20f64bcb-ea57-4ad7-bf8a-5bc0b9ec2720"
    },
    "status": "ok",
    "message": "Account retrieved successfully",
    "success": true
}
```

#### `GET /v1/tokens` — ESDT tokens an account holds

**Parameters:**
- `address` (query, required, string) — MultiversX address (erd1…) Example: `erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/multiversx-api/v1/tokens?address=erd1rf4hv70arudgzus0ymnnsnc4pml0jkywg2xjvzslg0mz4nn2tg7q7k0t6p&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "source": "MultiversX",
        "tokens": [
            {
                "name": "Aerovek",
                "ticker": "AERO",
                "balance": 1,
                "decimals": 18,
                "identifier": "AERO-458bbf",
                "balance_raw": "1000000000000000000"
            },
            {
                "name": "AmyCoin",
                "ticker": "AMY-a74e63",
                "balance": 1,
                "decimals": 6,
                "identifier": "AMY-a74e63",
                "balance_raw": "1000000"
            },
            {
                "name": "Blok",
                "ticker": "BLK-62896c",
                "balance": 1000000,
                "decimals": 6,
                "identifier": "BLK-62896c",
                "balance_raw": "1000000000000"
            },
            {
                "name": "BOB",
                "ticker": "BOB-5fc887",
                "balance": 9810000000,
                "decimals": 18,
                "identifier": "BOB-5fc887",
                "balance_raw": "9810000000000000000000000000"
            },
            {
                "name": "WrappedBUSD",
                "ticker": "BUSD",
                "balance": 0.00376541,
                "decimals": 18,
                "identifier": "BUSD-40b57e",
                "balance_raw": "3765406543230234"
            },
            {
                "name": "TheCryptoGymNetwork",
                "ticker": "CGN-61adcd"
…(truncated, see openapi.json for full schema)
```

### Network

#### `GET /v1/economics` — EGLD supply, staking and price

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

**Response:**
```json
{
    "data": {
        "source": "MultiversX",
        "apr_pct": 8.7413,
        "price_usd": 2.91,
        "staked_egld": 14466410,
        "base_apr_pct": 10.6829,
        "topup_apr_pct": 6.3317,
        "market_cap_usd": 87627148,
        "staked_ratio_pct": 48.0413,
        "total_supply_egld": 30112422,
        "circulating_supply_egld": 30112422
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:20.473Z",
        "request_id": "5a049f19-db8c-44da-979a-23584b1187a7"
    },
    "status": "ok",
    "message": "Economics retrieved successfully",
    "success": true
}
```

#### `GET /v1/network` — Live sharded chain state

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

**Response:**
```json
{
    "data": {
        "epoch": 2140,
        "blocks": 123207271,
        "shards": 3,
        "source": "MultiversX",
        "accounts": 9210158,
        "transactions": 609565167,
        "rounds_passed": 12277,
        "refresh_rate_ms": 6000,
        "rounds_per_epoch": 14400,
        "smart_contract_results": 418173278
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:20.606Z",
        "request_id": "7e286613-e566-4d5e-891c-c9b70bfa3aad"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```


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