# Stabyl API

## Docs

- [Cancel order](https://docs.stabyl.com/api-reference/exchange/cancel-order.md): Requests cancellation of open quantity on an order. Filled quantity is final; only remaining quantity can be cancelled if the order is still cancellable.
- [Create order](https://docs.stabyl.com/api-reference/exchange/create-order.md): Creates a limit or market order intent for asynchronous matching. A successful response means the order was accepted for processing; read the order until it reaches a terminal status before treating execution as final.
- [Get 24h ticker](https://docs.stabyl.com/api-reference/exchange/get-24h-ticker.md): Returns current ticker data and 24-hour statistics for one market or all markets, including best bid, best ask, last price, volume, and price change.
- [Get candles](https://docs.stabyl.com/api-reference/exchange/get-candles.md): Returns OHLCV candles for a market and interval. Use candles for charts, historical price checks, and pre-trade context; use ticker or order book endpoints when you need a current executable view.
- [Get order book levels](https://docs.stabyl.com/api-reference/exchange/get-order-book-levels.md): Returns aggregated bid or ask levels for one market. Use this endpoint for focused depth checks when you only need one side of the book.
- [Get order book snapshot](https://docs.stabyl.com/api-reference/exchange/get-order-book-snapshot.md): Returns bid and ask depth for one market, including a sequence value and timestamp. Treat the response as a point-in-time snapshot and refresh before submitting price-sensitive orders.
- [Get order details](https://docs.stabyl.com/api-reference/exchange/get-order-details.md): Returns the canonical state of one order, including status, quantities, replacement linkage, and fills where available. Use this endpoint after create, cancel, replace, timeout, or retry events.
- [Get recent fills](https://docs.stabyl.com/api-reference/exchange/get-recent-fills.md): Returns recent public execution entries for a market as a fills view. Use it for execution review and market activity displays; use order detail when reconciling fills for one of your own orders.
- [Get recent trades](https://docs.stabyl.com/api-reference/exchange/get-recent-trades.md): Returns recent public trades for a market with sequence numbers for incremental reads. Store the last processed sequence if you are building a polling-based market data feed.
- [List markets](https://docs.stabyl.com/api-reference/exchange/list-markets.md): Returns the trading markets currently available to your account. Use this response as the source of truth for pair identifiers, base and quote currencies, price precision, quantity precision, minimum notional, fee basis points, and active trading status before creating orders.
- [List orders](https://docs.stabyl.com/api-reference/exchange/list-orders.md): Returns your account's orders with optional market, status, and pagination filters. Use this endpoint for dashboards, backfills, and reconciliation jobs.
- [Replace order](https://docs.stabyl.com/api-reference/exchange/replace-order.md): Submits a replacement intent for an existing limit order. Read the response and the returned order state before assuming the original order is no longer active.
- [Simulate fiat deposit](https://docs.stabyl.com/api-reference/simulation/simulate-fiat-deposit.md): Creates a non-production fiat deposit record and credits the test account for integration testing. This endpoint is disabled in production and cannot move real funds.
- [Simulate fiat withdrawal record](https://docs.stabyl.com/api-reference/simulation/simulate-fiat-withdrawal-record.md): Creates a non-production fiat withdrawal record for timeline and reconciliation testing. This endpoint is disabled in production and cannot move real funds.
- [Simulate KYB status](https://docs.stabyl.com/api-reference/simulation/simulate-kyb-status.md): Sets a test account's KYB status outside production so you can exercise onboarding-gated workflows in staging.
- [Simulate product update notification](https://docs.stabyl.com/api-reference/simulation/simulate-product-update-notification.md): Creates a non-production product update notification for integration and UI testing. This endpoint is disabled in production.
- [Simulate stablecoin deposit](https://docs.stabyl.com/api-reference/simulation/simulate-stablecoin-deposit.md): Creates a non-production stablecoin deposit record and credits the test account for integration testing. This endpoint is disabled in production and cannot move real funds.
- [Simulate stablecoin withdrawal record](https://docs.stabyl.com/api-reference/simulation/simulate-stablecoin-withdrawal-record.md): Creates a non-production stablecoin withdrawal record for timeline and reconciliation testing. This endpoint is disabled in production and cannot move real funds.
- [Create saved recipient](https://docs.stabyl.com/api-reference/wallets/create-saved-recipient.md): Creates a saved fiat or crypto recipient record for future use in Stabyl Pro workflows. Creating a recipient does not submit a withdrawal or move funds.
- [Delete saved recipient](https://docs.stabyl.com/api-reference/wallets/delete-saved-recipient.md): Deletes a saved recipient from the account address book. Existing historical transactions remain available in wallet transaction reads.
- [Get crypto deposit address](https://docs.stabyl.com/api-reference/wallets/get-crypto-deposit-address.md): Returns the deposit address for a requested chain and creates it when it does not already exist. Store the chain and address together, and display the returned route exactly.
- [Get fiat deposit account](https://docs.stabyl.com/api-reference/wallets/get-fiat-deposit-account.md): Returns the fiat deposit account for incoming NGN deposits. Display account name, bank name, and account number exactly as returned, then reconcile deposits through wallet transactions.
- [Get wallet balance overview](https://docs.stabyl.com/api-reference/wallets/get-wallet-balance-overview.md): Returns current NGN and USD balances, including available and locked amounts. Use available balance for spend checks and locked balance to explain funds committed to pending activity.
- [Get wallet transaction](https://docs.stabyl.com/api-reference/wallets/get-wallet-transaction.md): Returns detailed information for one wallet transaction by public transaction ID, including settlement details when available. Use this endpoint to refresh known records or investigate reconciliation gaps.
- [List saved recipients](https://docs.stabyl.com/api-reference/wallets/list-saved-recipients.md): Returns saved recipient records with optional type and currency filters. Use this endpoint to keep internal tools aligned with the current account address book.
- [List supported banks](https://docs.stabyl.com/api-reference/wallets/list-supported-banks.md): Returns supported Nigerian banks for fiat recipient setup and account verification. Refresh this list periodically instead of maintaining a hardcoded bank directory.
- [List supported wallet chains](https://docs.stabyl.com/api-reference/wallets/list-supported-wallet-chains.md): Returns the stablecoin deposit routes currently available for USD settlement. Use this endpoint as the source of truth for chain names, route slugs, token standards, logos, explorers, and enabled deposit support.
- [List wallet currencies](https://docs.stabyl.com/api-reference/wallets/list-wallet-currencies.md): Returns user-facing wallet currencies. Stabyl exposes NGN and USD wallets; USDT and USDC are stablecoin settlement rails that credit the USD wallet.
- [List wallet transactions](https://docs.stabyl.com/api-reference/wallets/list-wallet-transactions.md): Returns a cursor-paginated wallet timeline across fiat and stablecoin activity. Use this endpoint for reconciliation of deposits, fees, adjustments, refunds, and withdrawals initiated from Stabyl Pro.
- [Update saved recipient](https://docs.stabyl.com/api-reference/wallets/update-saved-recipient.md): Updates mutable recipient fields. Bank detail changes require account verification again; updating a recipient does not submit a withdrawal or move funds.
- [Verify bank account](https://docs.stabyl.com/api-reference/wallets/verify-bank-account.md): Verifies fiat bank account details and returns the account name that should be shown before saving a recipient. Verification does not create a recipient and does not move funds.
- [Authentication](https://docs.stabyl.com/docs/authentication.md): Authenticate API requests and operate keys safely.
- [Crypto Deposit Addresses](https://docs.stabyl.com/docs/crypto-deposit-addresses.md): Requesting deposit addresses for supported settlement rails and chains.
- [Environments](https://docs.stabyl.com/docs/environments.md): Production, staging, request conventions, and simulation behavior.
- [Errors](https://docs.stabyl.com/docs/errors.md): Error response shape, status codes, retry behavior, and logging guidance.
- [Exchange Overview](https://docs.stabyl.com/docs/exchange-overview.md): Market data, order lifecycle, and status reconciliation for account trading automation.
- [Fiat Deposit Accounts](https://docs.stabyl.com/docs/fiat-deposit-accounts.md): Retrieving fiat deposit account details and verifying bank accounts for saved recipients.
- [Go-Live Checklist](https://docs.stabyl.com/docs/go-live-checklist.md): Production readiness checklist for API automation.
- [Idempotency](https://docs.stabyl.com/docs/idempotency.md): Safe retry behavior for create, cancel, and replace order requests.
- [Introduction](https://docs.stabyl.com/docs/introduction.md): Build server side automations for your own Stabyl account.
- [Market Data](https://docs.stabyl.com/docs/market-data.md): Discover markets, price orders, and reconcile execution activity.
- [Order Management](https://docs.stabyl.com/docs/order-management.md): Create, list, read, cancel, and replace exchange orders.
- [Quickstart](https://docs.stabyl.com/docs/quickstart.md): Make the first calls for wallet discovery, balances, market data, orders, and reconciliation.
- [Rate Limits](https://docs.stabyl.com/docs/rate-limits.md): How to handle API request limits and retry behavior.
- [Sandbox Simulation](https://docs.stabyl.com/docs/sandbox-simulation.md): Non-production endpoints for testing wallet, KYB, and notification flows.
- [Saved Recipients](https://docs.stabyl.com/docs/saved-recipients.md): Create, list, update, and delete saved fiat and crypto recipients.
- [Supported Wallet Routes](https://docs.stabyl.com/docs/supported-wallet-routes.md): Supported blockchain route families and how to discover current availability.
- [Wallet Transactions](https://docs.stabyl.com/docs/wallet-transactions.md): Reconciling deposits, fees, adjustments, refunds, and web-initiated withdrawals.
- [Wallets Overview](https://docs.stabyl.com/docs/wallets-overview.md): How wallet currencies, deposit routes, recipients, and transaction reads work.
- [WebSocket Order Commands](https://docs.stabyl.com/docs/websocket-orders.md): Submit order create, cancel, and replace commands over WebSocket.
- [WebSocket Overview](https://docs.stabyl.com/docs/websocket-overview.md): Connect to real time market data, account order updates, and order command acknowledgements.
- [WebSocket Topics](https://docs.stabyl.com/docs/websocket-topics.md): Topic names, payloads, snapshots, sequencing, and recovery rules.
- [Withdrawals](https://docs.stabyl.com/docs/withdrawals.md): How withdrawals work with the API and Stabyl Pro.

## OpenAPI Specs

- [openapi](https://docs.stabyl.com/openapi/openapi.json)