API Documentation

Comprehensive API documentation for MacroCycle AI data endpoints, data sources, and integration examples.

API Endpoints

GET/api/status

System status and version information

Response:

{
  "status": "operational",
  "last_updated": "2025-12-12T02:10:03Z",
  "version": "1.0.0"
}

GET/api/regime

Current macro regime probabilities

Response:

{
  "current": {
    "primary": "Disinflationary",
    "probability": 74,
    "horizon": "90d"
  },
  "timeseries": []
}

GET/api/shock

Narrative shock analysis across domains

Response:

[
  {
    "domain": "Fed",
    "score": 23,
    "intensity": "low",
    "top_headlines": []
  }
]

GET/api/mispriced

Top mispriced prediction markets

Response:

[
  {
    "id": "fed-cuts-q1-2026",
    "name": "Fed cuts rates by March 2026",
    "market_price": 0.34,
    "model_price": 0.52,
    "edge": 0.18
  }
]

GET/api/recommendations

Current AI-generated trade recommendations

Response:

[
  {
    "id": "rec-001",
    "market_name": "Fed cuts rates by March 2026",
    "position": "YES",
    "kelly_fraction": 0.08,
    "confidence_band": "65-78%"
  }
]

POST/api/chat

AI chat interface for macro analysis

Request Body:

{
  "message": "Probability Fed cuts by 2026-03-31"
}

Response:

{
  "answer": "There is a 52% chance the Fed cuts rates by 2026-03-31.",
  "rationale": "Cycle: liquidity remains tight...",
  "confidence": "medium",
  "horizon": "90 days"
}

Usage Examples

cURL Example

# Get current regime data
curl -X GET https://api.macrocycle.ai/api/regime \
  -H "Accept: application/json"

# Expected Response:
{
  "data": {
    "current": {
      "primary": "Disinflationary",
      "probability": 74,
      "horizon": "90d"
    }
  }
}

JavaScript Example

// Fetch mispriced markets
const response = await fetch('/api/mispriced');
const data = await response.json();

console.log('Top opportunities:', data.data);

// Chat with AI
const chatResponse = await fetch('/api/chat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    message: 'Probability Fed cuts by 2026'
  })
});

const result = await chatResponse.json();
console.log('AI Response:', result.answer);

Data Sources

Economic Data

Core macroeconomic indicators including inflation, employment, GDP, and monetary policy data.

FRED (Federal Reserve Economic Data)
OECD Economic Indicators
World Bank Open Data

Central Banks

Real-time policy communications, meeting minutes, and official statements from major central banks.

Federal Reserve APIs
ECB Statistical Data Warehouse
Bank of England API
Bank of Japan

News & Media

Real-time news feeds, central bank speeches, and narrative-shifting events with sentiment analysis.

Financial Times API
Bloomberg Terminal
Reuters News API
Federal Reserve Speeches

Prediction Markets

Market-derived probabilities from leading prediction market platforms for event outcome pricing.

PredictIt API
Kalshi API
PolyMarket GraphQL
Manifold Markets

Authentication

Currently, all endpoints are publicly accessible for demonstration purposes. In production, API access will require authentication.

Planned Authentication:

# Future: API Key Authentication
curl -X GET https://api.macrocycle.ai/api/regime \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Rate Limits & Support

Rate Limits

General API calls:1000/hour
Chat endpoint:100/hour
Burst limit:10/minute

Support & Contact

For API support and integration assistance:

Email: api@macrocycle.ai
Documentation: docs.macrocycle.ai
Status Page: status.macrocycle.ai

Ready to integrate?

Start building with our comprehensive API suite and bring AI-powered macro analysis to your applications.