API Guide | Preceptress

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

Authentication

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/..." } ] }

Design Principle

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

Pro

$99/mo

For research teams, traders, and live dashboards.

All core endpoints
Best bets + full board
Higher rate limits
Priority support

Enterprise

Custom

For institutions building products on top of the intelligence layer.

Custom SLAs
Private endpoints
Dedicated support
Integration guidance