API reference

Automato REST API

Every endpoint answers with JSON over HTTPS and reads the same data that powers the site: market regimes, trading signals and rankings. Responses are cached for a few minutes.

Authentication

Endpoints marked API plan require an active API subscription. Requests are authenticated with the session cookie you receive when you log in, so today the API is consumed from an authenticated browser session or by forwarding that cookie. Standalone API keys are not available yet.

View API plans Talk to us

Public endpoints

Open to everyone, no subscription needed.

GET/api/market/btcPublic

Current Bitcoin market regime, one entry per analyzed timeframe.

{
  "regime": [
    {
      "symbol": "BTC",
      "quoteAsset": "USDT",
      "timeframe": "one_h",
      "regime": "LONG_STRONG",
      "strength": 80.1,
      "aiConfidence": 86,
      "analyzedAt": "2026-09-02T18:35:00.000Z"
    }
  ]
}

GET/api/signalsPublic

Top active long and short signals. Entry, stop loss and take profit levels are only included for Premium accounts.

{
  "long": [
    {
      "id": "1",
      "symbol": "SOL",
      "quoteAsset": "USDT",
      "direction": "LONG",
      "regime": "LONG_STRONG",
      "reliability": 82,
      "strategy": "scalping",
      "timeframe": "fifteen_m",
      "detectedAt": "2026-09-02T18:21:00.000Z"
    }
  ],
  "short": [],
  "premium": false
}

GET/api/rankingsPublic

Markets ranked by average signal reliability and by average realized result over the last 7 days.

{
  "rankings": [{ "symbol": "SOL", "quoteAsset": "USDT", "score": 82 }],
  "profitable": [{ "symbol": "ETH", "quoteAsset": "USDT", "score": 4.2 }]
}

Versioned endpoints (/api/v1)

The stable surface for integrations. Most of them require an API plan.

GET/api/v1/market/btcPublic

Same Bitcoin regime payload as /api/market/btc, under the versioned prefix.

{ "regime": [ /* market regime rows */ ] }

GET/api/v1/signalsAPI plan

Up to 100 active signals, newest first, with all execution levels.

{
  "signals": [
    {
      "id": "1",
      "symbol": "SOL",
      "quoteAsset": "USDT",
      "strategy": "scalping",
      "timeframe": "fifteen_m",
      "direction": "LONG",
      "regime": "LONG_STRONG",
      "reliability": 82,
      "entryPrice": 203.42,
      "stopLoss": 198.75,
      "takeProfit1": 208.9,
      "takeProfit2": 214.3,
      "status": "active",
      "detectedAt": "2026-09-02T18:21:00.000Z"
    }
  ]
}

GET/api/v1/rankings/longAPI plan

The 20 most reliable active long signals.

{ "signals": [ /* signal objects */ ] }

GET/api/v1/rankings/shortAPI plan

The 20 most reliable active short signals.

{ "signals": [ /* signal objects */ ] }

GET/api/v1/crypto/{symbol}API plan

Up to 50 active signals for one market. The symbol is the base asset, for example BTC or SOL.

{ "symbol": "SOL", "signals": [ /* signal objects */ ] }

Errors

Status	Error	When it happens
401	Unauthorized	No valid session was sent with the request.
403	API access required	The account has no active API subscription.
400	Bad request	The request body or a parameter is invalid.

Errors are returned as { "error": "message" } with the matching HTTP status.