Skip to content
API · REST

Build on the signal layer.

Public REST endpoints return a teaser shape to anonymous callers. Signed-in Free accounts unlock full signal payloads after the delay. Approved partners get keyed Bearer access with a full OpenAPI schema and a TypeScript SDK.

Authentication

Session-based, tier-aware.

Public endpoints are callable without credentials and return a locked teaser shape. Requests made from a signed-in browser session return the full payload your subscription tier allows — Free accounts see full signals after a delay window. For server-side integrations, the Partner API uses scoped Bearer keys (mkpk_…) — see the Partner API section below.

GET /api/v1/signals HTTP/1.1
Host: markitel.com

# anonymous → 200, teaser shape (levels locked)
# signed-in Free browser session → 200, full payload after the delay
Endpoints

Four to start.

GET/api/v1/signals

The live signal list. Anonymous calls return a teaser shape — asset, direction, status, headline, and closed-trade results — with trade levels, confidence, and analysis locked. Signed-in Free accounts unlock full signal payloads after the delay. Add ?include=closed to append recently-closed signals.

// anonymous (teaser shape)
{
  "signals": [
    {
      "id": "…",
      "asset": "EURUSD",
      "direction": "LONG",
      "status": "ACTIVE",
      "headline": "EUR strength into the London open",
      "published_at": "2026-06-11T10:30:00Z",
      "entry_price_low": null,
      "stop_loss": null,
      "take_profit_1": null,
      "confidence": null,
      "analysis": null,
      "locked": true
    }
  ],
  "total": 1,
  "timestamp": 1780000000000
}
GET/api/v1/signals/by-asset/:symbol

Signal history for a single asset (e.g. EURUSD, XAUUSD, BTCUSD), newest first.

GET/api/v1/news

Latest market headlines with source links and the publisher's own summary where one is provided. A sentiment label appears only where one was assigned; unrated items return UNKNOWN.

GET/api/v1/calendar

Upcoming and recent economic calendar events with impact ratings, plus forecast and previous figures where available.

Code samples

Copy-paste ready.

JavaScript · fetch

const r = await fetch(
  "https://markitel.com/api/v1/signals?include=closed",
);
if (!r.ok) {
  throw new Error(`Signals unavailable (${r.status})`);
}
const { signals } = await r.json();
// anonymous callers receive the teaser shape
console.log(`${signals.length} signals`);

Python · requests

import requests

r = requests.get(
    "https://markitel.com/api/v1/signals",
)
r.raise_for_status()
signals = r.json()["signals"]
print(f"{len(signals)} signals (teaser shape)")
Rate limits

Fair use, per IP.

Public endpoints are limited to 60 requests per minute per IP. Exceeding the window returns 429. Partner keys use the same rolling 60-second window, with 120 requests for Standard, 300 for Growth, and 600 for Enterprise.

Partner API

Keyed access for partners.

Approved partners (IBs, distribution channels) get scoped API keys for server-to-server access. Send your key as Authorization: Bearer mkpk_…. Keys are scoped least-privilege: read:stats for referral aggregates and read:signals for the full redistribution feed (a stats-only key cannot reach signals). The full contract is published as a machine-readable OpenAPI schema, and a zero-dependency TypeScript SDK wraps it.

export MARKITEL_API_KEY="your_partner_key"

curl --fail-with-body   -H "Authorization: Bearer $MARKITEL_API_KEY"   https://markitel.com/api/v1/partners/me/stats
GET/api/v1/partners/me/statsscope: read:stats

Aggregate 30-day referral stats for the authenticated partner — clicks, signups, converted referrals, accrued commission, and pending payout. Aggregates only; never user-level data.

GET/api/v1/partners/me/signalsscope: read:signals

The full actionable signal feed for redistribution — entry/stop/take-profit levels, confidence, risk/reward. Page with ?cursor, poll deltas with ?since, size with ?limit (1–200). A read:stats-only key is rejected with 403.

Machine-readable errors

  • 401 · unauthorized / invalid key — the Bearer key is missing, invalid, or revoked.
  • 403 · insufficient_scope — the key is valid but lacks the required scope.
  • 503 · schema_not_applied — the partner surface is inactive in the target environment.

OpenAPI schema

# Machine-readable contract — codegen a client
GET https://markitel.com/api/v1/partners/openapi.json

TypeScript SDK

import { MarkitelPartnerClient } from "@markitel/partner-sdk";

const client = new MarkitelPartnerClient({ apiKey });
for await (const s of client.iterateSignals()) {
  console.log(s.asset, s.direction, s.entry_price_low);
}

The OpenAPI schema is public; the SDK ships with the partner program (distributed directly to approved partners with their key). read:signals is granted to contract-approved partners. Become a partner to request access, or follow the step-by-step connect guide. Approved API access is governed by the Partner Program Terms, API and SDK Terms, and Data Processing Addendum where partner-directed personal-data processing applies.

Full signal payloads unlock after the delay.

Free accounts unlock full signal payloads after the delay.

Start free