Quickstart

Get started with the Strails API in a few minutes. Choose the integration path that matches your use case.

Need credentials? Contact support@strails.co to start onboarding and receive your API key. See Authentication for details on API keys, headers, and rate limits.

Base URL

All requests are made to the test environment during integration:

https://api.strails.io/v1/

Fintech Partner Integration

For platforms integrating Strails into their services (payment processors, exchanges, fintech companies). Test your API connection by retrieving your fintech wallet:

curl -X GET https://api.strails.io/v1/getfintechwallet \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

A successful response returns your Smart Wallet and any registered external wallets:

{
  "status": "Success",
  "response_code": "00",
  "message": "Fintech wallet retrieved successfully",
  "data": {
    "fintechId": "fintech_abc123",
    "fintechName": "Example Fintech Ltd",
    "smartWallet": {
      "address": "0x69E4eA33BF7E2f6bAE7F1DEF247534C0aD3515C3",
      "owner": "0x684f5f118ed7d0e00b1c0a27dcdce6e37cf652e1",
      "deployed": true
    },
    "externalWallets": [],
    "totalUsers": 0
  }
}

What you can do next:

Create virtual accounts for users
Trade between cNGN and USDC/USDT on the FX orderbook
Configure custom fee structures
Manage liquidity with the multi-wallet system

Full Fintech Walkthrough

Step-by-step integration guide covering webhooks, onboarding, funding, and trading.

Direct User Integration

For applications serving individual users (wallet apps, DeFi interfaces, consumer apps). Onboard your first user with BVN verification:

curl -X POST https://api.strails.io/v1/onboarduser \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bvn": "12345678901"
  }'

The response returns a requestId and the Strails-issued userHash. Poll POST /onboardstatus with the requestId until verification completes. What you can do next:

Fund wallets via NGN bank transfer
Auto-swap NGN -> cNGN -> USDC/USDT
Process withdrawals to bank accounts
Track transactions in real time

Full User Walkthrough

Step-by-step guide to onboarding, funding, and processing withdrawals for users.

Next Steps

Core Concepts

Understand async processing, wallets, amount formats, and response codes.

Authentication

API keys, headers, rate limits, and security best practices.

Implementation Guide

Detailed end-to-end integration walkthrough.

API Reference

Complete endpoint documentation.

Get Started

Wallets

Guides

Tools

Base URL

Fintech Partner Integration

Full Fintech Walkthrough

Direct User Integration

Full User Walkthrough

Next Steps

Core Concepts

Authentication

Implementation Guide

API Reference

​Base URL

​Fintech Partner Integration

Full Fintech Walkthrough

​Direct User Integration

Full User Walkthrough

​Next Steps

Core Concepts

Authentication

Implementation Guide

API Reference

Base URL

Fintech Partner Integration

Direct User Integration

Next Steps