# Neon EVM Chain API
> Live on-chain data for Neon EVM — an Ethereum Virtual Machine running on the Solana network — via its public Blockscout explorer (no wallet, no key). The stats endpoint returns chain-wide totals (blocks, transactions, addresses, average block time, gas used); gas gives the current gas-price oracle (slow/average/fast). Blocks lists the latest blocks, and a single block resolves by height or by hash with its transaction count, gas, miner and timestamp. The address endpoint returns any account's NEON balance, nonce, contract flag and token holdings; transaction resolves a tx by hash with its from/to, value in NEON, fee, status and block. The token endpoint returns an ERC-20 token's metadata (name, symbol, decimals, total supply, holders) by contract address, and search runs a universal lookup across addresses, tokens, blocks and transactions. Gas, balances, values and fees are denominated in NEON, the native coin. Real on-chain data straight from the explorer, refreshed every call — no key. 9 endpoints. For multi-chain coverage combine with the other oanor chain APIs (Ethereum, Base, Arbitrum and more).

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

## Pricing
- **Free** (Free) — 3,200 calls/Mo, 2 req/s
- **Basic** ($22/Mo) — 108,000 calls/Mo, 8 req/s
- **Pro** ($67/Mo) — 680,000 calls/Mo, 20 req/s
- **Mega** ($225/Mo) — 3,750,000 calls/Mo, 50 req/s

## Endpoints

### Chain

#### `GET /v1/gas` — Gas-price oracle

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

**Response:**
```json
{
    "data": {
        "fast": 4748.13,
        "slow": 4748.13,
        "unit": "gwei",
        "average": 4748.13,
        "gas_used_today": "17493497"
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:33.295Z",
        "request_id": "840d1911-5bd8-4261-9645-da52c011c891"
    },
    "status": "ok",
    "message": "Gas retrieved successfully",
    "success": true
}
```

#### `GET /v1/stats` — Chain stats

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

**Response:**
```json
{
    "data": {
        "tvl_usd": null,
        "gas_prices": {
            "fast": 4748.13,
            "slow": 4748.13,
            "average": 4748.13
        },
        "total_blocks": 230501478,
        "coin_price_usd": null,
        "gas_used_today": "17493497",
        "market_cap_usd": 0,
        "total_addresses": "3425106",
        "total_transactions": "22808787",
        "transactions_today": "1171",
        "network_utilization_percent": 0
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:33.445Z",
        "request_id": "c72b5728-84d5-4601-9df4-33bb61824023"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Blocks

#### `GET /v1/block` — A block by height or hash

**Parameters:**
- `height` (query, optional, string) — Block height Example: `425049434`
- `hash` (query, optional, string) — Block hash (alternative to height)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/neon-api/v1/block?height=425049434"
```

**Response:**
```json
{
    "data": {
        "block": {
            "hash": "0xc233e72b675e4342bbf545d0f9124b6a4d1de700d0339c62d6d47a9953140b5f",
            "size": 1,
            "miner": "0x0000000000000000000000000000000000000000",
            "height": 425049434,
            "gas_used": 16773,
            "tx_count": 1,
            "gas_limit": 48000000000000,
            "timestamp": "2026-06-08T05:41:13.000000Z",
            "burnt_fees": "179612515775579253",
            "difficulty": "0",
            "base_fee_per_gas": "10708431155761"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:33.602Z",
        "request_id": "1003348a-dacd-41df-bb8f-7009b85dc3e6"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/blocks` — Latest blocks

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "blocks": [
            {
                "hash": "0x04d4162a6a813d3c761ceb98790180d6965baf2a39fa270857d273b99f800e4d",
                "size": 1,
                "miner": "0x0000000000000000000000000000000000000000",
                "height": 425086838,
                "gas_used": 0,
                "tx_count": 0,
                "gas_limit": 48000000000000,
                "timestamp": "2026-06-08T09:49:30.000000Z",
                "burnt_fees": "0",
                "difficulty": "0",
                "base_fee_per_gas": "11092724442680"
            },
            {
                "hash": "0x8706082c7e7b82bc2509cbd019fc9e6160af7494aead3fe3eedbdfffb577ae4e",
                "size": 1,
                "miner": "0x0000000000000000000000000000000000000000",
                "height": 425086837,
                "gas_used": 0,
                "tx_count": 0,
                "gas_limit": 48000000000000,
                "timestamp": "2026-06-08T09:49:30.000000Z",
                "burnt_fees": "0",
                "difficulty": "0",
                "base_fee_per_gas": "11092724442680"
            },
            {
                "hash": "0xc0d811cb2713dba90da91210045fcd59c896657b83cfab8db075e8a6b5c36571",
                "size": 1,
                "miner": "0x0000000000000000000000000000000000000000",
                "height": 425086836,
                "gas_used": 0,
                "tx_count": 0,
                "gas_limit": 4800000000000
…(truncated, see openapi.json for full schema)
```

### Accounts

#### `GET /v1/address` — Account balance & holdings

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

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

**Response:**
```json
{
    "data": {
        "address": {
            "ens": null,
            "hash": "0x40068FA5135E2D9276C5F27A4f308aAF572FE04F",
            "name": null,
            "token": null,
            "creator": null,
            "balance_wei": "76784958512749763194",
            "is_contract": false,
            "is_verified": false,
            "balance_neon": 76.78495851274975
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:34.211Z",
        "request_id": "9325c814-84f7-4257-8726-e328ab6f32d7"
    },
    "status": "ok",
    "message": "Address retrieved successfully",
    "success": true
}
```

### Transactions

#### `GET /v1/transaction` — A transaction by hash

**Parameters:**
- `hash` (query, required, string) — Transaction hash (0x + 64 hex) Example: `0x3c207053fb1917d74cdd1521ce15e3a2f64d656f3a4b0dfd8a1cdf903a61a421`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/neon-api/v1/transaction?hash=0x3c207053fb1917d74cdd1521ce15e3a2f64d656f3a4b0dfd8a1cdf903a61a421"
```

**Response:**
```json
{
    "data": {
        "transaction": {
            "to": "0xBb5e1777A331ED93E07cF043363e48d320eb96c4",
            "from": "0x40068FA5135E2D9276C5F27A4f308aAF572FE04F",
            "hash": "0x3c207053fb1917d74cdd1521ce15e3a2f64d656f3a4b0dfd8a1cdf903a61a421",
            "type": 0,
            "block": 425049434,
            "nonce": 3862,
            "method": "swapExactETHForTokens",
            "status": "ok",
            "fee_wei": "76975621803658140",
            "fee_neon": 0.07697562180365815,
            "gas_used": 16773,
            "gas_price": "4589257843180",
            "timestamp": "2026-06-08T05:41:13.000000Z",
            "value_wei": "1290455799315033981",
            "value_neon": 1.2904557993150338,
            "confirmations": 37407
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:34.624Z",
        "request_id": "99ef0346-ea30-4afb-a31a-7f1678c01d29"
    },
    "status": "ok",
    "message": "Transaction retrieved successfully",
    "success": true
}
```

### Tokens

#### `GET /v1/token` — ERC-20 token metadata

**Parameters:**
- `address` (query, required, string) — Token contract address Example: `0x5f0155d08eF4aaE2B500AefB64A3419dA8bB611a`

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

**Response:**
```json
{
    "data": {
        "token": {
            "icon": "https://assets.coingecko.com/coins/images/35068/small/logo.png?1707290894",
            "name": "Neonpass Bridged USDT  Neon",
            "type": "ERC-20",
            "symbol": "USDT",
            "holders": null,
            "decimals": 6,
            "total_supply": "3839908056301196",
            "exchange_rate_usd": null,
            "circulating_market_cap": null
        }
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:34.803Z",
        "request_id": "16031fd5-bf18-4584-9fba-860c7200c8db"
    },
    "status": "ok",
    "message": "Token retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Universal search

**Parameters:**
- `q` (query, required, string) — Address, token, block or tx Example: `USDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/neon-api/v1/search?q=USDT"
```

**Response:**
```json
{
    "data": {
        "count": 15,
        "query": "USDT",
        "results": [
            {
                "name": "Neonpass Bridged USDT  Neon",
                "type": "token",
                "symbol": "USDT",
                "address": "0x5f0155d08eF4aaE2B500AefB64A3419dA8bB611a"
            },
            {
                "name": "Tether USD (ICE)",
                "type": "token",
                "symbol": "USDT",
                "address": "0xc0E49f8C615d3d4c245970F6Dc528E4A47d69a44"
            },
            {
                "name": "Lumen USDT",
                "type": "token",
                "symbol": "luUSDT",
                "address": "0x8Ce2AD7f4800AA9A41e8fE76F32aa45844928815"
            },
            {
                "name": "LendOS Neon USDT",
                "type": "token",
                "symbol": "osNeonUSDT",
                "address": "0xb9B369aE5E285fD97F026a442d40D6f747bC9881"
            },
            {
                "name": "LendOS Neon Variable Debt USDT",
                "type": "token",
                "symbol": "variableDebtNeonUSDT",
                "address": "0xAba718DBBc8a497D04fbb462A1200B3BA07BF79B"
            },
            {
                "name": "Sobal USDC-USDT Stable Pool",
                "type": "token",
                "symbol": "SPT-stable",
                "address": "0x985b565665FB07133F2aF74Ee1C9B0aDB29Bd3d3"
            },
            {
                "name": "Sobal USDT-USDC Stable Pool",
                
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "service": "neon-api",
        "endpoints": {
            "GET /v1/gas": "Gas oracle (slow/average/fast in gwei).",
            "GET /v1/meta": "This document.",
            "GET /v1/block": "Block detail by height= or hash=.",
            "GET /v1/stats": "Network stats (blocks, txns, coin price, market cap, gas).",
            "GET /v1/token": "ERC-20 token detail by contract (address=).",
            "GET /v1/blocks": "The most recent blocks.",
            "GET /v1/search": "Search addresses, tokens, blocks & txns (q=).",
            "GET /v1/address": "Address balance, ENS & contract info (address=).",
            "GET /v1/transaction": "Transaction detail (hash=)."
        },
        "description": "Live Neon EVM on-chain data via Blockscout: network stats, a gas oracle (gwei), recent blocks and block detail, address balances with ENS, transaction detail, ERC-20 token detail and a universal search across addresses, tokens, blocks and transactions. Neon EVM is an EVM running on Solana; gas, balances and fees are in NEON. Real on-chain data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T09:49:35.325Z",
        "request_id": "d76545d7-6608-469f-880a-5762ed226b41"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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