API Console

Documentation, playground, agent integration, and signal reliability — all in one place.

⌘K

Connect to MarketSchema’s REST API in minutes. Free endpoints require no key — copy the curl below and go.

Quickstart — 3 minutes to your first response

No API key required for these calls. Copy, paste, and run.

Check API healthVerify the API is running and all components are healthy.

curl https://api.marketschema.com/health

Response:

{ "status": "healthy", "version": "1.0.0", "checks": { "api": "ok", "redis": "ok", "database": "ok" } }

List equity indicesGet all equity indices with latest computed values and signals.

curl "https://api.marketschema.com/indices?asset_class=equities"

Response:

[{ "symbol": "DCAI", "name": "Data Center & AI Infrastructure Index", "current_value": 0.7234, "signal": "accelerating" }, ...]

Get a specific indexPull full detail for DCAI including components.

curl https://api.marketschema.com/indices/DCAI

Response:

{ "symbol": "DCAI", "name": "Data Center & AI Infrastructure Index", "current_value": 0.7234, "components": [...], "attribution": {...} }

Pull 90 days of historyGet daily time series data for any index.

curl "https://api.marketschema.com/indices/DCAI/history?days=90"

Response:

{ "symbol": "DCAI", "data": [{ "period_date": "2025-11-17", "value": 0.5812, "signal": "stable" }, ...], "attribution": {...} }

Batch check multiple assetsEvaluate up to 25 assets in one call. Get 531 results with Schema Scores and state.

curl -X POST https://api.marketschema.com/v1/check/batch \ -H "X-API-Key: ms_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"tickers": ["AAPL", "NVDA", "MSFT"]}'

Response:

{ "decisions": [{ "ticker": "AAPL", "schema_score": 74, "schema_state": "tailwind", "action_bias": "long" }, ...], "market_context": { "regime": "risk_on", "gate_open": true } }

Subscribe to score updatesReal-time stream of score changes for any asset via Server-Sent Events.

curl -H "X-API-Key: ms_live_YOUR_KEY" \ "https://api.marketschema.com/v1/alerts/stream"

Response:

event: score_update data: {"ticker":"AAPL","schema_score":73,"schema_state":"tailwind","as_of":"2026-03-31T14:31:00Z"}

curl -X POST https://api.marketschema.com/v1/webhooks/register \ -H "X-API-Key: ms_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://your-bot.com/hook", "events": ["score_change"]}'

Response:

{ "webhook_id": "wh_abc123", "url": "https://your-bot.com/hook", "events": ["score_change"], "created_at": "2026-03-31T14:30:00Z" }

For Pro + API ($69/mo, discounted annual), add the header: -H "X-API-Key: ms_live_YOUR_KEY"

Authentication & Tiers

Public endpoints require no key. API keys are included in the Pro + API plan and authenticate via the X-API-Key request header.

PublicNo API key

--60 requests / minute per IP
--30-day rolling history
--10 indices (api_allowed only)
--EOD snapshots only

Pro + API$69 / mo

--API key access (X-API-Key header)
--Higher request limits
--5-year history depth
--All api_allowed indices
--WebSocket + SSE streaming

Header: X-API-Key: ms_live_...

Pro Example

# Authenticate with Pro key curl -H "X-API-Key: ms_live_YOUR_KEY" \ https://api.marketschema.com/indices/DCAI/history?days=1825

Core Concepts

Data Objects

Index

Proprietary composite index computed from weighted data series (z-score normalized).

Series

Raw time series from a source (FRED, Polygon, etc.). Subject to distribution_scope gating.

Stock

Equity/ETF profile with index memberships, environment signals, and narratives.

Essential

Market essential (gold, oil, 10Y yield, etc.) with feeds_into relationships.

Schema Event

Structured event from the compute pipeline: updates, shifts, alerts, storms.

Receipt

Cryptographic attestation of a compute run — verifiable proof of inputs/outputs.

Timestamp Semantics

as_of

When MarketSchema computed this value. Always UTC ISO-8601.

2026-02-15T19:00:00Z

released_at

When the underlying source data was originally published. May differ from as_of if data is delayed.

2026-02-14T21:00:00Z

period_date

The business date this data point represents (e.g. 2026-02-14 for Friday's close).

2026-02-14

calculated_at

Exact timestamp when the compute pipeline produced this value.

2026-02-15T04:30:12Z

Signal Values

The signal field on indices indicates directional momentum:

accelerating

Positive trend strengthening

decelerating

Negative trend strengthening

stable

No significant change

inflecting_up

Turning positive

inflecting_down

Turning negative

Distribution Scope

Every index and series carries a distribution_scope that controls API access:

api_allowed

Available via public and authenticated API. Default for most indices.

ui_only

Dashboard only. API requests return 403.

internal_only

Used internally for composite calculations. Not exposed.

dev_only

Development/staging only. Excluded from production.

Common Response Fields

Present on most index and series responses:

current_valuefloat | null

Current computed index value (z-score normalized)

as_ofdatetime

When the computation ran (UTC ISO-8601)

released_atdatetime

When the underlying source data became public

signalstring | null

Directional signal: accelerating, decelerating, stable, inflecting_up, inflecting_down

delta_1d / 1w / 1mfloat

Value change over 1 day, 1 week, 1 month

normalizationstring

Normalization method: zscore, minmax, composite

completenessobject

Component freshness: { total, current, stale[] }

methodology_versionstring

Formula version identifier (e.g. "1.0")

delay_noticestring | null

Data lag disclosure (e.g. "EOD — reflects prior close")

distribution_scopestring

API availability: api_allowed, ui_only, internal_only, dev_only

attributionobject

Source attribution with redistribution rights

Quickstart — 3 minutes to your first response

No API key required for these calls. Copy, paste, and run.

Check API healthVerify the API is running and all components are healthy.

curl https://api.marketschema.com/health

Response:

{ "status": "healthy", "version": "1.0.0", "checks": { "api": "ok", "redis": "ok", "database": "ok" } }

List equity indicesGet all equity indices with latest computed values and signals.

curl "https://api.marketschema.com/indices?asset_class=equities"

Response:

[{ "symbol": "DCAI", "name": "Data Center & AI Infrastructure Index", "current_value": 0.7234, "signal": "accelerating" }, ...]

Get a specific indexPull full detail for DCAI including components.

curl https://api.marketschema.com/indices/DCAI

Response:

{ "symbol": "DCAI", "name": "Data Center & AI Infrastructure Index", "current_value": 0.7234, "components": [...], "attribution": {...} }

Pull 90 days of historyGet daily time series data for any index.

curl "https://api.marketschema.com/indices/DCAI/history?days=90"

Response:

{ "symbol": "DCAI", "data": [{ "period_date": "2025-11-17", "value": 0.5812, "signal": "stable" }, ...], "attribution": {...} }

Batch check multiple assetsEvaluate up to 25 assets in one call. Get 531 results with Schema Scores and state.

curl -X POST https://api.marketschema.com/v1/check/batch \ -H "X-API-Key: ms_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"tickers": ["AAPL", "NVDA", "MSFT"]}'

Response:

{ "decisions": [{ "ticker": "AAPL", "schema_score": 74, "schema_state": "tailwind", "action_bias": "long" }, ...], "market_context": { "regime": "risk_on", "gate_open": true } }

Subscribe to score updatesReal-time stream of score changes for any asset via Server-Sent Events.

curl -H "X-API-Key: ms_live_YOUR_KEY" \ "https://api.marketschema.com/v1/alerts/stream"

Response:

event: score_update data: {"ticker":"AAPL","schema_score":73,"schema_state":"tailwind","as_of":"2026-03-31T14:31:00Z"}

Response:

{ "webhook_id": "wh_abc123", "url": "https://your-bot.com/hook", "events": ["score_change"], "created_at": "2026-03-31T14:30:00Z" }

For Pro + API ($69/mo, discounted annual), add the header: -H "X-API-Key: ms_live_YOUR_KEY"

Authentication & Tiers

Public endpoints require no key. API keys are included in the Pro + API plan and authenticate via the X-API-Key request header.

PublicNo API key

--60 requests / minute per IP
--30-day rolling history
--10 indices (api_allowed only)
--EOD snapshots only

Pro + API$69 / mo

--API key access (X-API-Key header)
--Higher request limits
--5-year history depth
--All api_allowed indices
--WebSocket + SSE streaming

Header: X-API-Key: ms_live_...

Pro Example

# Authenticate with Pro key curl -H "X-API-Key: ms_live_YOUR_KEY" \ https://api.marketschema.com/indices/DCAI/history?days=1825

Core Concepts

Data Objects

Index

Proprietary composite index computed from weighted data series (z-score normalized).

Series

Raw time series from a source (FRED, Polygon, etc.). Subject to distribution_scope gating.

Stock

Equity/ETF profile with index memberships, environment signals, and narratives.

Essential

Market essential (gold, oil, 10Y yield, etc.) with feeds_into relationships.

Schema Event

Structured event from the compute pipeline: updates, shifts, alerts, storms.

Receipt

Cryptographic attestation of a compute run — verifiable proof of inputs/outputs.

Timestamp Semantics

as_of

When MarketSchema computed this value. Always UTC ISO-8601.

2026-02-15T19:00:00Z

released_at

When the underlying source data was originally published. May differ from as_of if data is delayed.

2026-02-14T21:00:00Z

period_date

The business date this data point represents (e.g. 2026-02-14 for Friday's close).

2026-02-14

calculated_at

Exact timestamp when the compute pipeline produced this value.

2026-02-15T04:30:12Z

Signal Values

The signal field on indices indicates directional momentum:

accelerating

Positive trend strengthening

decelerating

Negative trend strengthening

stable

No significant change

inflecting_up

Turning positive

inflecting_down

Turning negative

Distribution Scope

Every index and series carries a distribution_scope that controls API access:

api_allowed

Available via public and authenticated API. Default for most indices.

ui_only

Dashboard only. API requests return 403.

internal_only

Used internally for composite calculations. Not exposed.

dev_only

Development/staging only. Excluded from production.

Common Response Fields

Present on most index and series responses:

current_valuefloat | null

Current computed index value (z-score normalized)

as_ofdatetime

When the computation ran (UTC ISO-8601)

released_atdatetime

When the underlying source data became public

signalstring | null

Directional signal: accelerating, decelerating, stable, inflecting_up, inflecting_down

delta_1d / 1w / 1mfloat

Value change over 1 day, 1 week, 1 month

normalizationstring

Normalization method: zscore, minmax, composite

completenessobject

Component freshness: { total, current, stale[] }

methodology_versionstring

Formula version identifier (e.g. "1.0")

delay_noticestring | null

Data lag disclosure (e.g. "EOD — reflects prior close")

distribution_scopestring

API availability: api_allowed, ui_only, internal_only, dev_only

attributionobject

Source attribution with redistribution rights