# Gnosis Chain On-Chain API
> Live Gnosis Chain on-chain data as an API, built on the open Blockscout explorer. Gnosis Chain (chain id 100, formerly xDAI) is a long-running Ethereum-compatible network whose native currency is the xDAI stable token, so gas and balances are denominated in a dollar-pegged coin. Pull network stats (total blocks and transactions, native price, live gas), a gas oracle with slow, average and fast prices in gwei, the most recent blocks and full block detail by height or hash. Look up any address for its balance and contract status, any transaction by hash for its value, fee, status, sender and receiver, and any ERC-20 token by contract for its name, symbol, decimals, holders and USD rate. A universal search resolves addresses, tokens, blocks and transactions in one call. Real on-chain data, no key needed upstream. Ideal for Gnosis wallets, block explorers, gas trackers, DeFi dashboards and on-chain analytics.

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

## Pricing
- **Free** (Free) — 9,500 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 125,000 calls/Mo, 8 req/s
- **Pro** ($19/Mo) — 640,000 calls/Mo, 25 req/s
- **Mega** ($68/Mo) — 3,050,000 calls/Mo, 50 req/s

## Endpoints

### Gnosis

#### `GET /v1/address` — Address balance & contract info

**Parameters:**
- `address` (query, required, string) — A Gnosis address (0x + 40 hex) Example: `0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83`

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

**Response:**
```json
{
    "data": {
        "address": {
            "ens": null,
            "hash": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83",
            "name": "Gnosis xDAI Bridged USDC (Gnosis)",
            "token": {
                "name": "Gnosis xDAI Bridged USDC (Gnosis)",
                "type": "ERC-20",
                "symbol": "USDC"
            },
            "creator": "0xf6A78083ca3e2a662D6dd1703c939c8aCE2e268d",
            "balance_eth": 0,
            "balance_wei": "0",
            "is_contract": true,
            "is_verified": true
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:52.774Z",
        "request_id": "9723ff1a-ef06-4f8b-bb59-7d0cb3333e1e"
    },
    "status": "ok",
    "message": "Address retrieved successfully",
    "success": true
}
```

#### `GET /v1/block` — Block detail by height or hash

**Parameters:**
- `height` (query, optional, string) — Block height, e.g. 35000000 Example: `35000000`
- `hash` (query, optional, string) — Block hash (alternative to height)

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

**Response:**
```json
{
    "data": {
        "block": {
            "hash": "0x97c3d6a89eaab5e1535cdd5c489810babd6c39956bfc91af72828d6682fe9a24",
            "size": 2589,
            "miner": "0x1b265301Ce6FacB997c2A1311C753AA038ec36c4",
            "height": 35000000,
            "reward": "4418025898654446",
            "gas_used": 2578967,
            "tx_count": 5,
            "gas_limit": 17000000,
            "timestamp": "2024-07-16T19:13:55.000000Z",
            "burnt_fees": "18052769",
            "difficulty": "0",
            "base_fee_per_gas": "7"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:52.911Z",
        "request_id": "bbcf39a4-630e-49d1-b5de-396a28de21bc"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/blocks` — The most recent blocks

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "blocks": [
            {
                "hash": "0xf22a8518d4025f9ea434730122bc14294f3d0e7db2e0644725186084be13c09e",
                "size": 6037,
                "miner": "0x30db0d10d3774e78f8cB214b9e8B72D4B402488a",
                "height": 46583167,
                "reward": "367635530934102",
                "gas_used": 8055860,
                "tx_count": 6,
                "gas_limit": 17000000,
                "timestamp": "2026-06-08T01:18:50.000000Z",
                "burnt_fees": "1353384480",
                "difficulty": "0",
                "base_fee_per_gas": "168"
            },
            {
                "hash": "0x0cb92af353276ba2c1c394719dc267c9764f2c13850a8e821ed2c82d2607e457",
                "size": 16841,
                "miner": "0x4354A28c70E33032619DF646b6DD0D39d0C75916",
                "height": 46583166,
                "reward": "96309120369661",
                "gas_used": 3788833,
                "tx_count": 18,
                "gas_limit": 17000000,
                "timestamp": "2026-06-08T01:18:45.000000Z",
                "burnt_fees": "681989940",
                "difficulty": "0",
                "base_fee_per_gas": "180"
            },
            {
                "hash": "0x0219d6be34c5941794a49990a69f8d8ac9a1b7db853f06cecce2c96f36fd90c3",
                "size": 136696,
                "miner": "0x30db0d10d3774e78f8cB214b9e8B72D4B402488a",
                "height": 46583165,
          
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/gas` — Gas oracle (gwei)

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

**Response:**
```json
{
    "data": {
        "fast": 4.48,
        "slow": 0.07,
        "unit": "gwei",
        "average": 0.26,
        "gas_used_today": "121535717656"
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:53.670Z",
        "request_id": "bec5efde-94ad-4eec-9335-7ea1f48bd983"
    },
    "status": "ok",
    "message": "Gas retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search addresses, tokens, blocks & txns

**Parameters:**
- `q` (query, required, string) — Search term, e.g. USDC Example: `USDC`

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

**Response:**
```json
{
    "data": {
        "count": 50,
        "query": "USDC",
        "results": [
            {
                "name": "Gnosis xDAI Bridged USDC (Gnosis)",
                "type": "token",
                "symbol": "USDC",
                "address": "0xDDAfbb505ad214D7b80b1f830fcCc89B60fb7A83"
            },
            {
                "name": "Gnosis xDAI Bridged USDC (Gnosis)",
                "type": "token",
                "symbol": "USDC.E",
                "address": "0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0"
            },
            {
                "name": "Lucid USDC",
                "type": "token",
                "symbol": "LUSDC",
                "address": "0xCD2f64112ec04e21cC56F7bf2294A6A37790305e"
            },
            {
                "name": "Aave v3 USDC",
                "type": "token",
                "symbol": "AUSDC",
                "address": "0xc6B7AcA6DE8a6044E0e32d0c841a89244A10D284"
            },
            {
                "name": "$ cUSDC.disusd.eth.limo",
                "type": "token",
                "symbol": "Claim USDC at https://cusdc.disusd.eth.limo",
                "address": "0x01731B66dafAc43c7889C6A1c15d094943B75a92"
            },
            {
                "name": "$ cUSDC.disusd.eth.li",
                "type": "token",
                "symbol": "Claim USDC at https://cusdc.disusd.eth.li",
                "address": "0x5E7e6B602fbd0635018D8d123677F25f9EfAb3C8"
            },
            {
               
…(truncated, see openapi.json for full schema)
```

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

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

**Response:**
```json
{
    "data": {
        "tvl_usd": 68020528,
        "gas_prices": {
            "fast": 4.48,
            "slow": 0.07,
            "average": 0.26
        },
        "total_blocks": 46582100,
        "coin_price_usd": 0.999464,
        "gas_used_today": "121535717656",
        "market_cap_usd": 74761089.61520484,
        "total_addresses": "527526553",
        "total_transactions": "374434623",
        "transactions_today": "257797",
        "network_utilization_percent": 49.33748722566376
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:54.727Z",
        "request_id": "f564e413-fafb-4be8-8ac9-3ea21ca093ff"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

#### `GET /v1/token` — ERC-20 token detail by contract

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

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

**Response:**
```json
{
    "data": {
        "token": {
            "icon": "https://assets.coingecko.com/coins/images/35300/small/USDC_Icon.png?1708083625",
            "name": "Gnosis xDAI Bridged USDC (Gnosis)",
            "type": "ERC-20",
            "symbol": "USDC",
            "holders": null,
            "decimals": 6,
            "total_supply": "16791028266308",
            "exchange_rate_usd": 0.999705,
            "circulating_market_cap": "16784371.895844646"
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:54.865Z",
        "request_id": "9f07d361-5f06-4fb6-b01e-29cbb1901363"
    },
    "status": "ok",
    "message": "Token retrieved successfully",
    "success": true
}
```

#### `GET /v1/transaction` — Transaction detail by hash

**Parameters:**
- `hash` (query, required, string) — A transaction hash (0x + 64 hex) Example: `0xcedbf7f06f9ea9d0f5bfa326c075f95385d16726e173784ae699c8f1c00fbe1d`

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

**Response:**
```json
{
    "data": {
        "transaction": {
            "to": "0x01b4eA64E4204b51cbc8463FFC8e6046C9D70371",
            "from": "0xb2bf078b376b00628C000ceE7fbA63eA86C952EE",
            "hash": "0xcedbf7f06f9ea9d0f5bfa326c075f95385d16726e173784ae699c8f1c00fbe1d",
            "type": 0,
            "block": 35000000,
            "nonce": 775,
            "method": "transfer",
            "status": "ok",
            "fee_eth": 0.0006151104,
            "fee_wei": "615110400000000",
            "gas_used": 192222,
            "gas_price": "3200000000",
            "timestamp": "2024-07-16T19:13:55.000000Z",
            "value_eth": 0,
            "value_wei": "0",
            "confirmations": 11583168
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:55.289Z",
        "request_id": "4f5f878f-4c85-4cdd-aff4-806ac4f6c214"
    },
    "status": "ok",
    "message": "Transaction retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service description & endpoints

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

**Response:**
```json
{
    "data": {
        "service": "gnosis-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 Gnosis Chain 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. Gnosis Chain native currency is xDAI (a stable token); gas and balances are in xDAI. Real on-chain data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:18:55.372Z",
        "request_id": "5afa043e-426f-44b2-bce5-a9635822052f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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