Skip to main content
Track new endpoints, breaking changes, and improvements to the Strails API and documentation.
​
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.