# Fraxtal Network API
> Live on-chain data for Fraxtal (chain-id 252), an Optimistic-rollup EVM Layer 2 from Frax Finance that uses frxETH (Frax Ether) as its gas token. Read the chain status — chain id, latest block number, current gas price, node client version and sync state — fetch any block by number (or the latest) with its hash, parent hash, timestamp, transaction count, gas used and limit, base fee and proposer, read the current gas price and max priority fee in both wei and gwei, and look up any account address for its frxETH balance (in wei and whole frxETH) and transaction nonce. Addresses use the standard 0x EVM hex form. A short protective cache keeps responses fast while staying within a few seconds of the chain. Distinct from the Frax Finance protocol pools/yields feed and from other Layer-1, Layer-2 and Cosmos-chain APIs on the marketplace: this surfaces the Fraxtal chain itself.

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

## Pricing
- **Free** (Free) — 2,240 calls/Mo, 2 req/s
- **Basic** ($13/Mo) — 50,800 calls/Mo, 6 req/s
- **Pro** ($34/Mo) — 197,000 calls/Mo, 18 req/s
- **Scale** ($76/Mo) — 848,000 calls/Mo, 45 req/s

## Endpoints

### Chain

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

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

**Response:**
```json
{
    "data": {
        "network": "Fraxtal Mainnet",
        "syncing": false,
        "chain_id": 252,
        "block_number": 37355691,
        "native_token": "frxETH",
        "gas_price_wei": "1000254",
        "client_version": "reth/v2.2.0-7680d6d/x86_64-unknown-linux-gnu",
        "gas_price_gwei": 0.001
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:53.789Z",
        "request_id": "2b31f3d3-8a2a-4db0-93dc-ea408a4199af"
    },
    "status": "ok",
    "message": "Status retrieved successfully",
    "success": true
}
```

### Blocks

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

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

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

**Response:**
```json
{
    "data": {
        "hash": "0x1bcb40b7723221eb26c371ed6c9cdecb877d5620498085c6834a1d315bf974d6",
        "miner": "0x4200000000000000000000000000000000000011",
        "number": 37355691,
        "gas_used": 48367,
        "gas_limit": 30000000,
        "timestamp": 1781522093,
        "size_bytes": 897,
        "parent_hash": "0x47ddb01fd0bb4d7eb52f3028b056cc52d682aa1323dcd9087b8c6b8ef7a26b91",
        "transaction_count": 1,
        "base_fee_per_gas_wei": "254"
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:53.916Z",
        "request_id": "6d7b437f-7730-4b92-8ddd-006eede0a826"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

### Gas

#### `GET /v1/gas` — Current gas price and max priority fee

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

**Response:**
```json
{
    "data": {
        "native_token": "frxETH",
        "gas_price_wei": "1000254",
        "gas_price_gwei": 0.001,
        "max_priority_fee_wei": "1000000",
        "max_priority_fee_gwei": 0.001
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:54.040Z",
        "request_id": "bdb81904-0548-4df9-a008-52e5b6c83792"
    },
    "status": "ok",
    "message": "Gas retrieved successfully",
    "success": true
}
```

### Accounts

#### `GET /v1/balance` — frxETH balance and nonce for an address

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

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

**Response:**
```json
{
    "data": {
        "address": "0x000000000000000000000000000000000000dead",
        "balance_wei": "968099411976949995",
        "balance_frxeth": 0.96809941,
        "transaction_count": 0
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:54.159Z",
        "request_id": "2aca639b-9d82-4061-a977-c6e1e9d041f7"
    },
    "status": "ok",
    "message": "Balance retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "name": "Fraxtal Network API",
        "source": "Fraxtal public JSON-RPC (rpc.frax.com)",
        "endpoints": [
            {
                "path": "/v1/status",
                "description": "Chain id, latest block number, gas price, client version, sync state"
            },
            {
                "path": "/v1/block",
                "description": "Block by number (?number=; omit for latest)"
            },
            {
                "path": "/v1/gas",
                "description": "Current gas price and max priority fee (wei + gwei)"
            },
            {
                "path": "/v1/balance",
                "description": "frxETH balance and nonce for an address (?address=0x…)"
            },
            {
                "path": "/v1/meta",
                "description": "This metadata document"
            }
        ],
        "disclaimer": "Unofficial proxy of the public Fraxtal JSON-RPC. Not affiliated with Frax Finance. Data only; no guarantees of accuracy or availability.",
        "description": "On-chain data for Fraxtal (chain-id 252), an Optimistic-rollup EVM Layer 2 from Frax Finance that uses frxETH (Frax Ether) for gas. Exposes chain status, blocks, current gas prices and account balances via the public JSON-RPC.",
        "native_token": {
            "symbol": "frxETH",
            "decimals": 18
        }
    },
    "meta": {
        "timestamp": "2026-06-15T11:14:54.230Z",
        "request_id": "a4dd929d-
…(truncated, see openapi.json for full schema)
```


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