{"openapi":"3.1.0","info":{"title":"Stellar DEX (SDEX) Order Book & Trades API","version":"1.0.0","description":"The Stellar Decentralized Exchange (SDEX) central-limit order book, live from the public Stellar Horizon API — no key, nothing cached. Where the pools reader covers Stellar's AMM and the asset reader covers token metadata, this surfaces the on-chain order book the others miss. Pull the live bids and asks for any asset pair with their price and amount, plus the derived best bid, best ask, mid price and spread. Get a compact ticker for a pair — best bid/ask, mid, spread and the last executed trade. And read the most recent executed trades, network-wide or filtered to a single pair, with their price and base/counter amounts. Defaults to the deeply-traded XLM/USDC pair; quote any pair by passing the selling and buying assets (asset code plus issuer, or XLM for native). The order-book-and-trading layer for Stellar wallets, swap UIs, market-makers and analytics. Live from horizon.stellar.org.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stellardex-api","description":"oanor gateway"}],"tags":[{"name":"Order Book"},{"name":"Ticker"},{"name":"Trades"},{"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/orderbook":{"get":{"operationId":"get_v1_orderbook","tags":["Order Book"],"summary":"Live order book for a pair (bids/asks, best bid/ask, mid, spread)","description":"","parameters":[{"name":"selling","in":"query","required":false,"description":"Selling asset code (XLM for native); default XLM","schema":{"type":"string"},"example":"XLM"},{"name":"buying","in":"query","required":false,"description":"Buying asset code; default USDC","schema":{"type":"string"},"example":"USDC"},{"name":"buy_issuer","in":"query","required":false,"description":"Issuer of the buying asset (required for non-native)","schema":{"type":"string"},"example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"},{"name":"limit","in":"query","required":false,"description":"Order book depth (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"asks":[{"price":0.186428,"amount":4476.9567818},{"price":0.1864281,"amount":4759.1384341},{"price":0.1865438,"amount":5000},{"price":0.1865458,"amount":5000},{"price":0.18655239,"amount":8000},{"price":0.18662528611755896,"amount":226.8538417},{"price":0.18665489000000002,"amount":5000},{"price":0.1866549,"amount":1000},{"price":0.18670004863536266,"amount":219.7724838},{"price":0.18674819,"amount":2400},{"price":0.1867482,"amount":1000},{"price":0.18684139,"amount":1600},{"price":0.1868414,"amount":1000},{"price":0.1869346,"amount":1000},{"price":0.18699928603672591,"amount":226.8538405},{"price":0.1870452,"amount":26.8384322},{"price":0.1870666,"amount":26.8353598},{"price":0.18707419807932418,"amount":219.772483},{"price":0.1871455,"amount":3.5288784},{"price":0.1871456,"amount":1.7426758}],"bids":[{"price":0.18621516193642912,"amount":0.1977219},{"price":0.18614078717486998,"amount":1.5186144},{"price":0.18613701,"amount":0.235806},{"price":0.1861358,"amount":930.679},{"price":0.18613388547096404,"amount":562.8113524},{"price":0.1861338,"amount":930.6689999},{"price":0.186039,"amount":524.62998},{"price":0.1859677,"amount":900.6569523},{"price":0.1859607205955608,"amount":100},{"price":0.1858762,"amount":39.3412946},{"price":0.18584347719687525,"amount":0.1977219},{"price":0.1858408,"amount":5},{"price":0.18576925058938082,"amount":1.5186144},{"price":0.1854725302199667,"amount":0.1977219},{"price":0.18539845177090097,"amount":1.5186144},{"price":0.1852816,"amount":4.9999999},{"price":0.185168,"amount":35086.9843664},{"price":0.185,"amount":347.2501499},{"price":0.1849468,"amount":334.2305978},{"price":0.184898,"amount":53541.3927458}],"note":"Live Stellar DEX order book for the asset pair: bids and asks with price (in buying per selling) and amount, plus the derived best bid/ask, mid and spread. Defaults to XLM/USDC; pass selling & buying (code + issuer; XLM for native).","buying":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","source":"Stellar Horizon","spread":0.0002128,"selling":"XLM","best_ask":0.186428,"best_bid":0.18621516193642912,"mid_price":0.18632158096821455,"spread_pct":0.1142},"meta":{"timestamp":"2026-06-14T08:03:47.814Z","request_id":"f9232d98-2c7b-463e-88b6-2f1a4cced741"},"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/ticker":{"get":{"operationId":"get_v1_ticker","tags":["Ticker"],"summary":"Compact pair ticker: best bid/ask, mid, spread, last trade","description":"","parameters":[{"name":"selling","in":"query","required":false,"description":"Selling asset code; default XLM","schema":{"type":"string"},"example":"XLM"},{"name":"buying","in":"query","required":false,"description":"Buying asset code; default USDC","schema":{"type":"string"},"example":"USDC"},{"name":"buy_issuer","in":"query","required":false,"description":"Issuer of the buying asset","schema":{"type":"string"},"example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A compact Stellar DEX ticker for the pair: best bid/ask, mid price, spread and the last executed trade. Defaults to XLM/USDC; pass selling & buying to quote any pair.","buying":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","source":"Stellar Horizon","spread":0.0002128,"selling":"XLM","best_ask":0.186428,"best_bid":0.18621516193642912,"mid_price":0.18632158096821455,"last_trade":{"time":"2026-06-14T08:03:43Z","price":0.186428},"spread_pct":0.1142},"meta":{"timestamp":"2026-06-14T08:03:48.139Z","request_id":"c1149f8b-09ca-4a37-b138-789cba972348"},"status":"ok","message":"Ticker 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/trades":{"get":{"operationId":"get_v1_trades","tags":["Trades"],"summary":"Recent executed trades, network-wide or for a pair","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of trades (1-100)","schema":{"type":"string"},"example":"25"},{"name":"selling","in":"query","required":false,"description":"Optional: base asset code to filter a pair","schema":{"type":"string"},"example":"XLM"},{"name":"buying","in":"query","required":false,"description":"Optional: counter asset code","schema":{"type":"string"},"example":"USDC"},{"name":"buy_issuer","in":"query","required":false,"description":"Issuer of the counter asset","schema":{"type":"string"},"example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Most recent executed trades on the Stellar DEX (newest first). Without a pair this is the network-wide trade feed; pass selling & buying to filter to one pair. price is counter per base.","pair":"XLM / USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","count":25,"source":"Stellar Horizon","trades":[{"price":0.186428,"base_asset":"XLM","base_amount":0.0009596,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001789,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010068,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001877,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010078,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001879,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0002032,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0002032,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0007219,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0007219,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:43Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0007219,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:37Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0007219,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:37Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0002032,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.186428,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0002032,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.1863924,"base_asset":"XLM","base_amount":0.0004431,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":8.26e-5,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.1863924,"base_asset":"XLM","base_amount":0.0009099,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001696,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.1863924,"base_asset":"XLM","base_amount":0.0009109,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001698,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.1863924,"base_asset":"XLM","base_amount":0.0007803,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001455,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":19.4885361,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":3.6297186,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0007226,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0007226,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0006888,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001283,"ledger_close_time":"2026-06-14T08:03:31Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0006888,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001283,"ledger_close_time":"2026-06-14T08:03:25Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0007226,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001346,"ledger_close_time":"2026-06-14T08:03:25Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.000203,"ledger_close_time":"2026-06-14T08:03:25Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0010898,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.000203,"ledger_close_time":"2026-06-14T08:03:25Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0007803,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001454,"ledger_close_time":"2026-06-14T08:03:25Z"},{"price":0.18624891000871993,"base_asset":"XLM","base_amount":0.0009106,"counter_asset":"USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","base_is_seller":true,"counter_amount":0.0001696,"ledger_close_time":"2026-06-14T08:03:25Z"}]},"meta":{"timestamp":"2026-06-14T08:03:48.344Z","request_id":"6de6df05-fb83-4959-b401-dba92d56c119"},"status":"ok","message":"Trades 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"pair":"XLM/USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","mid_price":0.18632158096821455},"source":"public Stellar Horizon API (horizon.stellar.org /order_book, /trades), keyless","service":"stellardex-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/ticker":"Compact pair ticker: best bid/ask, mid, spread, last trade (default XLM/USDC).","GET /v1/trades":"Recent executed trades, network-wide or for a pair (limit; optional selling & buying).","GET /v1/orderbook":"Live order book for a pair: bids/asks, best bid/ask, mid, spread (selling, buying; default XLM/USDC)."},"description":"Read the Stellar Decentralized Exchange (SDEX) central-limit order book live from the public Horizon API: live bids/asks for any pair with derived best bid/ask, mid and spread; a compact pair ticker; and the most recent executed trades (network-wide or per pair). The order-book-and-trading layer for Stellar wallets, swap UIs and market-makers. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:48.447Z","request_id":"d69d2d3e-992b-41c8-97f9-7523fe2c8b0d"},"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":6800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1050,"monthly_call_quota":132000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3650,"monthly_call_quota":768000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9950,"monthly_call_quota":4900000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stellardex-api"}