# Agoric Chain API > Real-time on-chain data for Agoric (chain-id agoric-3), a Cosmos-SDK Layer-1 purpose-built for JavaScript smart contracts, with BLD as its native staking coin (and IST as its stablecoin), secured by delegated proof-of-stake. The status endpoint returns the chain id, latest block height and time, proposer and node application version so you can confirm the chain is live and producing blocks. The validators endpoint returns the full bonded validator set — each moniker, operator address, stake in BLD, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded BLD. The supply endpoint returns the total BLD supply (in BLD and base ubld), the bonded amount and the bonded ratio. The governance endpoint returns the most recent on-chain governance proposals with title, status and voting window. The meta endpoint documents the chain, denom and decimals. Reads a live Agoric Cosmos-SDK LCD node directly (with mirror fallback), so values are current to the latest block. Live, nothing stored. 5 endpoints. This serves chain-level staking, supply and governance data; for IST stablecoin or contract state use a dedicated app/contract API. ## 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/agoric-api/..." ``` ## Pricing - **Free** (Free) — 290 calls/Mo, 2 req/s - **Basic** ($13/Mo) — 23,800 calls/Mo, 5 req/s - **Pro** ($35/Mo) — 124,500 calls/Mo, 20 req/s - **Mega** ($78/Mo) — 548,000 calls/Mo, 60 req/s ## Endpoints ### Chain #### `GET /v1/status` — Chain status: latest block, chain id, node version **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/agoric-api/v1/status" ``` **Response:** ```json { "data": { "chain": "Agoric", "healthy": true, "chain_id": "agoric-3", "native_symbol": "BLD", "node_app_version": "0.35.0-u22.1", "proposer_address": "u14sOAeuVuRhKRlhKGB2YtNkPuU=", "latest_block_time": "2026-06-15T20:40:11.999896183Z", "latest_block_height": 25933147 }, "meta": { "timestamp": "2026-06-15T20:40:35.758Z", "request_id": "a99440b2-5e17-4aa8-9734-baf1a530e661" }, "status": "ok", "message": "Chain status retrieved successfully", "success": true } ``` ### Staking #### `GET /v1/supply` — Total BLD supply and bonded ratio **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/agoric-api/v1/supply" ``` **Response:** ```json { "data": { "chain": "Agoric", "denom": "ubld", "decimals": 6, "bonded_bld": "452718585.669818", "native_symbol": "BLD", "bonded_ratio_pct": 38.72, "total_supply_bld": "1169000485.061579", "total_supply_ubld": "1169000485061579" }, "meta": { "timestamp": "2026-06-15T20:40:35.846Z", "request_id": "164c2d1e-51d5-4041-9999-897c68636504" }, "status": "ok", "message": "Supply retrieved successfully", "success": true } ``` #### `GET /v1/validators` — Bonded validator set with stake and commission **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/agoric-api/v1/validators" ``` **Response:** ```json { "data": { "chain": "Agoric", "validators": [ { "jailed": false, "status": "BOND_STATUS_BONDED", "moniker": "DokiaCapital", "tokens_bld": "65848707.581895", "tokens_ubld": "65848707581895", "commission_rate": 0.05, "operator_address": "agoricvaloper14lultfckehtszvzw4ehu0apvsr77afvy4d3pzq" }, { "jailed": false, "status": "BOND_STATUS_BONDED", "moniker": "alkadeta - 1% Fee Forever", "tokens_bld": "59872650.567913", "tokens_ubld": "59872650567913", "commission_rate": 0.01, "operator_address": "agoricvaloper1ud49jmefce60m0fqvm9y0v860fptssgrpwu6h2" }, { "jailed": false, "status": "BOND_STATUS_BONDED", "moniker": "polkachu.com", "tokens_bld": "43607679.223754", "tokens_ubld": "43607679223754", "commission_rate": 0.03, "operator_address": "agoricvaloper108p8an08ztyxp8yhd2ca5zn456e3myqksy22pa" }, { "jailed": false, "status": "BOND_STATUS_BONDED", "moniker": "GoodTeam", "tokens_bld": "38203021.721339", "tokens_ubld": "38203021721339", "commission_rate": 0.01 …(truncated, see openapi.json for full schema) ``` ### Governance #### `GET /v1/governance` — Recent on-chain governance proposals **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/agoric-api/v1/governance" ``` **Response:** ```json { "data": { "chain": "Agoric", "count": 10, "proposals": [ { "id": "118", "title": "Text Proposal: Introduce a Deflationary Mechanism – Burn 1 BLD per Reward Claim", "status": "PROPOSAL_STATUS_PASSED", "summary": "Summary This proposal introduces a simple and transparent deflationary mechanism for the Agoric ecosystem: Burn 1 BLD every time staking rewards are claimed. The goal is to: Introduce a predictable and consistent supply sink Align network a", "submit_time": "2026-03-30T20:07:15.204895523Z", "voting_end_time": "2026-04-02T20:07:15.204895523Z" }, { "id": "117", "title": "Reallocate Traditional Marketing Spend to Data-Driven Growth + Treasury Buybacks, with Full Spend Transparency", "status": "PROPOSAL_STATUS_REJECTED", "summary": "Over the past months, the community has repeatedly asked for a clear, execution-ready marketing plan with measurable deliverables. We have not seen a consistent roadmap, ownership model, or KPI framework that matches the current level of ma", "submit_time": "2026-03-05T20:43:20.632874517Z", "voting_end_time": "2026-03-08T20:43:20.632874517Z" }, { "id": "116", "title": "Adjust Mint Inflation Bounds to 2–3% Annual Range", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Chain metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/agoric-api/v1/meta" ``` **Response:** ```json { "data": { "type": "Cosmos-SDK Layer-1 (Tendermint/CometBFT)", "chain": "Agoric", "denom": "ubld", "chain_id": "agoric-3", "decimals": 6, "ecosystem": "Agoric — a Cosmos-SDK Layer-1 for JavaScript smart contracts, native staking coin BLD (with the IST stablecoin), secured by delegated proof-of-stake.", "endpoints": [ "/v1/status", "/v1/validators", "/v1/supply", "/v1/governance", "/v1/meta" ], "documentation": "https://agoric-api.oanor.dev", "native_symbol": "BLD" }, "meta": { "timestamp": "2026-06-15T20:40:36.164Z", "request_id": "15d60ef2-ada4-42c9-a2cf-f9dc71ffef8a" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/agoric-api OpenAPI spec: https://www.oanor.com/api/agoric-api/openapi.json