API Documentation

Integrate with Sikkaa Exchange using our comprehensive REST API and WebSocket feeds

Introduction & Overview

The Sikkaa Exchange API provides programmatic access to trading, market data, account management, and wallet operations. Our API is designed for developers, trading bots, and institutional partners.

Base URL

https://api.sikkaaexchange.com

Current Version

v1

Rate Limit

120 requests/minute

Authentication & Security

API Key Generation

Generate API keys from your account dashboard with specific permissions (read, trade, withdraw).

X-API-Key: your_api_key
X-API-Secret: your_api_secret
X-Timestamp: 1640995200000
X-Signature: hmac_sha256_signature

HMAC Signature

All private endpoints require HMAC-SHA256 signature using your API secret.

signature = HMAC-SHA256(timestamp + method + path + body, api_secret)

Market Data (Public)

GET
/api/v1/markets
Get all available trading pairs
GET
/api/v1/ticker?symbol=BTC/INR
Get 24hr ticker statistics
GET
/api/v1/orderbook?symbol=BTC/INR&limit=50
Get order book depth
GET
/api/v1/trades?symbol=BTC/INR&limit=100
Get recent trades

Account & Wallet

GET
/api/v1/account/info
Get account information
GET
/api/v1/balance
Get account balances
POST
/api/v1/deposit/crypto
Generate crypto deposit address
GET
/api/v1/deposit/history
Get deposit history
POST
/api/v1/withdraw/crypto
Withdraw cryptocurrency

Trading

POST
/api/v1/order
Place new order (market, limit, stop)
DELETE
/api/v1/order/{orderId}
Cancel existing order
GET
/api/v1/order/status/{orderId}
Get order status
GET
/api/v1/orders/open
Get open orders
GET
/api/v1/orders/history
Get order history

P2P Trading

GET
/api/v1/p2p/offers
Get available P2P offers
POST
/api/v1/p2p/order
Create P2P order
GET
/api/v1/p2p/order/status/{orderId}
Get P2P order status

WebSocket Streams

Real-time Market Data

Subscribe to live price feeds, order book updates, and trade streams.

wss://ws.sikkaaexchange.com/v1/stream
// Subscribe to ticker
{"method": "subscribe", "params": ["ticker.BTC/INR"]}

Private Streams

Get real-time updates for your orders, trades, and balance changes.

// Subscribe to user orders
{"method": "subscribe", "params": ["user.orders"], "auth": "api_key"}

Error Handling

Standard Error Format

{
  "error": {
    "code": 1001,
    "message": "Invalid API key",
    "details": "API key not found or expired"
  }
}

Common Error Codes

401 Unauthorized - Invalid API credentials
429 Too Many Requests - Rate limit exceeded
400 Bad Request - Invalid parameters
403 Forbidden - Insufficient permissions

Security Best Practices

🔐 API Key Security

Store API keys securely, never expose them in client-side code or public repositories.

🌐 IP Whitelisting

Restrict API access to specific IP addresses for enhanced security.

🔑 Least Privilege

Only grant necessary permissions (read, trade, withdraw) to API keys.

⏰ Timestamp Validation

Use current timestamps and implement replay attack protection.

Developer Resources

Code Examples

Sample implementations in Python, JavaScript, and other languages

API Reference

Complete endpoint documentation with request/response examples

Developer Support

Get help from our technical team via dedicated developer channels