{"openapi":"3.1.0","info":{"title":"Stellar Asset API","version":"1.0.0","description":"Read live data on Stellar assets and the native Stellar DEX, straight from the public Horizon API — no key. Resolve any issued asset (code plus issuer) to its on-chain stats: total authorized supply, number of holding accounts, claimable-balance, liquidity-pool and Soroban-contract amounts, the authorization flags (auth required, revocable, clawback) that tell you how tightly the issuer controls it, and its Soroban contract id. List every issuer of an asset code to survey them and spot impersonators — anyone can issue an asset with any code, so verifying the exact issuer matters. And pull the live order book for an asset against XLM (or any counter asset) on Stellar's built-in decentralized exchange — best bid, best ask and the spread. Distinct from account-, payment- and transaction-level APIs: this is the asset-and-market layer for Stellar wallets, anchors, stablecoin issuers and trading tools. Live from the network; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stellarasset-api","description":"oanor gateway"}],"tags":[{"name":"Assets"},{"name":"DEX"},{"name":"Meta"}],"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/asset":{"get":{"operationId":"get_v1_asset","tags":["Assets"],"summary":"Asset stats: supply, holders, flags, contract id","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Asset code (1-12 alphanumeric)","schema":{"type":"string"},"example":"USDC"},{"name":"issuer","in":"query","required":true,"description":"Issuer account (G... 56 chars)","schema":{"type":"string"},"example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"On-chain stats for the issued asset from Horizon. supply is the total authorized balance; holders is the number of authorized accounts. flags show how the issuer controls the asset.","flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":true,"auth_clawback_enabled":false},"source":"Stellar Horizon","supply":"237989931.6834145","holders":2232017,"asset_code":"USDC","asset_type":"credit_alphanum4","contract_id":"CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75","asset_issuer":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","num_contracts":31411,"liquidity_pools":"2552155.8032734","contracts_amount":"42090356.8184738","claimable_balances":"21796.2979538","num_liquidity_pools":1008},"meta":{"timestamp":"2026-06-14T08:04:02.187Z","request_id":"a04a51b0-b82b-43aa-930b-90dbfdb2a71a"},"status":"ok","message":"Asset 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/assets":{"get":{"operationId":"get_v1_assets","tags":["Assets"],"summary":"All issuers of an asset code, sorted by holders","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Asset code","schema":{"type":"string"},"example":"USDC"},{"name":"limit","in":"query","required":false,"description":"Max issuers (1-200)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"code":"USDC","note":"Issuers of this asset code on the network (up to `limit`, sorted by holders within the returned page). Anyone can issue an asset with any code, so the same code often has many issuers — use this to survey them and spot impersonators; always verify the exact issuer account.","count":20,"limit":20,"assets":[{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":true,"auth_clawback_enabled":false},"supply":"237989931.6834145","holders":2232017,"asset_code":"USDC","asset_type":"credit_alphanum4","contract_id":"CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75","asset_issuer":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","num_contracts":31411,"liquidity_pools":"2552155.8032734","contracts_amount":"42090356.8184738","claimable_balances":"21796.2979538","num_liquidity_pools":1008},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"998548.3525583","holders":897,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA73UDEUTZQYSYC52THC6GMYRZGZ2N4TYMBKIPGPJLM5436RFKVSUSDC","num_contracts":0,"liquidity_pools":"311.4353726","contracts_amount":"0.0000000","claimable_balances":"0.0000857","num_liquidity_pools":5},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"2998817503.0230629","holders":456,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA3WU6UPBON23ZLI6WW4IFMJVOE2TLVHNPRCAJ43MVZI5DVO5KU7MLHH","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"19771.3668834","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"24172314168794.1757800","holders":320,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA2AZ7XYAUOIWIEGSV6WGQUDHTMVYIPJBGXCVG3ITVKOFEMK4TV6W35Q","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"100170595238.0952700","holders":80,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA2TYZ7TUVJQW663IX4Q52MI242NMTBFI5KYGOKKZYZX5O44W35744UU","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":true,"auth_clawback_enabled":true},"supply":"2555622129172.0164281","holders":55,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA4ZONZXVJADEB5PBNRBR7FKIITUNJQ44AAFCLPWDEI2R6P4IGXRADOD","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"54175004.9250000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"1585000924.0000000","holders":48,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA2RY3ZZPRGBWVKFEE3GULAZZN2NE6WSPJOTWVCSUKADDOVOI47PGJBY","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"423969350533.1364102","holders":29,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA24LJXFG73JGARIBG2GP6V5TNUUOS6BD23KOFCW3INLDY5KPKS7GACZ","num_contracts":0,"liquidity_pools":"123425708244.8343448","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":7},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"69504898360.8239636","holders":22,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA6UFYOPJ462NLISMGAOJMN6LIG43256LWDUM6TD4GCL6BHDVDGEF4LA","num_contracts":0,"liquidity_pools":"495101639.1760364","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":2},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"234.0000000","holders":13,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA4LNTKAIPHP5VPRVCEX44IM22HMNS2TWCHM4MEETHAWTH6R472XDKAN","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"186335000.0000000","holders":12,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA62BZ3M6FMKTKW7V54USDHCYZITNZYREDW3T6NICKCQMUX3MRR4FYX3","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":true,"auth_clawback_enabled":true},"supply":"9999.9999900","holders":7,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA5O7NTUIKYDPZSV3MNMIRFO2LCV5RJBNO7TNN7Y3MDO2IXRBSWDEO3T","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0100000","holders":3,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA5BUT4SND34VRUJGFEVLG6LMEYOU5HSSYZLX673I2IJVRLLPATMH4RN","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA3W3W2VZAVYGKAQNHD2QJGT27YKZQ5IVUNCKK5WA6HJGPNUE5ZSWY7O","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA42NGH3FSSIZPTNAMDVAMDYU2E3WHGXJBQQFRPYDZYQITKDPFKSPFBI","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA4KOE7HPGTXDVVNM2E3BJOHI4WXAECZVHI32J5KILSK7Y4ZX3IWHGLO","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"26999500.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA5ATGX25N4ES3CEZGH4JSUOORLS4YI4ZZF33KH6AKRT53LVJCQS3TRO","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA5LVEDC7M6RRWGWPCFBM6EKOP2W7RVIKOZVYLHE7K4U7JSO62EYRZO5","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"10000000.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA5ZLINQWRY2DRORJWXMQESAVT3C2KXX5KWXH36S7QBX2734DIAZQXRP","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0},{"flags":{"auth_required":false,"auth_immutable":false,"auth_revocable":false,"auth_clawback_enabled":false},"supply":"0.0000000","holders":1,"asset_code":"USDC","asset_type":"credit_alphanum4","asset_issuer":"GA63JUQAYJ4M4KUQGIVACW4IQJ2PT3BCTCXDDMAD25WLOOJKDM7ITYIR","num_contracts":0,"liquidity_pools":"0.0000000","contracts_amount":"0.0000000","claimable_balances":"0.0000000","num_liquidity_pools":0}],"source":"Stellar Horizon"},"meta":{"timestamp":"2026-06-14T08:04:02.526Z","request_id":"a0898c7d-408f-49b3-a9ed-b0f158771227"},"status":"ok","message":"Assets 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/orderbook":{"get":{"operationId":"get_v1_orderbook","tags":["DEX"],"summary":"Live DEX order book vs XLM or a counter asset","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Asset code","schema":{"type":"string"},"example":"USDC"},{"name":"issuer","in":"query","required":true,"description":"Issuer account (G...)","schema":{"type":"string"},"example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"},{"name":"counter_code","in":"query","required":false,"description":"Counter asset code (omit for XLM)","schema":{"type":"string"}},{"name":"counter_issuer","in":"query","required":false,"description":"Counter asset issuer (with counter_code)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"asks":[{"price":5.3724769,"amount":560.6832186},{"price":5.3753222,"amount":0.1977219},{"price":5.3774699,"amount":1.5186144},{"price":5.3783248,"amount":929.6575},{"price":5.3783303,"amount":0.2348009},{"price":5.3783827,"amount":929.6475},{"price":5.3799249,"amount":39.3412946},{"price":5.3809497,"amount":5},{"price":5.3831048,"amount":917.6521787},{"price":5.3832323,"amount":523.84884}],"bids":[{"price":5.3663269,"amount":5000},{"price":5.3662693,"amount":5000},{"price":5.3661225,"amount":4476.9351424},{"price":5.3661199,"amount":8000},{"price":5.3661196,"amount":4822.0633423},{"price":5.3635095,"amount":226.8538222},{"price":5.3613617,"amount":219.7724628},{"price":5.3599381,"amount":5000},{"price":5.3599378,"amount":2399.9999996},{"price":5.3574809,"amount":1600}],"note":"Live order book for the asset against the counter asset (XLM by default) on Stellar's built-in DEX. price is counter-per-selling; best_bid/best_ask/spread summarize the top of book.","buying":"XLM","source":"Stellar Horizon","spread":0.006149999999999878,"selling":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","best_ask":5.3724769,"best_bid":5.3663269,"spread_pct":0.11447233956464063},"meta":{"timestamp":"2026-06-14T08:04:02.729Z","request_id":"1c195bf9-6abd-4fa7-be60-07c54e30753a"},"status":"ok","message":"Order book 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"code":"USDC","holders":2232017},"source":"public Stellar Horizon API (horizon.stellar.org), keyless","service":"stellarasset-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/asset":"Asset stats: supply, holders, flags, contract id (code=USDC, issuer=G...).","GET /v1/assets":"All issuers of an asset code, sorted by holders (code=USDC).","GET /v1/orderbook":"Live DEX order book vs XLM or a counter asset (code, issuer, optional counter_code/counter_issuer)."},"description":"Read live Stellar asset and native-DEX data from the public Horizon API: resolve any issued asset to its supply, holders, flags and Soroban contract id; list every issuer of a code to find the canonical one; and pull the live order book for an asset against XLM. The asset-and-market layer for Stellar wallets, anchors and trading tools. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:02.806Z","request_id":"8f115b6d-b8e7-4379-b245-0aee1957f8cb"},"status":"ok","message":"Meta","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":5300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1170,"monthly_call_quota":115000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3950,"monthly_call_quota":725000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":11400,"monthly_call_quota":4600000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stellarasset-api"}