Developer Tools

API Documentation

Integrate TwinHeadSnake's algorithmic trading signals into your infrastructure with our clean, well-documented REST API.

Real-time Data

Sub-second signal delivery via WebSocket and REST endpoints

Clean Code

Well-documented endpoints with SDKs for Python, Node.js, and C#

Flexible Integration

Webhook support and customizable data formats for any infrastructure

API Overview

Authentication

All API requests require an API key for authentication. Include your API key in the Authorization header.

// Example Authorization header
Authorization: Bearer YOUR_API_KEY

Base URL

// Production API
https://api.twinheadsnake.com/v1

// Sandbox API (for testing)
https://sandbox-api.twinheadsnake.com/v1

Rate Limits

Standard Tier

100 requests per minute
1000 requests per hour
Real-time signals

Pro Tier

500 requests per minute
Unlimited requests per hour
WebSocket access

Quick Start

Get your API key

Make your first request

Integrate into your system

Support

twinheadsnake@proton.me

Discord Community

24/7 API Uptime

API Endpoints

GET

/signals

Retrieve current trading signals for all active pairs or a specific pair.

Parameters

Parameter	Type	Required
pair	string	Optional
timeframe	string	Optional

Response

{
  "signals": [
    {
      "pair": "BTC/USDT",
      "timeframe": "1h",
      "signal": "BUY",
      "entry_price": 43250,
      "stop_loss": 42800,
      "take_profit_1": 44100
    }
  ]
}

GET

/positions

Retrieve current open positions and their status.

Parameters

Parameter	Type	Required
status	string	Optional

Response

{
  "positions": [
    {
      "id": "pos_12345",
      "pair": "BTC/USDT",
      "side": "LONG",
      "entry_price": 43250,
      "unrealized_pnl": 1240
    }
  ]
}

POST

/webhook

Configure webhook endpoints to receive real-time signal notifications.

Request Body

{
  "url": "https://your-webhook.com/signals",
  "events": ["signal.created", "position.updated"],
  "secret": "your-webhook-secret"
}

Response

{
  "event": "signal.created",
  "data": {
    "pair": "BTC/USDT",
    "signal": "BUY",
    "price": 43250
  },
  "signature": "sha256=..."
}

Coming Soon

Client Libraries

Official client libraries for popular programming languages

Coming Soon

Python

pip install twinheadsnake

Coming Soon

Node.js

npm install @twinheadsnake/sdk

Coming Soon

C#

dotnet add package TwinHeadSnake

SDKs in Development

Official libraries will be available at launch

API Overview

Authentication

All API requests require an API key for authentication. Include your API key in the Authorization header.

// Example Authorization header
Authorization: Bearer YOUR_API_KEY

Base URL

// Production API
https://api.twinheadsnake.com/v1

// Sandbox API (for testing)
https://sandbox-api.twinheadsnake.com/v1

Rate Limits

Standard Tier

100 requests per minute
1000 requests per hour
Real-time signals

Pro Tier

500 requests per minute
Unlimited requests per hour
WebSocket access

API Endpoints

GET

/signals

Retrieve current trading signals for all active pairs or a specific pair.

Parameters

Parameter	Type	Required
pair	string	Optional
timeframe	string	Optional

Response

{
  "signals": [
    {
      "pair": "BTC/USDT",
      "timeframe": "1h",
      "signal": "BUY",
      "entry_price": 43250,
      "stop_loss": 42800,
      "take_profit_1": 44100
    }
  ]
}

GET

/positions

Retrieve current open positions and their status.

Parameters

Parameter	Type	Required
status	string	Optional

Response

{
  "positions": [
    {
      "id": "pos_12345",
      "pair": "BTC/USDT",
      "side": "LONG",
      "entry_price": 43250,
      "unrealized_pnl": 1240
    }
  ]
}

POST

/webhook

Configure webhook endpoints to receive real-time signal notifications.

Request Body

{
  "url": "https://your-webhook.com/signals",
  "events": ["signal.created", "position.updated"],
  "secret": "your-webhook-secret"
}

Response

{
  "event": "signal.created",
  "data": {
    "pair": "BTC/USDT",
    "signal": "BUY",
    "price": 43250
  },
  "signature": "sha256=..."
}