# Funki API
> Live EVM on-chain data for Funki (chain id 33979) — an OP-Stack Layer-2 built for gaming and social applications, with gas paid in ETH — served directly from the public Funki JSON-RPC with server-side resilience. 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 ETH balance and outgoing transaction count for any address, converted from base wei (18 decimals) into whole ETH 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 Funki gaming and social 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/funki-api/..."
```

## Pricing
- **Free** (Free) — 320 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 15,100 calls/Mo, 8 req/s
- **Pro** ($35/Mo) — 83,000 calls/Mo, 16 req/s
- **Mega** ($84/Mo) — 335,000 calls/Mo, 40 req/s

## Endpoints

### Funki

#### `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/funki-api/v1/balance?address=0x000000000000000000000000000000000000dEaD"
```

**Response:**
```json
{
    "data": {
        "chain": "Funki",
        "symbol": "ETH",
        "address": "0x000000000000000000000000000000000000dEaD",
        "balance": 0,
        "tx_count": 0,
        "balance_wei": "0"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:16.443Z",
        "request_id": "2a5ae138-95ae-4e7b-9113-98871e16de01"
    },
    "status": "ok",
    "message": "Funki 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/funki-api/v1/block?number=5000000"
```

**Response:**
```json
{
    "data": {
        "hash": "0x5239147aba58d96e62427b5bccbbd085279d784d7a734849176cc6bbd9bd4d31",
        "chain": "Funki",
        "miner": "0x4200000000000000000000000000000000000011",
        "number": 5000000,
        "gas_used": 43842,
        "tx_count": 1,
        "gas_limit": 30000000,
        "timestamp": 1731211095,
        "size_bytes": 839,
        "parent_hash": "0x607e5866f3717cfe3bd9d98eb775ee73b4b20dca7136fc42a55826edb7da1403",
        "timestamp_iso": "2024-11-10T03:58:15.000Z"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:16.678Z",
        "request_id": "106066c7-01c7-4a5e-904a-515bea1f7528"
    },
    "status": "ok",
    "message": "Funki block retrieved",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "Funki",
        "source": "eth_gasPrice",
        "symbol": "ETH",
        "gas_price_wei": 1000253,
        "gas_price_gwei": 0.001000253
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:16.927Z",
        "request_id": "e7843d3a-4792-484f-b209-418d2d14e02e"
    },
    "status": "ok",
    "message": "Funki gas retrieved",
    "success": true
}
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "Funki",
        "source": "Funki L2 RPC",
        "symbol": "ETH",
        "chain_id": 33979,
        "network_id": 33979,
        "latest_block": 30172460,
        "client_version": "reth/v2.2.0-7680d6d/x86_64-unknown-linux-gnu"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:17.523Z",
        "request_id": "b6aa4235-b52f-459f-a4a1-6c7f5f1cee56"
    },
    "status": "ok",
    "message": "Funki status retrieved",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "api": "Funki API",
        "chain": "Funki",
        "source": "Funki L2 JSON-RPC nodes",
        "symbol": "ETH",
        "chain_id": 33979,
        "endpoints": [
            "/v1/status",
            "/v1/block",
            "/v1/gas",
            "/v1/balance",
            "/v1/meta"
        ],
        "description": "Live EVM on-chain data for Funki — an OP-Stack Layer-2 for gaming and social apps, gas paid in ETH.",
        "documentation": "https://funki-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:17.600Z",
        "request_id": "c20127b4-ff5a-4e87-90ab-4e979fde0e7e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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