TIQ API Documentation

Programmatic access to TonalityIQ conviction analysis, return distributions, and SCHOLAR deep reads.

Base URL: https://eventhorizoniq.com | Authentication: API key in x-api-key header | Rate limit: varies by tier

Authentication

Include your API key in the x-api-key header with every request. Get your key by subscribing at /pricing.

curl -H "x-api-key: your_key_here" https://eventhorizoniq.com/api/tiq/conviction/BOX

GET/api/tiq/conviction/{ticker}

Get conviction trajectory and return distributions for a ticker

Auth: API Key (x-api-key header)

{"ticker":"BOX","latest":{"convictionType":"GROWTH_CONVICTION","convictionScore":94,"narrativeVsFundamental":"FUNDAMENTAL"},"returnDistribution":{"median_360d":4.6,"p75_360d":28.5,"p90_360d":59.7}}

GET/api/tiq/screener

Get all tickers with conviction data for screening

Auth: API Key

{"tickers":[{"ticker":"BOX","convictionType":"GROWTH_CONVICTION","convictionScore":94,"nvf":"FUNDAMENTAL","median360d":4.6}],"totalTickers":336}

POST/api/tiq/analyze

Analyze any transcript text and get conviction score

Auth: API Key

{"conviction_type":"GROWTH_CONVICTION","conviction_score":85,"narrative_vs_fundamental":"FUNDAMENTAL","topics":{"revenue_growth":8,"customer_growth":5}}

GET/api/tiq/breakout/{ticker}

Get breakout timing momentum for a ticker

Auth: API Key

{"ticker":"TRMB","tiqMomentum":{"convictionChange":19,"isRecentShift":true,"currentScore":95}}

GET/api/tiq/scholar

Get SCHOLAR deep reads (Claude API contextual analysis)

Auth: API Key

{"reads":[{"ticker":"BOX","scholar_analysis":"CONVICTION VERDICT: REAL. Revenue accelerating 3 straight quarters..."}]}

GET/api/tiq/{ticker}

Get base TIQ scores (constraint, conviction, ratio) per quarter

Auth: Free (rate limited)

{"ticker":"AAPL","totalQuarters":83,"signal":"NORMAL","history":[...]}

GET/api/ticker-health/{ticker}

Get traffic-light sensor health for a ticker

Auth: Free (rate limited)

{"ticker":"BTC","verdict":"CAUTIOUS","sensors":[{"name":"VIX Regime","state":"ELEVATED","color":"AMBER"}]}

Conviction Types Reference

GROWTH_CONVICTIONRevenue + customers growing, guidance raised

RESTRUCTURING_WORKINGCost cuts paying off, margins improving

RESTRUCTURING_EARLYCutting costs but results not yet confirmed

AI_TAILWINDAI helping the business (check narrative vs fundamental)

CASH_MACHINEGenerating cash regardless of narrative

PIVOT_IN_PROGRESSNew direction, unproven

STABLE_COMPOUNDERSteady execution, no drama

NARRATIVE_HYPE28% win rate at 90d. Buzzwords without fundamentals.

UNDER_SIEGELosing customers to competition or disruption

DETERIORATINGGuidance cut, management admitting problems

DEFENSIVE_DENIALHigh conviction + high hedge = denying reality

169,000 transcripts. 4,664 tickers. 20 linguistic patterns. 11 conviction types. Calibrated on real forward returns. Not NLP. Executive psychology.

Institutional inquiries: eric@eventhorizoniq.com