# Soneium API
> Live Soneium on-chain data via Blockscout. Soneium is Sony's Ethereum L2 built on the OP Stack; gas and balances are in ETH. Network stats, gas prices, latest blocks, a block by height or hash, address detail with ETH balance, a transaction by hash, ERC-20 token metadata and a universal search across addresses, tokens, blocks and transactions. Real data, no key.

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

## Pricing
- **Free** (Free) — 1,200 calls/Mo, 1 req/s
- **Basic** ($14/Mo) — 65,000 calls/Mo, 10 req/s
- **Pro** ($45/Mo) — 420,000 calls/Mo, 20 req/s
- **Mega** ($145/Mo) — 2,100,000 calls/Mo, 50 req/s

## Endpoints

### Network

#### `GET /v1/gas` — Current gas prices

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

**Response:**
```json
{
    "data": {
        "fast": 0.01,
        "slow": 0.01,
        "unit": "gwei",
        "average": 0.01,
        "gas_used_today": "119499151590"
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:06.155Z",
        "request_id": "f13a0728-9286-4e1f-a33b-1e9f2e4f0270"
    },
    "status": "ok",
    "message": "Gas retrieved successfully",
    "success": true
}
```

#### `GET /v1/stats` — Network statistics

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

**Response:**
```json
{
    "data": {
        "tvl_usd": null,
        "gas_prices": {
            "fast": 0.01,
            "slow": 0.01,
            "average": 0.01
        },
        "total_blocks": 23871784,
        "coin_price_usd": 1690.55,
        "gas_used_today": "119499151590",
        "market_cap_usd": 204023211213.9947,
        "total_addresses": "14786660",
        "total_transactions": "684345061",
        "transactions_today": "1858217",
        "network_utilization_percent": 6.7673051
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:06.309Z",
        "request_id": "befa1e91-0798-4f80-9f95-d6bddc58904f"
    },
    "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: `23872875`
- `hash` (query, optional, string) — Block hash

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

**Response:**
```json
{
    "data": {
        "block": {
            "hash": "0x663b5ac2f9566bee76fdb68581c0dc98b762fcec97868b5642c1c03c4717c0e9",
            "size": 11343,
            "miner": "0x4200000000000000000000000000000000000011",
            "height": 23872875,
            "reward": "530080302359",
            "gas_used": 2290680,
            "tx_count": 50,
            "gas_limit": 40000000,
            "timestamp": "2026-06-08T01:01:41.000000Z",
            "burnt_fees": "1033096680",
            "difficulty": "0",
            "base_fee_per_gas": "451"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:06.539Z",
        "request_id": "92a49b7d-7517-427e-8ffc-7fae3697c3ee"
    },
    "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/soneium-api/v1/blocks"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "blocks": [
            {
                "hash": "0xd95258fd9228b3dae3f132c909aa82822326a3d470685c93d764cb886f232fab",
                "size": 15451,
                "miner": "0x4200000000000000000000000000000000000011",
                "height": 23873367,
                "reward": "1089436977038",
                "gas_used": 4005303,
                "tx_count": 44,
                "gas_limit": 40000000,
                "timestamp": "2026-06-08T01:18:05.000000Z",
                "burnt_fees": "1862465895",
                "difficulty": "0",
                "base_fee_per_gas": "465"
            },
            {
                "hash": "0xd34cc20efc1f5354ae995ff922c968db655c7e2f4029aef81a21f0b18f2babb6",
                "size": 14281,
                "miner": "0x4200000000000000000000000000000000000011",
                "height": 23873366,
                "reward": "148420274278",
                "gas_used": 2237628,
                "tx_count": 46,
                "gas_limit": 40000000,
                "timestamp": "2026-06-08T01:18:03.000000Z",
                "burnt_fees": "1040497020",
                "difficulty": "0",
                "base_fee_per_gas": "465"
            },
            {
                "hash": "0xb89bb60b0c79e3344fa114b7ffbaa2e37b5c11224b2e51e936b8396775da1c60",
                "size": 15742,
                "miner": "0x4200000000000000000000000000000000000011",
                "height": 23873365,
            
…(truncated, see openapi.json for full schema)
```

### Accounts

#### `GET /v1/address` — Address detail with ETH balance

**Parameters:**
- `address` (query, required, string) — Address hash Example: `0xbA9986D2381edf1DA03B0B9c1f8b00dc4AacC369`

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

**Response:**
```json
{
    "data": {
        "address": {
            "ens": null,
            "hash": "0xbA9986D2381edf1DA03B0B9c1f8b00dc4AacC369",
            "name": "Soneium Bridged USDC (Soneium)",
            "token": {
                "name": "Soneium Bridged USDC (Soneium)",
                "type": "ERC-20",
                "symbol": "USDC.E"
            },
            "creator": "0xe8Faf46D434832f4565dCb5e4B74C7BD831f91f9",
            "balance_eth": 0,
            "balance_wei": "0",
            "is_contract": true,
            "is_verified": true
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:10.495Z",
        "request_id": "51ae7520-ff4b-448b-91ce-a8c32188cc7f"
    },
    "status": "ok",
    "message": "Address retrieved successfully",
    "success": true
}
```

### Transactions

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

**Parameters:**
- `hash` (query, required, string) — Transaction hash Example: `0x6283f9beb0e3ac1da1846d8a42beebcc14a6cb1923439acb9206642db7a4fa4d`

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

**Response:**
```json
{
    "data": {
        "transaction": {
            "to": "0x4200000000000000000000000000000000000006",
            "from": "0x98C052f20379341B963b701076e3583007D7a501",
            "hash": "0x6283f9beb0e3ac1da1846d8a42beebcc14a6cb1923439acb9206642db7a4fa4d",
            "type": 2,
            "block": 23872875,
            "nonce": 3425,
            "method": "deposit",
            "status": "ok",
            "fee_eth": 3.301464233e-9,
            "fee_wei": "3301464233",
            "gas_used": 27832,
            "gas_price": "455",
            "timestamp": "2026-06-08T01:01:41.000000Z",
            "value_eth": 8.0378e-14,
            "value_wei": "80378",
            "confirmations": 495
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:11.665Z",
        "request_id": "f4be6e70-d56a-4864-b681-24969d243d96"
    },
    "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: `0xbA9986D2381edf1DA03B0B9c1f8b00dc4AacC369`

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

**Response:**
```json
{
    "data": {
        "token": {
            "icon": "https://assets.coingecko.com/coins/images/53776/small/usdc.jpg?1737340150",
            "name": "Soneium Bridged USDC (Soneium)",
            "type": "ERC-20",
            "symbol": "USDC.E",
            "holders": null,
            "decimals": 6,
            "total_supply": "2481570577457",
            "exchange_rate_usd": 0.999715,
            "circulating_market_cap": "2480932.2811885024"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:11.851Z",
        "request_id": "f4d9050f-3365-4718-824a-5f84a0b74a70"
    },
    "status": "ok",
    "message": "Token retrieved successfully",
    "success": true
}
```

### Search

#### `GET /v1/search` — Universal on-chain search

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

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "query": "USDC",
        "results": [
            {
                "name": "Soneium Bridged USDC (Soneium)",
                "type": "token",
                "symbol": "USDC.E",
                "address": "0xbA9986D2381edf1DA03B0B9c1f8b00dc4AacC369"
            },
            {
                "name": "UB-USDC",
                "type": "token",
                "symbol": "UB-USDC",
                "address": "0xc675BB95D73CA7db2C09c3dC04dAaA7944CCBA41"
            },
            {
                "name": "USDC-LP",
                "type": "token",
                "symbol": "S*USDC",
                "address": "0x5B091Dc6f94B5E2B54EDaB3800759Abf0Ed7D26D"
            },
            {
                "name": "Sake Soneium Variable Debt USDC.e",
                "type": "token",
                "symbol": "variableDebtSoneiumUSDC.e",
                "address": "0xe0c2e7DDA57ae7caf8D61D5B5f3395a0928cc331"
            },
            {
                "name": "Sake Soneium USDC.e",
                "type": "token",
                "symbol": "aUSDC.e",
                "address": "0x4491B60c8fdD668FcC2C4dcADf9012b3fA71a726"
            },
            {
                "name": "Aave Soneium USDCe",
                "type": "token",
                "symbol": "aSoneUSDCe",
                "address": "0xb2C9E934A55B58D20496A5019F8722a96d8A44d8"
            },
            {
                "name": "Kyo V2 LP: Wrapped Ether + Bridged USDC (Soneium)",
…(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/soneium-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "soneium-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 Soneium (L2) 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. Soneium is Sony's Ethereum L2 (OP Stack); gas and balances are in ETH. Real on-chain data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:12.892Z",
        "request_id": "15664933-6268-415f-bb27-5d9b194971b0"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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