Skip to main content
Track new endpoints, breaking changes, and improvements to the Strails API and documentation.
​
API
Withdrawals to Celo
  • /withdrawasset accepts celo as a network.
  • trx is no longer accepted for withdrawals.
  • A withdrawal to a network other than Base fails with Network not enabled when bridging isn’t enabled for the token on that network.
​
API
Settlement address on onramps, and Celo
  • Added settlementAddress to /cngnonramp. Name the address on settlementNetwork to deliver one onramp’s cNGN to, such as one of your external wallets or an address the user gives you. The user no longer needs a wallet of their own on that network, and their external default wallet is unchanged.
  • New /cngnonramp errors: settlementAddress without settlementNetwork, and an address that is not valid for the network.
  • Added Celo (celo) as a settlement network and to the Bridge API.
  • A user’s settlement network other than Base, used for permanent virtual account deposits, still requires an external default wallet on that network.
​
Deprecation
Deprecated /swapquote
  • Removed the POST /swapquote endpoint from the Transactions API. The endpoint is deprecated; use the FX orderbook quote and trade flow (POST /fx/quote followed by POST /fx/trade) or execute a swap directly via /swap / /swaptrigger and track it with /swapstatus.
  • Removed the /swapquote row from the rate-limit table in the Authentication guide.
​
API
Sync with the production API
  • Added the Settlement Network endpoints: POST /setusersettlementnetwork, /getusersettlementnetwork, /removeusersettlementnetwork, /listusersettlementdestinations, /setfintechsettlementnetwork, /getfintechsettlementnetwork and /removefintechsettlementnetwork, plus the settlementNetwork parameter on /cngnonramp.
  • Added GET /listofframps, POST /cancelofframp, and GET /getofframplimits to the Transactions API, POST /verifybankaccount to Fiat Payout Management, and GET /getpublickey, DELETE /deletepublickey and POST /regenerateaeskey to the Management API.
  • Rewrote PUT /managefees and GET /getfees for tiered fees: collectionFees and payoutFees replace the old onrampFee and offrampFee objects, which the API no longer accepts.
  • Added allowPartialFill to /fx/quote, /fx/trade, /fx/market-order and /cngnonramp, and explained when a partial fill applies under Insufficient liquidity.
  • Documented how FX trades are matched across orders, the new partial and settling_in_progress trade statuses, and the FX error codes.
  • Documented the refunded deposit status, the refund object and NIBSS sessionId on deposits and payouts.
  • Added the fintech.deposit.funding.failed, fintech.user.deposit.funding.failed and mpc.signing.completed webhook events, and destinationWallet / destinationType on fintech.user.deposit.funding.completed.
  • Added rate limits for these endpoints to the Authentication guide.
Fixes
  • The trade status endpoint is GET /fx/trade/status, not /fx/trades/status; its limit is 150 rpm.
  • The single bank account endpoint is GET /getbankaccount, not /getbankaccounts, and returns one account object.
  • FX quotes, price locks and the signing window last 15 minutes, not 5.
  • /initiateofframp takes amount in naira, not the token’s lowest unit.
  • Corrected the network lists for /withdrawasset, the Bridge API and wallet balances to the values the API accepts.
  • Removed the IP allowlist description field, which the API does not store, and corrected the list response.
  • blockchain on /setuserdefaultwallet is optional and defaults to base.
​
Documentation
User default wallet cross-references
  • Documented the scope of external default wallets: they apply to virtual account deposit mints, /cngnonramp, and sweepToOfframp only. Swaps, offramp, and escrow continue to run against the Strails-managed wallet.
  • Clarified cNGN delivery destinations in the Virtual Accounts guide, the sweepToOfframp parameter and auto-swap matrix, and Core Concepts.
  • Distinguished fintech-level external wallets (/addexternalwallet) from user-level default wallets in the Wallet Management API.
  • Noted that fintech.user.deposit.funding.completed still fires for external deliveries, with smartWalletAddress carrying the external address.
  • Added an optional default wallet step to the Implementation Guide and a verification item to the Going Live checklist.
​
API
User default wallet endpoints
  • Added POST /setuserdefaultwallet, POST /getuserdefaultwallet, and DELETE /removeuserdefaultwallet to the User Management API.
  • Fintechs can now route a user’s cNGN deliveries to an external wallet address, read the current configuration, and revert to the user’s system smart wallet.
  • External default wallets are delivery destinations only - platform swaps and offramp do not operate on them.
  • Documented rate limits for the new endpoints in the Authentication guide.
​
API
Swap History endpoint
  • Added GET /swaphistory to the Transactions API.
  • Lists historical swap requests for a fintech with pagination and optional filtering by status, startDate, and endDate.
  • Documented the new endpoint in the Transactions reference and updated the Authentication rate-limits table to include /swaphistory at 100 rpm.
​
Documentation
Mock Sandbox documentation
  • Added a new Sandbox top navigation tab with a dedicated Mock Sandbox section.
  • Introduced the Strails Mock Sandbox API Guide covering the isolated testing environment, base URLs, and important notes.
  • Split detailed sandbox topics into separate pages:
    • Authentication — creating, using, and validating sandbox API keys.
    • Sync vs. Async Mode — toggling sync and async request handling and webhook callbacks.
    • Webhooks — default webhook config, custom URL setup, HMAC signature verification, and a sample payload aligned with the production user.onboarded event schema.
    • Common Test Values — sample BVN/NIN values, onboard-user requests, cNGN amount formats, and deterministic wallet addresses.
​
Documentation
API reference navigation & cleanup
  • Added header anchor links to API reference overview tables for:
    • User Management, Virtual Accounts, FX Settings, Fee Management, Trading Management, and Management API.
  • Restored dedicated Management API sections for:
    • POST /storepublickey
    • GET /getplatformpublickey
    • GET /getaeskey
  • Updated Authentication and Encryption guides to document X25519 key registration, platform public key retrieval, and legacy AES key usage.
  • Removed redundant GitBook-era .md duplicates, leaving .mdx as the canonical documentation format.
​
Documentation
Navigation & layout conformance
  • Restructured top navigation into Documentation, Security, API Reference, and Changelog.
  • Consolidated the Security tab into a single sidebar group containing Authentication, Encryption, and HMAC Signatures.
  • Added title and sidebarTitle frontmatter across documentation and API-reference pages for consistent page and sidebar labels, and removed duplicated in-page H1 headings.
  • Removed invalid iconType properties from docs.json tabs.
Fixes
  • Fixed broken cross-page anchors in Authentication (orderbook, fee-management, and offramp rate-limit links), Transactions, and MPC Wallet pages.
  • Replaced absolute docs.strails.co links with relative links in the MPC Wallet setup flow.
  • Corrected the SLIP-0044 reference link in Multi-Chain Wallet.
  • Standardized the support contact to support@strails.co across all pages.
  • Added the missing Management & Configuration card to the API Reference overview.
  • Standardized response envelope examples in Wallet Management API to use status, response_code, message, and data.
  • Removed redundant /v1 prefix from balance endpoints (/balance/multi, /balance/address, /balance/user/:userId).
  • Fixed async processing status example in Core Concepts from processing to requested.
  • Removed duplicate api-reference/orderbook-management.md file; canonical file is now orderbook-management.mdx.
​
API
  • Added fintech system wallet balance endpoints:
    • GET /balance/multi
    • POST /balance/address
    • GET /balance/user/:userId
​
  • FX orderbook and trading endpoints.
  • MPC vault registration and auto-signing configuration.
  • Fintech fee management and withdrawal APIs.
  • Virtual account deposits and fiat payout flows.
Have a feature request or found a documentation issue? Contact us at support@strails.co.