API DOCUMENTATION

Full interactive documentation for Blackline Signals API.

Download OpenAPI
Base URL
https://black-line.online/api/v1
Authorization
Bearer Token / X-API-Key
Realtime
SSE: GET /signals/stream
How to get a key: open /profile → API access block → Create key. Key is shown once.

# AUTHENTICATION

Use an API key from your account profile. You can pass the key via Authorization or X-API-Key.

Bearer Token Header 
GET /api/v1/signals HTTP/1.1
Host: black-line.online
Authorization: Bearer YOUR_API_KEY
Custom Header 
GET /api/v1/signals HTTP/1.1
Host: black-line.online
X-API-Key: YOUR_API_KEY

# SIGNALS

GET /signals

Parameters

Parameter Type Description
ticker string Ticker filter (BTCUSDT)
limit integer Records limit (def: 50)
direction string long / short 
curl -X GET "https://black-line.online/api/v1/signals?ticker=BTCUSDT" \
  -H "Authorization: Bearer YOUR_API_KEY"
Response 200 OK application/json 
{
  "status": "ok",
  "data": [
    {
      "id": "sig_01HXYZ",
      "ticker": "BTCUSDT",
      "direction": "long",
      "entry": 42150.00,
      "targets": [44000, 46000],
      "stop_loss": 40800.00,
      "created_at": "2026-02-16T15:30:00Z"
    }
  ]
}
GET /signals/stream
SSE Realtime

Connect to the Server-Sent Events stream to receive signals in real time.

JavaScript
const es = new EventSource(
  'https://black-line.online/api/v1/signals/stream',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

es.onmessage = (e) => {
  const signal = JSON.parse(e.data);
  // Handle realtime signal
  console.log(signal);
};
GET /signals/{id}

# ERROR CODES

Code Description Solution
401 Invalid API key Check key in /profile
403 No access Pro subscription required
429 Rate limit exceeded Wait 60 seconds
500 Server error Retry later
API Support