AI Trade Radar

Structured market state for bots and AI agents

One structured JSON view of market conditions your automations can trust—a market intelligence API for AI agents. Infrastructure telemetry, not trading signals.Surfaces: MarketState, cognition snapshots, replay validation, MCP tools, SSE streams, OpenAPI, and SDKs for AI agent automation—not financial advice.

Get API access Request access

View pricing · Documentation

Built for automation systems — not retail trading signals.

Built for automation systemsStructured JSON snapshotsWebhook-ready integrationsStable API contracts

CLI preview · not financial advice

Use cases

What teams use MarketState for

Risk, alerts, automation—not trade ideas.

Pause bots in bad regimes

Slow or stop when volatility posture breaches your guardrails.

Alert on liquidity stress

Ping your team when spreads or readiness signals suggest fragile market conditions.

One snapshot for every agent

Same cycle_id and schema across workers—no reconciling five feeds.

Less glue code

One HTTP surface instead of stitching vendors by hand.

Feed schedulers & notebooks

Pipe regime fields into cron, Airflow, or kernels.

Shared risk gates

One threshold config for every consumer of MarketState.

Snapshot preview

Illustrative MarketState-like fields

Demo rotation only—compare GET /v1/market-state on your deployment for real tokens and freshness.

BTC-USDv1

demo

read path · GET snapshot · replay-safe fields

Regime: range_chop
Volatility: compressed
Readiness: operational
Freshness: 620ms
Snapshot: …

MarketState

What’s in each snapshot

Machine-readable regime, volatility posture, readiness, freshness, and integrity hints—the same fields whether you poll REST, stream SSE, or call MCP.

Regime

Labels conditions so branches stay predictable.

Volatility posture

Noise expanding or compressing—not a direction call.

Cycle ID

Ties each document to the same pipeline run (pairs with archive and replay when enabled).

Streams & hooks

SSE for low-latency updates; outbound webhooks are operator-configured on the deployment you use.

Pipeline

Snapshot → subscribers

Illustrative trace (not live telemetry): one cycle_id fans out to MCP, SSE, cognition, and optional replay when your deployment enables them.

demo · sequencefor layout only · not a live bus

rotate scenarios

14:32:01.004HTTPGET /v1/market-state200 · sample latency

14:32:01.041SNAPcycle_id · 20260509_…schema_version v1

14:32:01.118DIFFmarket_state.volatilityfield change

14:32:01.240SSEsubscribe/market-state-cycleevent frame

Control plane

MarketState API

Contract-first surface—HTTP ingress, signed egress, same payload everywhere.

IntegrationGET/v1/market-stateGET/v1/cognition/snapshotGET/openapi.json

schema MarketStateV1 · v1

ingress HTTPS · egress signed hooks · deterministic snapshot ids

lifecycle · authorize → fetch snapshot → diff → emit webhook → subscriber ack

REST

HTTPS · JSON

Resource-first routes; errors carry stable codes.

OpenAPI

3.1 artifact

Pin revisions in CI; generate clients from the bundle.

Webhooks

HMAC · retries

Delivery receipts; verify before side effects.

SDK

Python · TypeScript

AiTradeRadarClient — retries on idempotent GETs; codegen from OpenAPI.

Automation

MCP · SSE · workers

Same cycle_id across HTTP, MCP invoke, streams, and replay validation.

Dashboard keys → bundle pull → GET /v1/market-state. Request beta

curlrequest · TLS · bearer

curl -sS https://ai-trade-radar-api-staging.onrender.com/v1/market-state \
  -H "Authorization: Bearer $AI_TRADE_RADAR_API_KEY" \
  -H "Accept: application/json"

Pythonclient · GET market-state

import os
from ai_trade_radar import AiTradeRadarClient

client = AiTradeRadarClient(
    base_url=os.environ["ATR_API_BASE"],
    api_key=os.environ["AI_TRADE_RADAR_API_KEY"],
)
state = client.fetch_market_state()
print(state["cycle_id"], state["market_state"]["regime"], state["integrity"]["fingerprint"][:16])

MarketState (JSON)response · schema 2026.05 · deterministic

{
  "schema_version": "v1",
  "generated_at_utc": "2026-05-09T14:00:12Z",
  "cycle_id": "20260509_113926",
  "freshness_seconds": 4.2,
  "is_stale": false,
  "pipeline_status": "ok",
  "payload_completeness": "full",
  "data_warnings": [],
  "structures": [],
  "market_state": {
    "regime": "range_chop",
    "volatility": "normal",
    "suppression": "normal",
    "risk_posture": "cautious",
    "directional_reliability": "medium",
    "readiness": "operational"
  },
  "confidence": { "realism": 0.47, "publication_rate": 1.0 },
  "integrity": {
    "fingerprint": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "replay_safe": true
  }
}

Webhook (JSON)egress · signed · shape illustrative

{
  "event_id": "evt_8k2n9pq1",
  "type": "market_state.updated",
  "delivered_at": "2026-05-09T14:01:02Z",
  "resource": { "cycle_id": "20260509_113926" },
  "diff": { "changed_paths": ["market_state.volatility", "market_state.regime"] }
}

Pricing

Choose the lane for your agent workflow

AI Trade Radar is a market intelligence API for AI agents and automation systems. Start with Sandbox to evaluate MarketState, Builder to connect real workflows, or Pro when your team needs archive access, wider replay coverage, and higher limits.

Infrastructure only — not trading signals, not financial advice, no custody, no execution.

Self-serve checkout is available for Sandbox, Builder, and Pro in supported payment regions.

Self-serve: Sandbox, Builder, and Pro.·Manual: Design Partner and Enterprise.

Limits and availability follow your agreement. We don't claim live readiness or performance outcomes here.

Self-serve plans

Evaluate

$49/mo

$399/yr

Agent Sandbox

Evaluate the MarketState API with demo replay, documentation, and SDK quickstart—ideal before you wire real automations.

MarketState API: basic access
Demo replay + docs + SDK quickstart
No cognition lane, SSE, or MCP on Sandbox

Upgrade when you need full agent workflows.

Start Sandbox

Use annual billing instead

Next step is secure checkout. Your API key is issued after payment is confirmed.

Agent-first

Recommended

$199/mo

$1,599/yr

Agent Builder

Production-oriented API infrastructure for AI agent automation: full MarketState, cognition, replay validation, SSE, MCP tools, OpenAPI, and SDKs.

MarketState + cognition
Replay validation, SSE, MCP tools, OpenAPI, SDKs
No archive APIs on Builder

Move to Pro when you need archives, wider replay, or team-scale limits.

Start Builder

Use annual billing instead

Next step is secure checkout. Your API key is issued after payment is confirmed.

Teams

$499/mo

$3,999/yr

Agent Pro

For teams that need archive access, wider replay coverage, higher limits, priority support, and an onboarding call—everything in Builder, then more scale.

Everything in Builder
Archive access + wider replay coverage
Higher limits · priority support · onboarding call

Infrastructure for operators—not trading signals or financial advice.

Start Pro

Use annual billing instead

Next step is secure checkout. Your API key is issued after payment is confirmed.

Prices shown are per month with annual totals on the line below each plan. When hosted checkout is available, start monthly and use Use annual billing instead under your plan if you prefer yearly billing.

Which plan should I choose?

Sandboxif you're evaluating the API and replay in a safe lane.
Builderif you're connecting agents or automations to MarketState.
Pro if you need archives, wider replay coverage, or higher team limits.

Compare Sandbox, Builder, and Pro

Same API infrastructure across lanes—pick the lane that matches how you ship. This is a buyer overview, not an exhaustive contract matrix; see docs for full detail.

Best for

SandboxEvaluate the API
BuilderBuild AI-agent workflows
ProTeam workflows with archives

MarketState API

SandboxBasic / limited
BuilderFull
ProFull + higher limits

Cognition snapshots

Sandbox—
BuilderIncluded
ProIncluded

Replay validation

SandboxDemo dataset
BuilderIncluded
ProIncluded + wider range

Archive access

Sandbox—
Builder—
ProIncluded

MCP / OpenAPI / SDKs

SandboxQuickstart
BuilderIncluded
ProIncluded

SSE streams

Sandbox—
BuilderIncluded
ProIncluded

API keys

Sandbox1 basic
Builder1–3
ProHigher quota

Support

SandboxDocs-first
BuilderEmail
ProPriority

Sandbox

Builder

Pro

Best for

Evaluate the API

Build AI-agent workflows

Team workflows with archives

MarketState API

Basic / limited

Full

Full + higher limits

Cognition snapshots

—

Included

Replay validation

Demo dataset

Included

Included + wider range

Archive access

—

Included

MCP / OpenAPI / SDKs

Quickstart

Included

SSE streams

—

Included

API keys

1 basic

1–3

Higher quota

Support

Docs-first

Priority

Need private onboarding?

For teams that need custom limits, procurement, security review, or deployment terms. Application or sales conversation — no self-serve checkout.

Partnership

$2k–$5k/mo

Custom annual

Design Partner

Private onboarding, custom limits, roadmap feedback, and founder access for a small set of partners.

Cadence: Weekly founder call
Limits: Custom
Support: Private channel

Application-only—we onboard a limited number of partners.

Apply for Design Partner

Application or sales conversation — no self-serve checkout.

Institutional

Custom/mo

Custom

Enterprise

Custom SLA, security review, retention terms, deployment agreements, and dedicated support for funds and infrastructure teams.

Commercial: Contract-shaped
Security & SLA: Negotiated
Support: Dedicated

Sales-led scoping and paperwork when you need it.

Contact sales

Application or sales conversation — no self-serve checkout.

Policies