API

Preceptress API

Developer-first access to narrative intelligence, shift detection, market scoring, and live opportunities.
Platform Overview

Narrative → Signal → Trade

The Preceptress API gives developers direct access to the same intelligence layer powering the terminal: live briefings, narrative shifts, ranked prediction markets, and structured scoring outputs.

Build newsroom tools, market scanners, dashboards, alerts, and AI-native applications on top of a live intelligence engine that turns fast-moving narratives into structured signals.
Base URL
https://api.preceptress.ai/v1
Developer Snapshot
Primary Surface
JSON
Clean, structured API responses
Core Signal
Shift
Narrative rotation detection
Trading Layer
Bets
Ranked opportunities + scores
Auth
Bearer
Simple token-based access

Getting Started

All requests use Bearer authentication and return JSON.

curl -X GET "https://api.preceptress.ai/v1/briefings/latest" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
{ "ok": true, "data": {}, "meta": { "generated_at": "2026-03-29T23:00:00Z", "timezone": "America/New_York", "version": "v1" } }

Core Endpoints

The most important surfaces in the platform: briefings, shifts, opportunities, and the live board.

GET Briefings Live

Latest AI Briefing

/v1/briefings/latest
Returns the latest closed-window narrative briefing with headline, summary, bullets, trends, forecast, and timing metadata.
AI Summary Time Window Forecast
{ "ok": true, "data": { "headline": "Oil risk reprices global political mood", "summary": "Markets and political narratives rotated toward escalation risk...", "trend_1": "Energy exposure rose across discussion clusters", "forecast": "Watch for follow-through in oil-linked contracts" } }
GET Signals Live

Narrative Shift Signal

/v1/signals/shift
Returns the latest shift score, shift level, action bias, and a structured summary of what changed from one briefing window to the next.
Shift Score Action Bias Topic Rotation
{ "ok": true, "data": { "shift_level": "Moderate Shift", "shift_score": 4, "shift_action": "Review positions", "new_topics": ["oil", "iran"], "dropped_topics": ["fed"] } }
GET Bets Live

Top Opportunities

/v1/bets/opportunities?category=politics&limit=12
Returns the highest-ranked opportunities by score, edge, and liquidity. Built for alerts, dashboards, and automated market monitoring.
Score Edge Status
{ "ok": true, "data": [ { "question": "Will X happen before Y?", "category": "Politics", "score": 19, "status": "Best Bet YES", "yes": 24, "no": 76, "edge": 0.09, "liquidity": 804463, "volume": 16555618 } ] }
GET Board Live

Full Bets Board

/v1/bets/board?category=politics
Returns the live ranked market board for a selected category. Mirrors the main AI Markets terminal view.
Category Filter Ranked Rows Terminal Mirror
{ "ok": true, "data": [ { "market_id": "123", "question": "Example market question", "category": "Politics", "score": 11, "status": "Watch NO", "yes": 42, "no": 58, "edge": -0.03, "url": "https://polymarket.com/event/..." } ] }

What Makes This Different

Most APIs give you raw market data. Preceptress gives you structured intelligence.

Raw feeds tell you what exists.
Preceptress tells you what is changing, what matters, and where narrative pressure may be creating opportunity.

Pricing

Simple tiers for builders, analysts, and high-frequency intelligence users.

Starter
$29/mo
For developers exploring narrative intelligence workflows.
  • Latest briefing endpoint
  • Shift signal endpoint
  • Basic rate limits
  • Email support
Enterprise
Custom
For institutions building products on top of the intelligence layer.
  • Custom SLAs
  • Private endpoints
  • Dedicated support
  • Integration guidance