{"openapi":"3.1.0","info":{"title":"Sui API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/sui-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Coin"},{"name":"Network"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"Address SUI balance + all coins","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Sui address (0x…)","schema":{"type":"string"},"example":"0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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"},{"coin_type":"0x4d9a296112617d6a6b3a510f4aa0d1c691ef44e2f0c6776a3fceee10695d4071::suisei::SUISEI","coin_object_count":1,"total_balance_raw":"1000000000000"},{"coin_type":"0xb46b22da9c0e0f2a69b920c9dc488d3d4ab0475d89814df815a33a8638e4c008::win98ai::WIN98AI","coin_object_count":1,"total_balance_raw":"98000000000"},{"coin_type":"0xbbce7373daaa483c16c83fd02df7078de4b9662f1f85076dded07db7b5ccf570::usdt::USDT","coin_object_count":1,"total_balance_raw":"20934631274"},{"coin_type":"0x7998588d7f966b0a4238f61f89fff471e56cdb6b61e49660b30d5d7bbeea926e::my_coin::MY_COIN","coin_object_count":1,"total_balance_raw":"1000000000"},{"coin_type":"0xafb973621c73158fc211507fec6b6c02a6311e498f07344c066e70f41b5249c2::congratulationsyouwon1000suiclaimyourgainnowatwwwsuilotterycom::CONGRATULATIONSYOUWON1000SUICLAIMYOURGAINNOWATWWWSUILOTTERYCOM","coin_object_count":1,"total_balance_raw":"1000000000"},{"coin_type":"0x20877247d54f9e206ef3bfb64023b662dd6f0c8cbf1641ddb958fd06bc9e15db::my_coin::MY_COIN","coin_object_count":1,"total_balance_raw":"1000000000"},{"coin_type":"0x11aa7e21acd15b1a25fe375b1b3c7aef6c1b3dec3522b812d0d521e90f61557e::rsui::RSUI","coin_object_count":1,"total_balance_raw":"772282199"},{"coin_type":"0x492ff7bc419c2502604980c486aa291d48f7ffc10e8073f38c59329491f106d5::coin::COIN","coin_object_count":1,"total_balance_raw":"100000000"},{"coin_type":"0x839e59fae416e39f9b6e839a4f6cfeb6794f1e79b5c2f64e123c7cfdd344960a::music::MUSIC","coin_object_count":1,"total_balance_raw":"80800"},{"coin_type":"0xf98e311a68e30562cb85a88b069714f9fd819ded2f55a510083fd03719dc2e1e::SUWING::SUWING","coin_object_count":1,"total_balance_raw":"1000"}],"sui_balance":8394.58843534,"coin_type_count":16,"sui_coin_objects":3},"meta":{"timestamp":"2026-06-10T14:02:37.841Z","request_id":"133a1603-62a4-431a-adb3-fe6bbfe3af0d"},"status":"ok","message":"Account retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/objects":{"get":{"operationId":"get_v1_objects","tags":["Account"],"summary":"Move objects an address owns","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Sui address (0x…)","schema":{"type":"string"},"example":"0x2761e3db0abe9a2029291980ebad551b7c68dd53d1150adfa9f9ed8a2368458e"},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":"0x16bb04fe05042eb96b91c46ca6125f126dab9b45f788d6ddaeefda6ceeb33e79"},{"type":"0x2::coin::Coin<0xafb973621c73158fc211507fec6b6c02a6311e498f07344c066e70f41b5249c2::congratulationsyouwon1000suiclaimyourgainnowatwwwsuilotterycom::CONGRATULATIONSYOUWON1000SUICLAIMYOURGAINNOWATWWWSUILOTTERYCOM>","version":"2355166","object_id":"0x1a0e2c784f4806073c8f6d1292b590b4b5e7f31a981e4b82b65021e327a83fc7"},{"type":"0x7cc71f76038a61301ca9a03fc036a7cbe5c786b2492128d35d9fb668b947626f::movexnft5998::NFT","version":"447842510","object_id":"0x1c430636a22f14f956b6ae2d5038e70cdbc2eee7984b5d2f0b2dfb3bfd92546a"},{"type":"0x2870905c348dea8404d20321a147f3e2805d56b7e9c1a4d13c2292093a107b94::nft::MyNFT","version":"897381147","object_id":"0x1cff06dc4659be83cff8ac47d48523b18c453d4b442a368270c163d1e7dc6697"},{"type":"0xa465c62a90025ecc9afcfbd77365a01f3c2e5503db6751276ce13c2e23fb2fce::create_ticket::Ticket","version":"413057716","object_id":"0x32953c908ab2336a539c55c4abd35a4ff400a43e6438910926c6ac5d064bceee"},{"type":"0x61c9c39fd86185ad60d738d4e52bd08bda071d366acde07e07c3916a2d75a816::distribution::DEEPWrapper","version":"81729642","object_id":"0x34e2167dc812d8af1050f5c52358bd4ddf29dec36b442e33f741d88552adac85"},{"type":"0x2::coin::Coin<0xdaad8f87d4cfcc076dc5c37dc77e8d837bb73ae883e84e84d04bdd77b6eeaedc::RewardSui::REWARDSUI>","version":"299759979","object_id":"0x3649ffdd956f47f22562ebe6df6087cdc65750e1cf2dce2e4fb3c62dfc32b8e0"},{"type":"0x2::coin::Coin<0x492ff7bc419c2502604980c486aa291d48f7ffc10e8073f38c59329491f106d5::coin::COIN>","version":"343849759","object_id":"0x39d036d9951a75d0d70e13ad464f90a36b4566743218e8a386e438fb46a239ad"},{"type":"0x2::coin::Coin<0xf98e311a68e30562cb85a88b069714f9fd819ded2f55a510083fd03719dc2e1e::SUWING::SUWING>","version":"2602924","object_id":"0x3c9b087922964545e764afa38c16082410fef8abb72591cf30a225f7add6289d"},{"type":"0x58156e414780a5a237db71afb0d852674eff8cd98f9572104cb79afeb4ad1e9d::suinet::SUITOMAINNET","version":"3484850","object_id":"0x4070523a44ad17d3a05569c6d23479dc91c4d96a73cf8d41e6d67721613a159b"},{"type":"0xa885fdf6651d3817d7240ca64c711ea88f59acce07573757f80fa94ccb37f1a3::MINER::SUIVE","version":"428334989","object_id":"0x42d485f16a79e76c555944f7c909bbf239bfa5df6093c18ca3d72bbc75ae8671"},{"type":"0x5c11ab64805ffdd4c05deffa870226d39740e05dc338428e6697ce3339144dc7::nft::MyNFT","version":"639102920","object_id":"0x434bf8ad02d150efc01be70689e8be3495f42c00a8e75fabc70c7d7cb5a2a0aa"},{"type":"0x4e37a91331f3ca0aa8ffe06df6caa715b28311cc960d77fbac0b4443bac2088c::liquid::Scallop","version":"78052662","object_id":"0x45e9a01dd94e2f19bb48de11aa7b2ef56a27bfb079efb7052a6fffc825db7e18"},{"type":"0x2::coin::Coin<0xbbce7373daaa483c16c83fd02df7078de4b9662f1f85076dded07db7b5ccf570::usdt::USDT>","version":"415614262","object_id":"0x4791695c597af88610e25cfdcea529faa0d215458ec88501c679711b82f83b8a"},{"type":"0x6e0fb7a0b131fee1c99708e3f3a660c9f4f3aa65d4113823200d0cae6ea57035::nft::MyNFT","version":"897381354","object_id":"0x4a47b21bdac402c8d4f8b719f4e65dcf7ac68b5e1fd410e126e9bf5d6796bbaa"},{"type":"0x2::coin::Coin<0x7998588d7f966b0a4238f61f89fff471e56cdb6b61e49660b30d5d7bbeea926e::my_coin::MY_COIN>","version":"673310907","object_id":"0x4cb11eb6a58e982deba581e9bd1a206b89e37f99e497fc98d1d211f11be6d47b"},{"type":"0x0c0cce78404163f029760ae286d345fab11dcbc004412c6d26cbaa0e71e1694d::cdnft::TICKET_NFT","version":"417354616","object_id":"0x4fd46f4c617212127755b894acd9e9305991bd1ddd9e46bc9e72e3489a8f4cf9"},{"type":"0x2::coin::Coin<0x11aa7e21acd15b1a25fe375b1b3c7aef6c1b3dec3522b812d0d521e90f61557e::rsui::RSUI>","version":"504035606","object_id":"0x5eef304764deaae7c59264b2a6f44340278c45173b630cbad14883da3855b2f9"},{"type":"0x2::coin::Coin<0x2::sui::SUI>","version":"913882602","object_id":"0x676f234b527d3c0c696a8b18b867d8efae7f5fdc511f0337562dbacd1abf5ca8"},{"type":"0xd46e0fdcd0f747afd47966121077cd2f3756723ec3ff17b90108ddb600f62448::nft_claim::SendClaimNFT","version":"446024654","object_id":"0x6bc20a6607b5e0f425ccb228da9180404b635b157e8f915586cb2f09b8cd858c"},{"type":"0xeb93f1c83120c1558038c2c7edbf403c0c09f2d17ad783cf3174df6d95aac25d::movexnft7788::NFT","version":"435693705","object_id":"0x74b1e1e9c88c27845718e9882b0e7e36e3a5e8754267bd2933525013511eb143"}],"has_next_page":true},"meta":{"timestamp":"2026-06-10T14:02:38.071Z","request_id":"c88d102a-64fe-41f8-81e8-4442dcdb04f4"},"status":"ok","message":"Objects retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/coin":{"get":{"operationId":"get_v1_coin","tags":["Coin"],"summary":"Coin metadata + total supply","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"Coin type","schema":{"type":"string"},"example":"0x2::sui::SUI"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"Sui","source":"Sui","symbol":"SUI","decimals":9,"coin_type":"0x2::sui::SUI","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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":148000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3500,"monthly_call_quota":885000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8700,"monthly_call_quota":4700000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/sui-api"}