# Coreum Smart-Tokens On-Chain API
> Live on-chain data from Coreum (coreum-mainnet-1), a Cosmos-SDK layer-1 whose native asset-ft module gives every fungible token programmable on-chain features. Read the registry of issued smart fungible tokens (denom, issuer, on-chain supply), the full detail of any token including its programmable features (minting, burning, freezing, whitelisting), burn rate, send-commission rate and admin, the tokens issued by a given address, the staking pool with bonded ratio and validator set, the total CORE supply and the latest block. The Coreum / smart-token / programmable-asset layer for explorers, token dashboards and DeFi tooling.

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

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 2 req/s
- **Basic** ($14/Mo) — 62,000 calls/Mo, 5 req/s
- **Pro** ($40/Mo) — 240,000 calls/Mo, 15 req/s
- **Business** ($86/Mo) — 920,000 calls/Mo, 40 req/s

## Endpoints

### Smart Tokens

#### `GET /v1/token` — Full smart-token detail with features

**Parameters:**
- `denom` (query, required, string) — Token denom ({subunit}-{issuer}) Example: `aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/coreum-api/v1/token?denom=aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq"
```

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "token": {
            "uri": "https://www.instagram.com/magnetictoneofpurpose/",
            "admin": "core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
            "denom": "aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
            "issuer": "core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
            "symbol": "Hoailona",
            "subunit": "aloha22",
            "version": 1,
            "features": [
                "burning",
                "ibc",
                "dex_unified_ref_amount_change"
            ],
            "burn_rate": 0.001,
            "precision": 8,
            "description": "Ho'Ailona is a Native Hawai'ian (kama'aina) Owned Physical + Digital Specialty Boutique Featuring The Most Exclusive Limited Edition Hawai'ian Apparel and Art Collections.",
            "globally_frozen": false,
            "send_commission_rate": 0.001
        }
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:18.447Z",
        "request_id": "6abe40ee-41c6-486b-8475-3375ed22149e"
    },
    "status": "ok",
    "message": "Smart token retrieved successfully",
    "success": true
}
```

#### `GET /v1/tokens` — Registry of smart fungible tokens

**Parameters:**
- `limit` (query, optional, string) — Number of tokens (1-200) Example: `20`

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

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "count": 20,
        "tokens": [
            {
                "denom": "tx-core1qzx9zjv0uke5fvwmjm30rlttmumrev6mzgkc48",
                "issuer": "core1qzx9zjv0uke5fvwmjm30rlttmumrev6mzgkc48",
                "supply": 1.0e+25,
                "subunit": "tx"
            },
            {
                "denom": "xrpl11f82115a5-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz",
                "issuer": "core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz",
                "supply": 8.15527637389e+24,
                "subunit": "xrpl11f82115a5"
            },
            {
                "denom": "cheeeze-core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk",
                "issuer": "core1lym69yprfhjzyspl52kaffawlak20km7m0f3sk",
                "supply": 4.99e+24,
                "subunit": "cheeeze"
            },
            {
                "denom": "xrpl64430c4512-core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz",
                "issuer": "core1zhs909jp9yktml6qqx9f0ptcq2xnhhj99cja03j3lfcsp2pgm86studdrz",
                "supply": 2.375161818e+24,
                "subunit": "xrpl64430c4512"
            },
            {
                "denom": "dex11-core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4",
                "issuer": "core1xkv90l09g3mmu3tt5ts2jydkh8t47ud35cuat4",
                "supply": 1.0e+24,
                "subunit": "dex11"
            },
            {
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/tokens-by-issuer` — Smart tokens issued by an address

**Parameters:**
- `issuer` (query, required, string) — Issuer core1… address Example: `core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq`
- `limit` (query, optional, string) — Number of tokens (1-200) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/coreum-api/v1/tokens-by-issuer?issuer=core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq&limit=20"
```

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "count": 1,
        "total": 1,
        "issuer": "core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
        "tokens": [
            {
                "uri": "https://www.instagram.com/magnetictoneofpurpose/",
                "admin": "core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
                "denom": "aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
                "issuer": "core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
                "symbol": "Hoailona",
                "subunit": "aloha22",
                "version": 1,
                "features": [
                    "burning",
                    "ibc",
                    "dex_unified_ref_amount_change"
                ],
                "burn_rate": 0.001,
                "precision": 8,
                "description": "Ho'Ailona is a Native Hawai'ian (kama'aina) Owned Physical + Digital Specialty Boutique Featuring The Most Exclusive Limited Edition Hawai'ian Apparel and Art Collections.",
                "globally_frozen": false,
                "send_commission_rate": 0.001
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:18.759Z",
        "request_id": "9990d187-e5e3-488a-aacf-0b5f05f3cadc"
    },
    "status": "ok",
    "message": "Tokens by issuer retrieved successfully",
    "success": true
}
```

### Staking

#### `GET /v1/staking` — Staking pool, bonded ratio & params

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

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "denom": "CORE",
        "params": {
            "bond_denom": "ucore",
            "max_validators": 64,
            "unbonding_time": "604800s",
            "min_commission_rate": "0.050000000000000000"
        },
        "bonded_ratio": 0.991794,
        "bonded_tokens": 2511782237.521431,
        "not_bonded_tokens": 20782534.343505
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:18.924Z",
        "request_id": "15aeb2a5-9ddd-49eb-9216-79db01ad567a"
    },
    "status": "ok",
    "message": "Staking retrieved successfully",
    "success": true
}
```

#### `GET /v1/validators` — Bonded validator set by voting power

**Parameters:**
- `limit` (query, optional, string) — Number of validators (1-200) Example: `20`

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

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "count": 20,
        "validators": [
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "007TX",
                "website": "https://x.com/007TXValidator",
                "voting_power": 442646469.097159,
                "commission_rate": 0.05,
                "operator_address": "corevaloper1x9hd9r7duv2gagztvvqlw94v5gy4zd9xwhqnlm"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "BRW Capital",
                "website": "https://x.com/BRW_Solo",
                "voting_power": 208174251.245463,
                "commission_rate": 0.05,
                "operator_address": "corevaloper1p2zujexcdg7vuxjkfvahnwhutqradsjfzp6r99"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "cosmosrescue",
                "website": "https://cosmosrescue.com",
                "voting_power": 41770876.094578,
                "commission_rate": 0.05,
                "operator_address": "corevaloper1xrd2petz764advyjm7ftu37jn32ueglqe7qyeg"
            },
            {
                "jailed": false,
                "status": "BOND_STATUS_BONDED",
                "moniker": "ECO Stake 🌱 | REStake.app",
                "website": "https://ecostake.com",
                "voting_power": 33680990
…(truncated, see openapi.json for full schema)
```

### Chain

#### `GET /v1/block` — Latest block

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

**Response:**
```json
{
    "data": {
        "time": "2026-06-15T02:10:17.774501357Z",
        "chain": "coreum-mainnet-1",
        "height": 76491113,
        "num_txs": 0,
        "proposer_address": "jIPfx29lVl0Mbk/8/WQ4nclRrJc="
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:19.198Z",
        "request_id": "63b99741-be6e-4ba1-a881-d02d4249ea4a"
    },
    "status": "ok",
    "message": "Block retrieved successfully",
    "success": true
}
```

#### `GET /v1/supply` — Total CORE supply

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

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "denom": "CORE",
        "micro_denom": "ucore",
        "total_supply": 101972687379.83263,
        "total_supply_micro": "101972687379832629"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:19.329Z",
        "request_id": "7646821d-c95f-4189-bb42-2b7a34394ae9"
    },
    "status": "ok",
    "message": "Supply retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Chain metadata & endpoint guide

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

**Response:**
```json
{
    "data": {
        "chain": "coreum-mainnet-1",
        "token": "CORE",
        "source": "Coreum public Cosmos REST/LCD, keyless (3-mirror)",
        "network": "Coreum",
        "decimals": 6,
        "examples": {
            "token": "/v1/token?denom=aloha22-core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq",
            "tokens": "/v1/tokens?limit=20",
            "tokens_by_issuer": "/v1/tokens-by-issuer?issuer=core1hxmw2fe3unnsw8uq522l9t2cfwaqgddne8nlqq"
        },
        "endpoints": {
            "/v1/block": "latest block (height, time, chain_id)",
            "/v1/token": "full smart-token detail incl. features, burn_rate, send_commission_rate, admin (denom)",
            "/v1/supply": "total CORE supply",
            "/v1/tokens": "registry of issued smart fungible tokens (denom, issuer, on-chain supply; limit)",
            "/v1/staking": "staking pool, bonded ratio and params",
            "/v1/validators": "bonded validator set ranked by voting power (limit)",
            "/v1/tokens-by-issuer": "smart tokens issued by an address (issuer, limit)"
        },
        "micro_denom": "ucore",
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:19.401Z",
        "request_id": "9db5f842-f3ea-42e4-a875-b3e3d261ceff"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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