API Reference

Programmatic access to Phase Model structural regime data.

Base URL

https://api.phasemodel.xyz/v1

Authentication

Authenticated requests require an API key in the X-API-Key header. Generate your key in account settings.

X-API-Key: your_api_key

Get your API key

Public Endpoints

GET/core/phase/summaryPublic

Phase Summary

Returns the current regime and confidence score for a given asset. No authentication required.

Parameters

asset*Asset symbol. Supported: BTC, ETH, SOL, SP500, GOLD, SILVER, OIL, NYSE, SSE, STOXX, B3

Example

curl "https://api.phasemodel.xyz/v1/core/phase/summary?asset=BTC"

GET/core/phase/statesPublic

Phase States

Returns the list of available assets and their current structural phase.

Example

curl "https://api.phasemodel.xyz/v1/core/phase/states"

Institutional Only

GET/core/phase/currentInstitutional

Current Phase

Returns full current phase data including pillar breakdown for a given asset.

Parameters

asset*Asset symbol. Supported: BTC, ETH, SOL, SP500, GOLD, SILVER, OIL, NYSE, SSE, STOXX, B3

Example

curl "https://api.phasemodel.xyz/v1/core/phase/current?asset=BTC" \
  -H "X-API-Key: your_api_key"

GET/core/phase/historyInstitutional

Phase History

Returns the historical structural phases for a given asset within a date range.

Parameters

asset*Asset symbol. Supported: BTC, ETH, SOL, SP500, GOLD, SILVER, OIL, NYSE, SSE, STOXX, B3

start*Start date in YYYY-MM-DD format.

end*End date in YYYY-MM-DD format.

Example

curl "https://api.phasemodel.xyz/v1/core/phase/history?asset=BTC&start=2024-01-01&end=2024-12-31" \
  -H "X-API-Key: your_api_key"

GET/core/mcp/sseInstitutional

MCP SSE Stream

Real-time Server-Sent Events stream for Model Context Protocol integration with AI agents.

Example

curl "https://api.phasemodel.xyz/v1/core/mcp/sse" \
  -H "X-API-Key: your_api_key" \
  -H "Accept: text/event-stream"

POST/core/mcp/messageInstitutional

MCP Message

Send a message to the Phase Model MCP server and receive a structured response.

Example

curl -X POST "https://api.phasemodel.xyz/v1/core/mcp/message" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1}'

MCP Setup

Available on Institutional

MCP Integration

Connect AI agents directly to Phase Model regime data via the Model Context Protocol. Query current regimes, run historical analysis, and build autonomous workflows on top of structural signals — all through a standard MCP interface.

mcp tools

› get_phase_model_summary› get_phase_model_states› get_phase_model_current› get_phase_model_history

Cursor & clients with header support

{
  "mcpServers": {
    "phase-model": {
      "url": "https://api.phasemodel.xyz/v1/core/mcp/sse",
      "headers": {
        "X-API-Key": "your_api_key"
      }
    }
  }
}

claude.ai, ChatGPT & clients without header support — paste this URL

https://api.phasemodel.xyz/v1/core/mcp/sse?api_key=your_api_key

Available Tools

get_phase_model_summaryInstitutional

get_phase_model_statesInstitutional

get_phase_model_currentInstitutional

get_phase_model_historyInstitutional