API v2.0 Stable

Integrate Banking
In Minutes, Not Months.

TradeRank Capital provides a RESTful API that lets you embed institutional-grade transfers, virtual accounts, and compliance checks directly into your application. One integration. Global reach.

REST + JSON

Standard Protocol

< 200ms

Avg Response Time

99.99%

Uptime SLA

Developer coding with multiple monitors showing API documentation

🔑 Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your Client Portal. Never expose secret keys in client-side code.

HTTP Header

Authorization: Bearer sk_live_XXXXXXXXXXXXXXXXXXXX

⚠️

Security Notice

Use sk_test_* keys for sandbox and sk_live_* keys for production. Test keys never move real funds.

⚡ Quick Start: Your First Transfer

Execute a real-time transfer in 3 steps. This example sends $1,250 from a card source to a bank destination with instant settlement.

                            Python — Request
                            
                        
import traderank

client = traderank.Client(api_key="sk_test_XXXX")

# Execute real-time transfer
transfer = client.transfers.create(
    amount=125000,       # In cents ($1,250.00)
    currency="USD",
    source_id="card_8821XXXX",
    destination_id="bank_9920XXXX",
    settlement="REAL_TIME",
    metadata={"order_id": "ORD-7721"}
)

print(transfer.id)  # "txn_a1b2c3d4e5"

                            JSON — Response (200 OK)
                            
                        
{
  "id": "txn_a1b2c3d4e5",
  "status": "CONFIRMED",
  "amount": 125000,
  "currency": "USD",
  "settlement": "REAL_TIME",
  "latency_ms": 14,
  "created_at": "2024-01-15T14:32:01Z",
  "metadata": {
    "order_id": "ORD-7721"
  }
}

💸 Transfers API

POST /v2/transfers

Create a new fund transfer. Supports card-to-bank, bank-to-bank, and wallet-to-wallet routing with real-time or next-day settlement options.

Parameter	Type	Required	Description
amount	integer	Yes	Amount in smallest currency unit (cents)
currency	string	Yes	ISO 4217 currency code (USD, EUR, GBP)
source_id	string	Yes	Source account/card/token identifier
destination_id	string	Yes	Destination account identifier
settlement	string	No	`REAL_TIME` or `NEXT_DAY`. Default: REAL_TIME

🏦 Virtual Accounts

POST /v2/virtual-accounts

Provision a new virtual account with unique routing number. Returns account details instantly.

                                Request Body
                                
                            
{
  "label": "Merchant Escrow",
  "currency": "USD",
  "owner_id": "usr_xxxxxxxx"
}

GET /v2/virtual-accounts/:id

Retrieve virtual account details including routing number, account number, and current balance.

                                Response
                                
                            
{
  "id": "va_9920XXXX",
  "routing_number": "021000021",
  "account_number": "8821992011",
  "balance": 4500000,
  "currency": "USD",
  "status": "ACTIVE"
}

🔔 Webhooks

Receive real-time event notifications via HTTP POST. All webhook payloads are signed with HMAC-SHA256 for verification. Configure endpoints in your Client Portal.

                        Webhook Payload — transfer.confirmed
                        
                    
{
  "event": "transfer.confirmed",
  "timestamp": "2024-01-15T14:32:01Z",
  "data": {
    "id": "txn_a1b2c3d4e5",
    "amount": 125000,
    "status": "CONFIRMED",
    "latency_ms": 14
  },
  "signature": "sha256=a1b2c3d4..."
}

💡

Idempotency

Webhooks may be delivered more than once. Always use the event.id field to deduplicate processing. Respond with HTTP 200 within 5 seconds to prevent retries.

🧪 Sandbox Environment

Test every endpoint risk-free. The sandbox mirrors production exactly but uses simulated rails. No real funds move. Test cards and bank accounts are pre-provisioned.

Base URL

https://sandbox.api.traderankcapital.com/v2

Production URL

https://api.traderankcapital.com/v2

Analytics dashboard showing API metrics and test results

Integrate Banking In Minutes, Not Months.