# Mantle Network API
> Live on-chain data for Mantle (chain-id 5000), a modular EVM Layer 2 with the MNT native gas token. Read the chain status — chain id, latest block number, current gas price, node client version and sync state — fetch any block by number (or the latest) with its hash, parent hash, timestamp, transaction count, gas used and limit, base fee and proposer, read the current gas price and max priority fee in both wei and gwei, and look up any account address for its MNT balance (in wei and whole MNT) and transaction nonce. Addresses use the standard 0x EVM hex form. A short protective cache keeps responses fast while staying within a few seconds of the chain. Distinct from other Layer-1, Layer-2 and Cosmos-chain APIs on the marketplace: this surfaces the Mantle network specifically.

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

## Pricing
- **Free** (Free) — 2,120 calls/Mo, 2 req/s
- **Basic** ($14/Mo) — 51,200 calls/Mo, 6 req/s
- **Pro** ($35/Mo) — 204,000 calls/Mo, 18 req/s
- **Scale** ($77/Mo) — 862,000 calls/Mo, 45 req/s

## Endpoints

### Chain

#### `GET /v1/status` — Chain status

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

**Response:**
```json
{
    "data": {
        "network": "Mantle Mainnet",
        "syncing": false,
        "chain_id": 5000,
        "block_number": 96695888,
        "native_token": "MNT",
        "gas_price_wei": "50000100000",
        "client_version": "Geth/v1.16.5-stable-c739e50e/linux-amd64/go1.24.13",
        "gas_price_gwei": 50.0001
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:50.654Z",
        "request_id": "7b2439dc-444e-49d3-b24b-6829e1981a67"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Blocks

#### `GET /v1/block` — Block by number (latest if omitted)

**Parameters:**
- `number` (query, optional, string) — Block number; omit for latest

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

**Response:**
```json
{
    "data": {
        "hash": "0xae2d7b4572190f817df4ff332cf82b8273394724a3b997cef51467b60e872717",
        "miner": "0x4200000000000000000000000000000000000011",
        "number": 96695888,
        "gas_used": 57487,
        "gas_limit": 60000000,
        "timestamp": 1781522088,
        "size_bytes": 912,
        "parent_hash": "0x878197c2612067a2ac2626a706fec2dddba1f11293777812221d2f0bfac04156",
        "transaction_count": 1,
        "base_fee_per_gas_wei": "50000000000"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:50.921Z",
        "request_id": "16c88f47-f9ed-42bf-a6fe-be43a53b96da"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Gas

#### `GET /v1/gas` — Current gas price and max priority fee

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

**Response:**
```json
{
    "data": {
        "native_token": "MNT",
        "gas_price_wei": "50000100000",
        "gas_price_gwei": 50.0001,
        "max_priority_fee_wei": "100000",
        "max_priority_fee_gwei": 0.0001
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:51.181Z",
        "request_id": "29ba645f-5efe-4a98-ab2c-ee3194bc602a"
    },
    "status": "ok",
    "message": "Gas retrieved successfully",
    "success": true
}
```

### Accounts

#### `GET /v1/balance` — MNT balance and nonce for an address

**Parameters:**
- `address` (query, required, string) — EVM address (0x + 40 hex) Example: `0x000000000000000000000000000000000000dEaD`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mantle-api/v1/balance?address=0x000000000000000000000000000000000000dEaD"
```

**Response:**
```json
{
    "data": {
        "address": "0x000000000000000000000000000000000000dead",
        "balance_mnt": 65.61702138,
        "balance_wei": "65617021384294646717",
        "transaction_count": 0
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:51.465Z",
        "request_id": "dde7e2c5-15d4-41ea-b3bb-c9014f9656db"
    },
    "status": "ok",
    "message": "Balance retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "name": "Mantle Network API",
        "source": "Mantle public JSON-RPC (rpc.mantle.xyz)",
        "endpoints": [
            {
                "path": "/v1/status",
                "description": "Chain id, latest block number, gas price, client version, sync state"
            },
            {
                "path": "/v1/block",
                "description": "Block by number (?number=; omit for latest)"
            },
            {
                "path": "/v1/gas",
                "description": "Current gas price and max priority fee (wei + gwei)"
            },
            {
                "path": "/v1/balance",
                "description": "MNT balance and nonce for an address (?address=0x…)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public Mantle JSON-RPC. Not affiliated with Mantle. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain data for Mantle (chain-id 5000), a modular EVM Layer 2 with the MNT native gas token. Exposes chain status, blocks, current gas prices and account balances via the public JSON-RPC.",
        "native_token": {
            "symbol": "MNT",
            "decimals": 18
        }
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:51.558Z",
        "request_id": "ee129b9f-2fc2-4e18-8bbc-5b42800edd55"
    },
    "status": 
…(truncated, see openapi.json for full schema)
```


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