Authentication

All API requests require authentication using an API key. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Base URL

All API endpoints are relative to: https://api.nanodata.io/v1

Traders

GET /traders

Retrieve a list of available traders to copy.

Query Parameters

Parameter Type Required Description
limit integer Optional Number of results (default: 20, max: 100)
offset integer Optional Pagination offset (default: 0)
sort string Optional Sort by: roi, winrate, followers (default: roi)

Example Request

GET /traders?limit=10&sort=roi Authorization: Bearer YOUR_API_KEY

Example Response

{ "success": true, "data": [ { "id": "trader_123", "username": "CryptoMaster", "roi": 45.2, "winRate": 68.5, "followers": 1250, "totalTrades": 342, "riskScore": 6 } ], "pagination": { "total": 150, "limit": 10, "offset": 0 } }
GET /traders/{traderId}

Get detailed information about a specific trader.

Path Parameters

Parameter Type Required Description
traderId string Required Unique trader identifier

Copy Trading

POST /copy/start

Start copying a trader's positions.

Request Body

Parameter Type Required Description
traderId string Required ID of trader to copy
amount number Required Investment amount in USD
stopLoss number Optional Stop loss percentage (1-100)
multiplier number Optional Position size multiplier (default: 1.0)

Example Request

POST /copy/start Authorization: Bearer YOUR_API_KEY Content-Type: application/json { "traderId": "trader_123", "amount": 1000, "stopLoss": 10, "multiplier": 1.0 }

Example Response

{ "success": true, "data": { "copyId": "copy_456", "traderId": "trader_123", "status": "active", "startedAt": "2026-05-20T18:00:00Z" } }
DELETE /copy/{copyId}

Stop copying a trader and close all positions.

Path Parameters

Parameter Type Required Description
copyId string Required Copy trading session ID

Account

GET /account/balance

Get your current account balance and portfolio value.

Example Response

{ "success": true, "data": { "totalBalance": 15420.50, "availableBalance": 8200.00, "inPositions": 7220.50, "totalPnL": 1420.50, "currency": "USD" } }

Rate Limits

API requests are rate limited to ensure fair usage:

Need Higher Limits?

Contact our support team to discuss enterprise API access with higher rate limits.