Snapshot timestamp2026-06-30 17:02 UTC· id d02412e146dcverify snapshot →

PUBLIC // PROTOCOL LAYER//api-docs

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.

Contract ClarityPayload ExamplesIntegration Ready

GTIXT // integration architecture/Integration architecture

reference surface

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

GET/api/publications

Get the current GTIXT publication object with distribution surfaces and cited-by ledger.

{
  "success": false,
  "error": "Publication example unavailable"
}

Open endpoint

GET/api/publications/archive

Get the public publication archive with immutable references and filter metadata.

limityearseriestypemarket_statereference_id

{
  "success": false,
  "error": "Publication archive example unavailable"
}

Open endpoint

GET/api/publications/card

Get the SVG publication card for the current or requested reference.

reference_idseries

{
  "success": false,
  "error": "Publication card example unavailable"
}

Open endpoint

GET/api/publications/citations

Get the public cited-by ledger for GTIXT publication references.

reference_idlimit

{
  "success": true,
  "count": 0,
  "items": []
}

Open endpoint

Extended contracts

Open the wider market and infrastructure endpoints.

Optional detail

GET/api/index/latest

Get the latest GTIXT index snapshot with all constituents.

{
  "success": false,
  "error": "Live example unavailable"
}

Open endpoint

GET/api/firms

List all scored firms with optional pagination and sort.

limitoffsetsort

{
  "success": true,
  "count": 0,
  "total": 0,
  "firms": []
}

Open endpoint

GET/api/firms/:slug

Get detailed data for a specific firm by slug.

{
  "success": false,
  "error": "Firm sample not available"
}

Open endpoint

GET/api/intelligence

Get the public GTIXT interpretation-layer review contract with market observations, signals, and observed outcome counts.

presettimeframedays

{
  "success": false,
  "error": "Review contract example unavailable"
}

Open endpoint

GET/api/signals

Get the cross-surface GTIXT signal feed combining market signals and firm-level decision signals.

limitpresettimeframedays

{
  "success": true,
  "items": [],
  "market_signals": [],
  "firm_signals": []
}

Open endpoint

GET/api/firms/:slug/intelligence

Get 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"
}

Open endpoint

GET/api/events/firm/:slug

Get 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"
}

Open endpoint

GET/api/rankings

Get ranked firms with filters and pagination.

limitoffsetqjurisdictionrisk

{
  "success": true,
  "count": 0,
  "total": 0,
  "data": []
}

Open endpoint

GET/api/research

Get research feed generated from institutional documentation.

{
  "success": true,
  "count": 0,
  "data": []
}

Open endpoint

GET/api/data/exports/:dataset

Download public GTIXT export packages in JSON or CSV format.

format

{
  "success": false,
  "error": "Export example unavailable"
}

Open endpoint

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.