Public API Contract
Reference payloads and endpoint behavior from this page before wiring integrations.
Page note
API examples are aligned to public data routes and should be validated against your own rate and cache policy.
Integration architecture
Publication API
Live contract references for GTIXT publication objects, archive memory, citation surfaces, and the wider public data infrastructure.
Publication objects are immutable, reference-first, and ready for citation.
Live example payloads are generated from active public endpoints.
Public contracts stay readable without backend-only framing.
Interpretation-layer contracts explicitly disclose probabilistic provenance and calibration.
Publication archive, card, and cited-by surfaces stay aligned to the deployed runtime.
Advanced market contracts remain available below for deeper integration work.
Quick start
Public objects
Weekly Stress
Structural Watch
Payout Drift
Escalation Alert
Quick start call
curl -s https://gtixt.com/api/publications | jq '{publication: .publication.referenceId, market_state: .publication.marketState, confidence: .publication.confidence, legal_note: .publication.legalNote}'Publication contracts
Reference-first endpoint specifications
/api/publicationsGet the current GTIXT publication object with distribution surfaces and cited-by ledger.
{
"success": false,
"error": "Publication example unavailable"
}/api/publications/archiveGet the public publication archive with immutable references and filter metadata.
{
"success": false,
"error": "Publication archive example unavailable"
}/api/publications/cardGet the SVG publication card for the current or requested reference.
{
"success": false,
"error": "Publication card example unavailable"
}/api/publications/citationsGet the public cited-by ledger for GTIXT publication references.
{
"success": true,
"count": 0,
"items": []
}Extended contracts
Open the wider market and infrastructure endpoints.
Optional detail
Extended contracts
Open the wider market and infrastructure endpoints.
/api/index/latestGet the latest GTIXT index snapshot with all constituents.
{
"success": false,
"error": "Live example unavailable"
}/api/firmsList all scored firms with optional pagination and sort.
{
"success": true,
"count": 0,
"total": 0,
"firms": []
}/api/firms/:slugGet detailed data for a specific firm by slug.
{
"success": false,
"error": "Firm sample not available"
}/api/intelligenceGet the public GTIXT interpretation-layer review contract with market observations, signals, and observed outcome counts.
{
"success": false,
"error": "Review contract example unavailable"
}/api/signalsGet the cross-surface GTIXT signal feed combining market signals and firm-level decision signals.
{
"success": true,
"items": [],
"market_signals": [],
"firm_signals": []
}/api/firms/:slug/intelligenceGet the standardized firm review contract with truth defense, collapse detection explainability, pre-collapse timeline correlation, review scores, calibration, and observed outcome labels.
{
"success": false,
"error": "Firm review sample not available"
}/api/events/firm/:slugGet the firm event engine payload with truth-defense verdict, collapse detection explainability, pre-collapse sequence state, and detected critical events.
{
"success": false,
"error": "Firm event sample not available"
}/api/rankingsGet ranked firms with filters and pagination.
{
"success": true,
"count": 0,
"total": 0,
"data": []
}/api/researchGet research feed generated from institutional documentation.
{
"success": true,
"count": 0,
"data": []
}/api/data/exports/:datasetDownload public GTIXT export packages in JSON or CSV format.
{
"success": false,
"error": "Export example unavailable"
}Operational guidance
Public contracts cover benchmark, research, and export endpoints without authentication.
The review and signal routes are interpretation-layer products, not raw truth feeds; provenance and calibration fields must be carried through downstream clients.
Anonymous traffic should remain cache-aware and pagination-first for larger feeds.
Bulk retrieval should prefer dataset exports over repeated live endpoint polling.