Developers / AXIS API

REST API

The AXIS API is a hosted HTTP service that serves quotes, depth, candles, tickers, orders and trade history for AXIS.

Base URLs#

Every endpoint is a GET request relative to the base URL. The push API is described in WebSocket API. Contract addresses and token contracts per network are in Networks and deployments.

The AXIS API and the indexer#

The AXIS API embeds the open-source indexer and adds routing and market data on top of it. The order, account and history endpoints come from the indexer, so you can serve them yourself by running the indexer with apiPort. Quotes, depth, candles, the 24h ticker and the WebSocket API exist only in the hosted service.

The API is not a Horizon drop-in. It has its own paths and response shapes: /depth replaces /order_book, /quote replaces /paths/strict-send and /paths/strict-receive, and /candles replaces /trade_aggregations. The full mapping is in Migrating from the Classic DEX.

Conventions#

Requests and responses#

• Responses are JSON (Content-Type: application/json). CORS is open (Access-Control-Allow-Origin: *), so a browser app can call the API directly.
• Add pretty_print to any query string (?pretty_print) to get indented JSON.
• There is no authentication. The Testnet service publishes no rate limits and gives no availability guarantee. Cache what you can and retry failed requests with a backoff.

Errors#

A failed request returns an HTTP error status and a JSON body with the same status:

{
  "error": "Bad request. Invalid parameter: \"amount\". Invalid asset amount: 1.5",
  "status": 400
}

An unknown path returns 404 with the plain-text body API endpoint was not found, not JSON.

Numbers, amounts and prices#

• Integers that may not fit a JSON number are strings: order IDs, amounts, prices, balances, allowances, trade IDs and cursors. Parse them with BigInt().
• Amounts in orders, trades, quotes and backing records are integer base units of the token. For a 7-decimal asset 1 token is 10000000 base units (stroops), so "10000000" XLM is 1 XLM.
• Order price and quote worstPrice are contract prices in the maker's terms: the order's buying base units per 1 selling base unit, times 10^18, as integer strings. For a quote hop, worstPrice is units of the hop's selling asset per 1 unit of its buying asset. The "4533027867695422232" of an XLM to USDC hop means 4.533 XLM per USDC, which is also the token price when both assets have 7 decimals. See Prices and rounding.
• rprice (orders) and price (trades and swaps) are floating-point approximations for display. Never compute with them.
• The market data endpoints /depth, /candles and /ticker/24h return decimal strings in token units, with prices in quote asset per base asset. They convert with 7 decimals, which covers every Testnet asset.

Assets#

• Input. /quote and the market parameter of /depth and /candles accept XLM (also xlm or native), CODE:ISSUER, CODE-ISSUER or a token contract address (C...). The asset and pair filters of the order and history endpoints accept contract addresses only.
• Output. Every asset in a response is a token contract address. A Classic asset appears as the address of its Stellar Asset Contract (SAC). The Testnet addresses are listed in Networks and deployments.
• Market keys. Markets use the contract's canonical pair order base/quote: the base asset is the first of the pair, comparing the XDR bytes of the addresses, not their strings. On Testnet EURC (CCUU...) comes before CETES (CC72...). /ticker/24h, /markets and /contract report pairs as base/quote in that order, while the pair filters accept either order. /depth and /candles answer in the orientation you request. Take the pair order from the API or from canonicalPair in the JS client instead of sorting strings.

Timestamps#

The JS client exports parseApiDate, which turns the first format into UNIX milliseconds.

Pagination#

List endpoints take a limit and an exclusive cursor. To get the next page, pass the cursor field of the last row you received: rows up to and including it are skipped. A missing, invalid or non-positive limit falls back to the default, and a larger one is capped at the maximum without an error.

An order cursor is the position of the event that created the order, not the order ID. Order IDs are hashes and cannot be used for paging. There is no order parameter on these endpoints.

Status#

GET /#

Service status with 24-hour activity totals. No parameters.

curl "https://demo-api.axis.markets/?pretty_print"

{
  "status": "active",
  "ts": "2026-10-03T13:02:57Z",
  "ledger": 5001797,
  "frozen": false,
  "trades": 7407,
  "volumes": [
    {
      "symbol": "XLM",
      "volume": "337.8988296",
      "quoteVolume": "1535.9037711"
    },
    {
      "symbol": "USDC",
      "volume": "176.8586151",
      "quoteVolume": "176.8586151"
    }
  ]
}

Notes:

• trades and volumes are display statistics for the Testnet demo. Use GET /ticker/24h for per-market numbers.
• A self-hosted indexer answers / with a different body. See Indexer.

Quotes#

GET /quote#

Finds the best routes to sell or buy an amount and returns, for every hop, the order IDs to list in the contract call. Routes cross AXIS orders only, with up to 3 hops and at most 20 orders per route.

Best first means the largest bought for strict_send and the smallest sold for strict_receive.

Sell 1 XLM for USDC:

curl "https://demo-api.axis.markets/quote?sellingAsset=XLM&buyingAsset=CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA&amount=10000000&pretty_print"

The response had five routes. The first two are shown: the direct market, then a route through CETES.

{
  "id": "11SeGAvxf58UkqTUmFqYVug4kFP1C5b",
  "status": "success",
  "direction": "strict_send",
  "sellingAsset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "buyingAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
  "ledger": 5002005,
  "paths": [
    {
      "sold": "9999997",
      "bought": "2214341",
      "path": [
        {
          "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
          "buying": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
          "orders": [
            "137718931818025766751180795007231811965",
            "184698105807936084996517827088767859297",
            "299866619951502789575135247958256408905"
          ],
          "worstPrice": "4533027867695422232"
        }
      ]
    },
    {
      "sold": "10000000",
      "bought": "2155581",
      "path": [
        {
          "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
          "buying": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
          "orders": [
            "175245839230035109306050965350899990272",
            "89852153929209626508254613737130759476",
            "232378621713006620607546476115974255717"
          ],
          "worstPrice": "306278225835597445"
        },
        {
          "selling": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
          "buying": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
          "orders": [
            "313816668188901862683843128148848998865",
            "129296712244998878869388841874484106102",
            "114712043550087556363802578784900576007"
          ],
          "worstPrice": "15385141000000000000"
        }
      ]
    }
  ]
}

Buy exactly 0.1 USDC with XLM on the direct market:

curl "https://demo-api.axis.markets/quote?sellingAsset=XLM&buyingAsset=CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA&amount=1000000&direction=strict_receive&direct=true&pretty_print"

{
  "id": "11SeGB56R1VGqHNnQr4AB4ruhZcTjWy",
  "status": "success",
  "direction": "strict_receive",
  "sellingAsset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "buyingAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
  "ledger": 5002015,
  "paths": [
    {
      "sold": "4505409",
      "bought": "1000000",
      "path": [
        {
          "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
          "buying": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
          "orders": [
            "137718931818025766751180795007231811965",
            "184698105807936084996517827088767859297"
          ],
          "worstPrice": "4515608426305947824"
        }
      ]
    }
  ]
}

An amount the book cannot fill returns HTTP 200 with unfeasible:

{
  "id": "11SeGB58Ds24A7Zr7LyyZ5WvdV9qDrK",
  "status": "unfeasible",
  "direction": "strict_send",
  "sellingAsset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "buyingAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
  "ledger": 5002016,
  "paths": [],
  "error": "Not enough liquidity on the DEX."
}

Notes:

• The quote mirrors contract settlement. It admits a fill only when the maker's remaining backing covers all of it, and skips a partially backed order otherwise (see Effective depth). It rounds like the contract (the taker's output down, the cost up) and leaves out orders the contract would skip: makers without backing, makers that cannot receive the asset you pay, makers whose trustline has no room for the payment (which would fail the whole call), orders close to expiration, dust orders and makers the contract skipped recently. Multi-hop routes, executed as a strict swap, also leave out makers whose backing record still awaits confirmation.
• unfeasible means no route fills the whole amount with backed liquidity within 20 orders. With maxPrice, it means that no backed order is priced within the limit.
• With maxPrice, the quote is the crossing of a limit order rather than a swap: one hop over the orders priced up to the limit, best first, at most 20 of them. A partial fill is a valid result, so sold and bought can be well below amount. The rest of the limit order goes on the book. For a limit sell at contract price p, pass maxPrice = floor(10^36 / p). For a limit buy, pass p itself. These are the thresholds the contract compares maker prices with.
• With strict_send, sold can be slightly below amount. Input worth less than one base unit of the output at the route's prices stays with the trader. Above, the direct route uses 9999997 of the 10000000 stroops.
• direction accepts strict_receive as the only alternative. Any other value, including a typo, silently becomes strict_send.
• While the contract is frozen, every quote returns status: "rejected", empty paths and the error Trading is suspended: the AXIS contract is frozen.
• A quote whose buyingAsset requires issuer authorization the AXIS contract does not have is rejected too, with an error that explains it. The makers' assets pass through the contract, so buying such an asset fails with IntermediaryCannotReceive (712) until the issuer authorizes the contract. No route buys such an asset at an intermediate hop either.
• HTTP 409 means the service is not ready, for example while its orderbook is still empty after a restart, or that routing failed. While the service is not ready, every /quote call returns 409, even an invalid one. Retry later.
• Routes are alternatives computed independently and can share orders. Use one route per transaction.
• A quote reserves nothing. Orders can be filled, changed or removed before your transaction lands, and the contract skips the ones that are gone. Re-quote right before you ask for a signature. See Using a quote in a contract call.

Market data#

GET /depth#

Aggregated orderbook of one market around the mid price, counting only backed amounts.

Prices are in quote asset per base asset and quantities in base asset tokens, both decimal strings.

curl "https://demo-api.axis.markets/depth?market=XLM/CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA&limit=3&pretty_print"

{
  "ledger": 5002320,
  "timestamp": 1791035191,
  "step": "0.00001",
  "bestBid": "0.22259541",
  "bestAsk": "0.22630216",
  "bids": [
    [
      "0.22259",
      "0.3322822"
    ],
    [
      "0.22108",
      "0.3362188"
    ],
    [
      "0.21885",
      "0.11365"
    ]
  ],
  "asks": [
    [
      "0.22631",
      "0.5910125"
    ],
    [
      "0.22682",
      "0.5362911"
    ],
    [
      "0.22689",
      "0.8402956"
    ]
  ]
}

Notes:

• Levels are conservative. A bid is rounded down and an ask up to its level, so a limit order at a level price crosses every order in that level. With step=0.05, a bid at 0.33333 shows at 0.3 and an ask at 0.342 at 0.35.
• Only backed amounts count. A maker's budget, min(balance, allowance) in the token they sell, is shared by their orders in price order within the market. Orders the contract would skip are left out here too. Unlike a quote, depth does not check the maker's trustline room for the payment or whether the AXIS contract can hold the asset, so a quote can list fewer orders than depth shows.
• AXIS does not match on-chain, so the book can be crossed. In a crossed book, levels on the wrong side of the mid price are left out of bids and asks, while bestBid and bestAsk still report the best prices.

GET /candles#

OHLCV candles of one market, built from indexed fills.

The response is an array of tuples:

Hourly XLM/USDC candles since a given hour:

curl "https://demo-api.axis.markets/candles?market=XLM/CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA&resolution=1h&from=1791018000&pretty_print"

The response had five candles. The two newest are shown:

[
  [
    1791032400,
    "0.2230679",
    "0.2250866",
    "0.2220688",
    "0.2221951",
    "3.2746726",
    "0.7308724",
    13
  ],
  [
    1791028800,
    "0.2201979",
    "0.2259326",
    "0.2159081",
    "0.2223594",
    "9.6849475",
    "2.1374418",
    36
  ]
]

Notes:

• Always pass from. It defaults to 0, so a request without it covers a window in 1970 and returns [].
• A window holds at most 200 candles. A longer one is coarsened to the smallest standard resolution that fits: 24 hours at 5m (288 candles) comes back as 15m candles. Check the spacing of the timestamps when you request wide windows.
• Without resolution, the service picks one from the window. With neither resolution nor to, it uses 2w.
• Buckets are aligned to multiples of the resolution since the UNIX epoch, and from and to apply at 5-minute granularity. Align from to the resolution to get a complete first candle.
• A period without fills has no candle. Fill the gaps in your chart.
• Candles count fills (trade records) only. The fills of a multi-hop swap count in the market of each hop, and the swap record itself is not counted. The taker order fill of a crossfill (crossfill: true) is left out too, since its amounts mirror the makers' fills.
• The reverse orientation inverts the prices (high and low swap places) and swaps the two volumes.

GET /ticker/24h#

24-hour statistics of every market. No parameters.

curl "https://demo-api.axis.markets/ticker/24h?pretty_print"

The response had six entries. The first two are shown:

{
  "ledger": 5001979,
  "timestamp": 1791033489,
  "ticker": [
    {
      "symbol": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC/CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
      "openPrice": "0.3077308",
      "highPrice": "0.3140691",
      "lowPrice": "0.2879428",
      "lastPrice": "0.3046354",
      "volume": "2732.610373",
      "quoteVolume": "819.7259556",
      "change": -1.006,
      "avgPrice": "0.2999791",
      "trades": 2890
    },
    {
      "symbol": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ/CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
      "openPrice": "5.450887",
      "highPrice": "5.715252",
      "lowPrice": "5.274388",
      "lastPrice": "5.555403",
      "volume": "66.5128764",
      "quoteVolume": "364.2570939",
      "change": 1.917,
      "avgPrice": "5.47649",
      "trades": 1248
    }
  ]
}

The first entry is CETES/XLM: 2,732.6 CETES traded at a last price of 0.3046 XLM per CETES.

Notes:

• The window is the last 24 hours, exact to the fill.
• Every known market is listed: the markets opened on-chain and every pair with live orders. A market without fills in the window reports "0" prices and volumes and trades: 0.
• Entries are sorted by trades descending, then by symbol.
• Symbols use the canonical orientation, which may not be the one you display. Invert the prices to show quote/base. The JS client exports invertTicker for that.
• Like candles, the ticker counts fills only, never swap records or the taker order fill of a crossfill.

Contract and markets#

GET /contract#

Contract state rebuilt from contract events: the freeze switch, the configuration and the markets opened on-chain. No parameters.

curl "https://demo-api.axis.markets/contract?pretty_print"

The response listed six markets. The first two are shown:

{
  "address": "CA6P26K4QNNIMTYP22ILTSCXQQDEKNWJIZJPC34YEZYOLBNT7YUPX7XS",
  "frozen": false,
  "config": {
    "safetyAdmin": "GBDCULE53LUPK4XHUCXBI35MAZFQHENMZ3JRKAJS2PPYBV646M6XKVHG",
    "oracle": "CDEIQLTE3Y3XQMYPSZFJC2OXIS67F4MURGP73NCE2C2NZZ22RNSPV7ZI",
    "listingMinDays": 90,
    "marketListingFee": "180000000000",
    "minTradeSize": "10000",
    "ledgerTime": 5
  },
  "markets": [
    {
      "base": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "quote": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
      "created": "2026-10-05 21:12:47",
      "refreshed": "2026-10-05 21:12:47"
    },
    {
      "base": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "quote": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
      "created": "2026-10-05 21:12:52",
      "refreshed": "2026-10-05 21:12:52"
    }
  ]
}

Notes:

• This is the market registry. A market can exist without live orders. GET /markets lists only pairs that have live orders.
• The same data is pushed on the WebSocket contract channel. See WebSocket API.

GET /markets#

Pairs that currently have live orders.

curl "https://demo-api.axis.markets/markets?limit=2&pretty_print"

[
  {
    "baseAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "quoteAsset": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
    "cursor": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA-CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
    "orderTypes": [
      "LIMIT"
    ]
  },
  {
    "baseAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "quoteAsset": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
    "cursor": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA-CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
    "orderTypes": [
      "LIMIT"
    ]
  }
]

Notes:

• The list is cached for 30 minutes. A new pair can take up to 30 minutes to appear, and a pair whose last order is gone stays listed until the cache refreshes.
• A pair is listed when it has at least one live order, backed or not. Use GET /contract for the markets opened on-chain.
• A cursor in the <base>-<quote> form that matches no listed pair restarts the list from the first market.

Orders and accounts#

GET /order/:id#

One live order by ID.

The response is an Order.

curl "https://demo-api.axis.markets/order/44605595615823183937087476473264348631?pretty_print"

{
  "id": "44605595615823183937087476473264348631",
  "status": "ACTIVE",
  "buying": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
  "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "price": "3479416000000000000",
  "rprice": 3.479416,
  "quote": "2908352",
  "amount": "2908352",
  "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
  "backed": "2908352",
  "backing": {
    "balance": "69249433628",
    "allowance": "373054724",
    "liveUntil": 5520444,
    "authorized": true,
    "updated": "2026-10-03 13:23:38"
  },
  "created": "2026-10-03 09:42:42",
  "updated": "2026-10-03 09:42:42",
  "cursor": "1407204591193443794944"
}

Notes:

• Only live orders are returned. An unknown, filled, removed or expired order returns 404 with Not found. Order not found. Look up finished orders in GET /order-history.
• An ID that is not a non-negative integer returns 400 with Bad request. Invalid order ID.
• An expired order keeps its entry on-chain until its owner removes or revives it, but the API treats it as gone, like the contract's order view.

GET /order#

Live orders, oldest first, optionally filtered by owner and assets.

The response is an array of Orders.

curl "https://demo-api.axis.markets/order?owner=GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5&limit=1&pretty_print"

[
  {
    "id": "153390214124585565809379122683319801444",
    "status": "ACTIVE",
    "buying": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
    "selling": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
    "price": "319006000000000000",
    "rprice": 0.319006,
    "quote": "10341628",
    "amount": "10341628",
    "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
    "backed": "10341628",
    "backing": {
      "balance": "489427040739",
      "allowance": "589201950",
      "liveUntil": 5520714,
      "authorized": true,
      "updated": "2026-10-03 13:46:13"
    },
    "created": "2026-10-03 10:04:52",
    "updated": "2026-10-03 10:04:52",
    "cursor": "1407279463540738490369"
  }
]

Notes:

• The asset filter compares contract addresses as given. XLM or CODE:ISSUER match nothing here.
• Expired orders are not listed.

GET /account/:address#

Every live order of an account and the backing tracked for it, per token.

curl "https://demo-api.axis.markets/account/GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5?pretty_print"

The account had 99 live orders and four backing records. One order and one backing record are shown:

{
  "address": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
  "ledger": 5002051,
  "orders": [
    {
      "id": "44605595615823183937087476473264348631",
      "status": "ACTIVE",
      "buying": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
      "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
      "price": "3479416000000000000",
      "rprice": 3.479416,
      "quote": "2908352",
      "amount": "2908352",
      "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
      "backed": "2908352",
      "backing": {
        "balance": "69249433628",
        "allowance": "373054724",
        "liveUntil": 5520444,
        "authorized": true,
        "updated": "2026-10-03 13:23:38"
      },
      "created": "2026-10-03 09:42:42",
      "updated": "2026-10-03 09:42:42",
      "cursor": "1407204591193443794944"
    }
  ],
  "backing": {
    "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC": {
      "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
      "asset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
      "balance": "69249433628",
      "allowance": "373054724",
      "liveUntil": 5520444,
      "authorized": true,
      "budget": "373054724",
      "updated": "2026-10-03 13:23:38"
    }
  }
}

Notes:

• backing covers the tokens of the account's live orders, both the token each order sells and the one it buys. While the account is subscribed on the WebSocket account channel, it covers every token of the open markets, orders or not.
• Records that have not loaded yet are left out. An account without orders or subscription returns empty orders and backing.

GET /backing#

The tracked balance and allowance of one owner in one token.

The response is a Backing record.

curl "https://demo-api.axis.markets/backing?owner=GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5&asset=CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC&pretty_print"

{
  "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
  "asset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "balance": "69249433628",
  "allowance": "373054724",
  "liveUntil": 5520444,
  "authorized": true,
  "budget": "373054724",
  "updated": "2026-10-03 13:23:38"
}

Notes:

• The service tracks a pair only while the owner has a live order in that token (on either side) or an open WebSocket account subscription. Otherwise the endpoint returns 404 with Not found. Backing is not tracked for the owner and asset.
• Right after tracking starts, the record can be returned before it has loaded, with zero amounts, authorized: false and no updated. Treat a record without updated as unknown.
• The record is an indexed view. When a decision must be exact, read the allowance from the token contract and the spendable balance from the account or trustline entry. The token's balance() includes amounts locked by selling liabilities and, for XLM, the reserve.

History#

GET /order-history#

Archived orders: filled, removed and expired.

The response is an array of Orders without backed and backing, newest first by creation time, not by the time they were archived.

curl "https://demo-api.axis.markets/order-history?owner=GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5&limit=1&pretty_print"

[
  {
    "id": "244077557362344635759726310078879391963",
    "status": "FILLED",
    "buying": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
    "selling": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
    "price": "296915534537630660",
    "rprice": 0.29691553453763064,
    "quote": "24390422",
    "amount": "0",
    "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
    "created": "2026-10-03 13:43:12",
    "updated": "2026-10-03 13:44:47",
    "cursor": "1408016927976499183616"
  }
]

Notes:

• FILLED orders have amount "0". CANCELED orders (removed by their owner) keep the amount that was still open. EXPIRED orders keep the unfilled amount.
• An EXPIRED order goes back to the live orders if its owner revives it with update.
• Order IDs can be reused once an order is gone, so the archive can hold several records with the same id. Their cursor tells them apart.
• Use repeated keys for pair. The bracket form pair[]= is not recognized, and the request returns unfiltered results.

GET /trades#

Fills and swaps, newest first.

The response is an array of Trade and Swap records, told apart by type.

curl "https://demo-api.axis.markets/trades?limit=2&pretty_print"

[
  {
    "type": "trade",
    "id": "1407946559234737438722",
    "order": "33373580251613825955093796938150226715",
    "taker": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
    "maker": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
    "soldAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "boughtAsset": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
    "sold": "974786",
    "bought": "832170",
    "price": 0.8536950674301846,
    "cursor": "1407946559234737438722",
    "timestamp": "2026-10-03 13:22:22",
    "left": "368016"
  },
  {
    "type": "trade",
    "id": "1407945433334293725188",
    "order": "263834615734212946979442271082514120154",
    "taker": "GBDCULE53LUPK4XHUCXBI35MAZFQHENMZ3JRKAJS2PPYBV646M6XKVHG",
    "maker": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
    "soldAsset": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
    "boughtAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
    "sold": "113052",
    "bought": "132097",
    "price": 1.1684623005342674,
    "cursor": "1407945433334293725188",
    "timestamp": "2026-10-03 13:22:02",
    "left": "1124020"
  }
]

Notes:

• There is one trade record per fill. A swap call adds one swap record on top of the fills of its hops, so never add swap amounts to fill volumes.
• A swap is filed under the pair of its first and last asset, for example EURC/XLM, in canonical order, for an XLM to EURC route through USDC.
• In a multi-hop swap, the fills after the first hop list the AXIS contract as taker, because the contract pays those hops with what the previous hop delivered.
• A crossfill adds, after its maker fills, the fill of its taker order with crossfill: true. Its taker is the caller, who keeps the surplus, and its amounts mirror the makers' fills, so leave it out of volume sums.
• Trades and swaps have no on-chain ID. Their id is the position of the event (ledger, transaction and event index), which also orders them.
• Use repeated keys for pair, as for /order-history.

GET /failures#

Failed AXIS calls, newest first. The records are diagnostics only: a failed call changes nothing on-chain, so it never counts against a maker or a taker, and the AXIS API does not use these records for routing.

The response is an array of Failure records.

curl "https://demo-api.axis.markets/failures?account=GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK&limit=1&pretty_print"

An illustrative record of a trade whose payment to a maker failed:

[
  {
    "type": "failure",
    "id": "1408023584926158962688",
    "txHash": "5d0c2bb6e4a1f7a3c9e85b1d2f4a6c8e0b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a",
    "ledger": 5002410,
    "timestamp": "2026-10-03 14:02:17",
    "fn": "trade",
    "caller": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
    "orders": [
      "33373580251613825955093796938150226715"
    ],
    "result": "invokeHostFunctionTrapped",
    "reason": "transfer",
    "error": {
      "contract": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "code": 10
    },
    "transfer": {
      "token": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
      "fn": "transfer_from",
      "from": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
      "to": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
      "amount": "974786"
    },
    "cursor": "1408023584926158962688"
  }
]

Here the taker's USDC payment to a maker failed with the token's BalanceError (#10): either the taker could not pay or the maker's trustline had no room for the payment. The record names both parties and blames neither.

Notes:

• The AXIS API streams every network transaction and reads the call tree of the ones touching the contract from their diagnostic events. A failed AXIS call is recorded whether the transaction called the contract or another contract did (a router), and whether the transaction failed or a calling contract caught the failure (caught). A transaction that fails in another contract after its AXIS call returned is not recorded: the AXIS call itself succeeded.
• When no failed AXIS call shows in the call tree, for example because the RPC server returns no diagnostic events, a failed transaction calling the contract directly is still recorded from its envelope. Its reason then comes from the result code: resources for a resource problem, unknown otherwise.
• reason tells what failed: contract (a contract error: an AXIS error named in error.name, or an error of another contract the call invoked, such as the oracle), transfer (a token transfer failed, see transfer), resources (a resource limit, the refundable fee or an archived entry), auth (an authorization failure) or unknown (the cause could not be determined).
• A crossfill lists its taker order in takerOrder. Its payments to the makers come from the taker order's owner, so a failed transfer there involves the owner and a maker, never the caller.

Data shapes#

Order#

The embedded backing object:

backed comes from the maker's budget in the token, min(balance, allowance), or zero when the maker is not authorized or the allowance has expired. The budget is split across the maker's live orders selling that token, oldest first. The contract has no priority between these orders, so backed estimates which of them a fill would skip. See Settlement and allowances.

A live order:

{
  "id": "44605595615823183937087476473264348631",
  "status": "ACTIVE",
  "buying": "CC72F57YTPX76HAA64JQOEGHQAPSADQWSY5DWVBR66JINPFDLNCQYHIC",
  "selling": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "price": "3479416000000000000",
  "rprice": 3.479416,
  "quote": "2908352",
  "amount": "2908352",
  "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
  "backed": "2908352",
  "backing": {
    "balance": "69249433628",
    "allowance": "373054724",
    "liveUntil": 5520444,
    "authorized": true,
    "updated": "2026-10-03 13:23:38"
  },
  "created": "2026-10-03 09:42:42",
  "updated": "2026-10-03 09:42:42",
  "cursor": "1407204591193443794944"
}

This order sells 0.2908352 XLM for CETES at 3.479416 CETES per XLM, and the maker's budget covers all of it.

Backing#

Returned by GET /backing and as the values of backing in GET /account/:address.

{
  "owner": "GACVXELMTE6JXAQCMR4OJOYBZFD6VUDLV4YZGUR2ONN77EGZVY4YCLY5",
  "asset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "balance": "69249433628",
  "allowance": "373054724",
  "liveUntil": 5520444,
  "authorized": true,
  "budget": "373054724",
  "updated": "2026-10-03 13:23:38"
}

Trade#

One fill of a maker order.

{
  "type": "trade",
  "id": "1407946559234737438722",
  "order": "33373580251613825955093796938150226715",
  "taker": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
  "maker": "GB32JP5GNOQLW4NUMV6H2UBOSMB4DROL7YNDBWAHYXMVFLLJOH3LXKHK",
  "soldAsset": "CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA",
  "boughtAsset": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
  "sold": "974786",
  "bought": "832170",
  "price": 0.8536950674301846,
  "cursor": "1407946559234737438722",
  "timestamp": "2026-10-03 13:22:22",
  "left": "368016"
}

AXIS allows self-trades, so taker and maker can be the same address, as here.

Swap#

One swap call, recorded once on top of the fills of its hops.

{
  "type": "swap",
  "id": "1407466362922858446860",
  "trader": "GB7TZS65DOB3KJLRPT2EDTMZQSCORUIQGCKP7XVNZ77VNKOTKQEY7F23",
  "soldAsset": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
  "boughtAsset": "CCUUDM434BMZMYWYDITHFXHDMIVTGGD6T2I5UKNX5BSLXLW7HVR4MCGZ",
  "sold": "9999996",
  "bought": "1844614",
  "price": 0.18446147378458952,
  "cursor": "1407466362922858446860",
  "timestamp": "2026-10-03 11:00:12"
}

This swap sold 0.9999996 XLM for 0.1844614 EURC through USDC.

Failure#

One failed AXIS call.

A failed payment fails with the token's own error whether the payer could not pay or the recipient could not be credited, for example on a full trustline. The contract does not tell the two apart, so neither party is at fault from a transfer record alone. See Failure modes.

Using a quote in a contract call#

A quote tells you which orders to list. Your transaction calls the AXIS contract directly, through Stellar RPC, and the contract checks every price and backing again. The AXIS API never signs or submits anything.

The second and third rows are market orders: they cross the listed orders at no worse than the worst quoted price and place nothing on the book. With kind FillOrKill the call fails with NotFilled (709) unless the amount fills completely. Code for both conversions is in API and stream clients, and the full swap flow with slippage and approval planning in Wallet integration.

Before you build the call:

• The trader needs an allowance to the AXIS contract on the token they pay, covering this spend plus what their open orders still sell, see Wallet integration.
• The trader must be able to receive the bought asset, see Wallet integration.
• Orders that are gone by the time the transaction lands are skipped. A market order then fills less, while Fill-or-Kill and swap fail with NotFilled (709) when their bounds are not met. See Failure modes.

The JS client wraps all of this: AxisAccount.swap and the market orders of AxisAccount.sell and AxisAccount.buy quote, plan the approval and submit for you (see Axis, markets and accounts).