# Sui API
> Live on-chain data from Sui (SUI), the high-throughput Layer 1 from Mysten Labs built on the Move language and an object-centric model, via a public Sui full-node JSON-RPC endpoint. Unlike account- or UTXO-based chains, on Sui everything an address owns is a typed Move object. Resolve an address's SUI balance together with every coin type it holds and how many distinct coins it owns. Read any coin type's metadata — its name, symbol, decimals and description — and its total on-chain supply. List the Move objects an address owns, each with its object id and fully-qualified type, the native unit of Sui ownership. Read the live chain state — the chain identifier, the current epoch, the latest checkpoint, the total transaction-block count, the reference gas price and the active validator count. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Hedera, Kaspa, Cosmos, Solana and EVM on-chain APIs and from price feeds — this is Sui's object-model account state, coins, owned objects and chain economics. Perfect for wallets, explorers and analytics apps.

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

## Pricing
- **Free** (Free) — 7,500 calls/Mo, 2 req/s
- **Starter** ($13/Mo) — 148,000 calls/Mo, 5 req/s
- **Pro** ($35/Mo) — 885,000 calls/Mo, 15 req/s
- **Business** ($87/Mo) — 4,700,000 calls/Mo, 40 req/s

## Endpoints

### Account

#### `GET /v1/account` — Address SUI balance + all coins

**Parameters:**
- `address` (query, required, string) — Sui address (0x…) Example: `0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e`

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

**Response:**
```json
{
    "data": {
        "source": "Sui",
        "address": "0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e",
        "balances": [
            {
                "coin_type": "0xa0d120fc2c9b61b5ba873b70a5a8259056dab1ab60126bce7c32b6e7170bfed3::aqua::AQUA",
                "coin_object_count": 1,
                "total_balance_raw": "7192073856537337"
            },
            {
                "coin_type": "0xbe89e7ab644129b3ade079113445a207dea3865add1bb8c23b73add6696a5971::sui::SUI",
                "coin_object_count": 1,
                "total_balance_raw": "38004030879413"
            },
            {
                "coin_type": "0x1917baa1f59bb204a39c8f3483fd5e89b96a645ac0360e57b5af2b1b0e72ec55::sui::SUI",
                "coin_object_count": 1,
                "total_balance_raw": "36131994931567"
            },
            {
                "coin_type": "0x2::sui::SUI",
                "coin_object_count": 3,
                "total_balance_raw": "8394588435340"
            },
            {
                "coin_type": "0xdaad8f87d4cfcc076dc5c37dc77e8d837bb73ae883e84e84d04bdd77b6eeaedc::RewardSui::REWARDSUI",
                "coin_object_count": 1,
                "total_balance_raw": "7961000000000"
            },
            {
                "coin_type": "0x47f389127ad7bfdd5b64dd532ba5e29495466c208b7ba2cc6a10a0a3a4610f3e::btcat::BTCAT",
                "coin_object_count": 1,
                "total_balance_raw": "4239769033534"
            },
  
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/objects` — Move objects an address owns

**Parameters:**
- `address` (query, required, string) — Sui address (0x…) Example: `0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e`
- `limit` (query, optional, string) — Max 1-50 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sui-api/v1/objects?address=0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "source": "Sui",
        "address": "0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e",
        "objects": [
            {
                "type": "0xc8ada8b9d295379f5c8128fa796b76ddfd8ab78be669463520a6df57d20e5719::my_hero::Hero",
                "version": "3733377",
                "object_id": "0x06a5a3f78c4c531dcdd414b66ff4ade57d909723b0083976608847a80ea1c988"
            },
            {
                "type": "0x2::coin::Coin<0x20877247d54f9e206ef3bfb64023b662dd6f0c8cbf1641ddb958fd06bc9e15db::my_coin::MY_COIN>",
                "version": "674543485",
                "object_id": "0x09cba290574cf3be1ffc4e6cb0ca74663b0c6ffa178ba67208927c197cb5b9c8"
            },
            {
                "type": "0x0691b5e74fa89c693e69c89ec2e5ed7c4e4f5468d1933a3c19e3ef3dba04712b::nft::MyNFT",
                "version": "893141722",
                "object_id": "0x12fb6a3d2e51999f47d92f653881b009331044aa7a4631106707a1726d2b7778"
            },
            {
                "type": "0x308ae623198db62737d72b43767168390fd2de64a6b40f9684c27fe9dd507a1f::cnsnft::TICKET_NFT",
                "version": "420239353",
                "object_id": "0x1556da01f408b94722d0f464136adaa8f9884e11e1b4ce96a2ab9a9ad32a3544"
            },
            {
                "type": "0xe225a56872ed7ad700bc4310923e719dfed1a8f74fee4f62ec0727d82db027bf::nft::MyNFT",
                "version": "639102946",
                "object_id": "0x16bb04fe0504
…(truncated, see openapi.json for full schema)
```

### Coin

#### `GET /v1/coin` — Coin metadata + total supply

**Parameters:**
- `type` (query, required, string) — Coin type Example: `0x2::sui::SUI`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/sui-api/v1/coin?type=0x2%3A%3Asui%3A%3ASUI"
```

**Response:**
```json
{
    "data": {
        "name": "Sui",
        "source": "Sui",
        "symbol": "SUI",
        "decimals": 9,
        "icon_url": null,
        "coin_type": "0x2::sui::SUI",
        "description": null,
        "total_supply": 10000000000,
        "total_supply_raw": "10000000000000000000"
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:38.417Z",
        "request_id": "d5968c89-110a-40c3-97e4-e0a8a0fad9c5"
    },
    "status": "ok",
    "message": "Coin retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Live chain state

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

**Response:**
```json
{
    "data": {
        "epoch": 1154,
        "source": "Sui",
        "epoch_start": "2026-06-10T00:05:19.523Z",
        "total_stake_sui": 7224439389.100764,
        "chain_identifier": "35834a8a",
        "protocol_version": 124,
        "latest_checkpoint": "285403002",
        "reference_gas_price": 100,
        "system_state_version": 2,
        "active_validator_count": 129,
        "total_transaction_blocks": "5333081645"
    },
    "meta": {
        "timestamp": "2026-06-10T14:02:39.172Z",
        "request_id": "27a3d26e-33e6-4f8a-9a73-15e946de752c"
    },
    "status": "ok",
    "message": "Network state retrieved successfully",
    "success": true
}
```


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