# XPLA API
> Live EVM on-chain data for XPLA (chain id 37) — the Cosmos-built gaming and entertainment Layer-1 from Com2uS, whose native token is XPLA, served through its Dimension EVM via public JSON-RPC nodes with multi-node failover. The status endpoint returns the chain and network id, the latest block height and the node client version. The block endpoint returns a block by number (or the latest) with its hash, parent hash, timestamp, transaction count, gas used and gas limit, miner and size. The gas endpoint returns the current gas price in both wei and gwei. The balance endpoint returns the XPLA balance and outgoing transaction count for any EVM address, converted from base wei (18 decimals) into whole XPLA with exact big-integer scaling. Every figure is read live from the chain over JSON-RPC — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for explorers, wallet and dashboard tooling, gas trackers, address monitors and analytics apps across the XPLA gaming and NFT ecosystem. Live keyless upstream. 5 endpoints.

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

## Pricing
- **Free** (Free) — 350 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 16,600 calls/Mo, 8 req/s
- **Pro** ($36/Mo) — 80,000 calls/Mo, 16 req/s
- **Mega** ($87/Mo) — 325,000 calls/Mo, 40 req/s

## Endpoints

### XPLA

#### `GET /v1/balance` — Address balance & tx count

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

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

**Response:**
```json
{
    "data": {
        "chain": "XPLA",
        "symbol": "XPLA",
        "address": "0x000000000000000000000000000000000000dEaD",
        "balance": 0,
        "tx_count": 0,
        "balance_wei": "0"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:18.078Z",
        "request_id": "f0d840a0-649d-440d-aea2-0e6fb99c53a9"
    },
    "status": "ok",
    "message": "XPLA balance retrieved",
    "success": true
}
```

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

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

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

**Response:**
```json
{
    "data": {
        "hash": "0x7ec1e8eed8be573f9ae3cdfc5dda73ab231b7056acfeb2d2b203f2d35ef620a9",
        "chain": "XPLA",
        "miner": "0x7ceaf61796b1b37cc8885606daf8df6cb6e7a21c",
        "number": 5000000,
        "gas_used": 513336,
        "tx_count": 0,
        "gas_limit": 100000000,
        "timestamp": 1691447714,
        "size_bytes": 618,
        "parent_hash": "0x09ca53b56fee182613b6011cc5723f3fcce1510fa27c1dd28d269eddc723d7a1",
        "timestamp_iso": "2023-08-07T22:35:14.000Z"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:19.138Z",
        "request_id": "840f11fe-9e0b-4086-aa46-7c14cd4361d4"
    },
    "status": "ok",
    "message": "XPLA block retrieved",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "XPLA",
        "source": "eth_gasPrice",
        "symbol": "XPLA",
        "gas_price_wei": 280000000000,
        "gas_price_gwei": 280
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:19.584Z",
        "request_id": "18c4e13e-948a-40b1-80fa-089d32b2591d"
    },
    "status": "ok",
    "message": "XPLA gas retrieved",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "XPLA",
        "source": "XPLA Dimension EVM RPC",
        "symbol": "XPLA",
        "chain_id": 37,
        "network_id": 37,
        "latest_block": 19989481,
        "client_version": "Version dev ()\nCompiled at  using Go go1.23.10 (amd64)"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:20.037Z",
        "request_id": "5bc1ca7b-b265-461d-afda-22f244f66591"
    },
    "status": "ok",
    "message": "XPLA status retrieved",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "api": "XPLA API",
        "chain": "XPLA",
        "source": "XPLA Dimension EVM JSON-RPC nodes",
        "symbol": "XPLA",
        "chain_id": 37,
        "endpoints": [
            "/v1/status",
            "/v1/block",
            "/v1/gas",
            "/v1/balance",
            "/v1/meta"
        ],
        "description": "Live EVM on-chain data for XPLA — the Cosmos-based gaming and entertainment Layer-1 (XPLA token), via its Dimension EVM.",
        "documentation": "https://xpla-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:20.143Z",
        "request_id": "f659e676-78b6-4278-bf5c-da7faa16af13"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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