# Fetch.ai API
> Live on-chain data for Fetch.ai (chain id fetchhub-4) — the Cosmos-SDK Layer-1 behind the Artificial Superintelligence Alliance, whose native token is FET — served directly from public LCD/REST nodes with multi-node failover. The status endpoint returns the latest block height and time, chain id, the staking bond denom and the current minting inflation rate. The validators endpoint lists the active bonded validator set ranked by stake, each with its moniker, operator address, self-plus-delegated FET, commission rate and jailed flag. The supply endpoint returns the total FET supply, the amount bonded in staking and the resulting bonded ratio. The governance endpoint returns the most recent on-chain proposals with their id, title, status and voting window. FET uses an 18-decimal base denomination (afet) which is converted to whole FET with exact big-integer scaling, and every figure is read live from the chain — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for staking dashboards, validator and delegator tooling, explorers, governance trackers and portfolio or analytics apps across the Cosmos and AI-blockchain 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/fetchai-api/..."
```

## Pricing
- **Free** (Free) — 320 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 15,600 calls/Mo, 8 req/s
- **Pro** ($39/Mo) — 82,000 calls/Mo, 16 req/s
- **Mega** ($93/Mo) — 330,000 calls/Mo, 40 req/s

## Endpoints

### Fetch.ai

#### `GET /v1/governance` — Recent governance proposals

**Parameters:**
- `limit` (query, optional, string) — Max proposals to return (1-50) Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fetchai-api/v1/governance?limit=15"
```

**Response:**
```json
{
    "data": {
        "chain": "Fetch.ai",
        "count": 15,
        "symbol": "FET",
        "proposals": [
            {
                "id": "40",
                "title": "Recover expired ibc client on Injective",
                "status": "PROPOSAL_STATUS_VOTING_PERIOD",
                "submit_time": "2026-06-09T05:41:30.180316934Z",
                "voting_end_time": "2026-06-17T17:23:49.272608584Z"
            },
            {
                "id": "39",
                "title": "Upgrade to fetchai Cosmos-SDK v0.20.0 (canonical v0.53.7)",
                "status": "PROPOSAL_STATUS_PASSED",
                "submit_time": "2026-05-26T18:15:01.034421050Z",
                "voting_end_time": "2026-05-31T18:15:01.034421050Z"
            },
            {
                "id": "38",
                "title": "Recover expired ibc client on Injective",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2026-02-17T06:21:10.583983272Z",
                "voting_end_time": "2026-02-23T07:29:32.727670131Z"
            },
            {
                "id": "37",
                "title": "Proposal: Burn Remaining 110 Million FET Tokens",
                "status": "PROPOSAL_STATUS_REJECTED",
                "submit_time": "2025-10-28T17:31:50.051139113Z",
                "voting_end_time": "2025-11-02T17:31:50.051139113Z"
            },
            {
                "id": "36",
                "title": "Raise the bock limit params `max_gas` and
…(truncated, see openapi.json for full schema)
```

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

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

**Response:**
```json
{
    "data": {
        "chain": "Fetch.ai",
        "source": "Fetch.ai (fetchhub) LCD",
        "symbol": "FET",
        "chain_id": "fetchhub-4",
        "bond_denom": "afet",
        "inflation_pct": 3,
        "latest_block_time": "2026-06-15T20:39:47.435145414Z",
        "latest_block_height": 27842104
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.643Z",
        "request_id": "95dfc34b-6fec-4af1-a7d1-a40e7a1ef3a8"
    },
    "status": "ok",
    "message": "Fetch.ai status retrieved",
    "success": true
}
```

#### `GET /v1/supply` — FET supply & bonded ratio

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

**Response:**
```json
{
    "data": {
        "chain": "Fetch.ai",
        "denom": "afet",
        "bonded": 556194730.315614,
        "symbol": "FET",
        "decimals": 18,
        "total_supply": 1350983677.028807,
        "bonded_ratio_pct": 41.17
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.738Z",
        "request_id": "d3f3dc51-f887-4701-8e17-5568c21d7d09"
    },
    "status": "ok",
    "message": "Fetch.ai supply retrieved",
    "success": true
}
```

#### `GET /v1/validators` — Active validator set

**Parameters:**
- `limit` (query, optional, string) — Max validators to return (1-300) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/fetchai-api/v1/validators?limit=100"
```

**Response:**
```json
{
    "data": {
        "chain": "Fetch.ai",
        "count": 79,
        "symbol": "FET",
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 107856070.337086,
                "moniker": "Kiln",
                "commission_pct": 10,
                "operator_address": "fetchvaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqlr0wzf"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 85001473.19251,
                "moniker": "Colossus",
                "commission_pct": 10,
                "operator_address": "fetchvaloper1qy7mkd5jf4zacpfnpp5z73z5tmg7455jmsfqlu"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 72062672.720739,
                "moniker": "Binance Staking",
                "commission_pct": 10,
                "operator_address": "fetchvaloper17zr49k6tmcz7eezxgl7x0pfxa9e92h7lv29hd3"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "tokens": 51372092.30405,
                "moniker": "Allnodes",
                "commission_pct": 5,
                "operator_address": "fetchvaloper1kfvx47a85ylex0x3c398mzzd2drxt9x4lwh4sa"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
         
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "api": "Fetch.ai API",
        "chain": "Fetch.ai",
        "denom": "afet",
        "source": "Fetch.ai public LCD/REST nodes (Cosmos SDK)",
        "symbol": "FET",
        "chain_id": "fetchhub-4",
        "decimals": 18,
        "endpoints": [
            "/v1/status",
            "/v1/validators",
            "/v1/supply",
            "/v1/governance",
            "/v1/meta"
        ],
        "description": "Live on-chain data for Fetch.ai (fetchhub) — the Cosmos-SDK Layer-1 powering the Artificial Superintelligence Alliance (FET).",
        "documentation": "https://fetchai-api.oanor.dev"
    },
    "meta": {
        "timestamp": "2026-06-15T20:40:27.927Z",
        "request_id": "92abce06-b9ea-4f56-807a-773132bd0af0"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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