io.github.Hlobo-dev/tengu-firm

Officialdeprecated336 toolsLive

by Hlobo-dev · TypeScript

One MCP key: prices, fundamentals, SEC filings, insider/13F/congressional trades. 336 tools.

Tengu FIRM MCP Server (`io.github.Hlobo-dev/tengu-firm`)

Tengu FIRM is a hosted Model Context Protocol (MCP) server that exposes market and quant data as native agent tools. It provides real-time and historical market data, SEC filings, insider and institutional (13F) and congressional trades, fundamentals, quant signals, and macro/private market data over MCP Streamable HTTP.

🛠️ Key Features

One API key
336 tools
Market & quant data coverage (real-time and historical)
SEC filings and multiple trade types (insider, 13F, congressional)
Fundamentals, quant signals, cited verdicts
Private markets and macro data
Streamable HTTP (JSON-RPC 2.0) via initialize, tools/list, tools/call

🚀 Use Cases

Build AI agents for market-data and quant workflows
Retrieve regulatory/public-market information (SEC filings, trades)
Access fundamentals and macro/private market inputs for analysis

⚡ Developer Benefits

MCP Streamable HTTP endpoint: https://firm.tengu.co/mcp
Standard MCP operations: initialize, tools/list, tools/call
Tool discovery through tools/list

⚠️ Limitations

Documentation excerpt does not specify tool schemas, rate limits, or supported environments beyond MCP Streamable HTTP.

Topics

ai-agentsfinancemarket-datamcpmodel-context-protocolquantsec-filingstradingmcp-serveroauthremote-mcpstreamable-httpwealthnowcreditfintechoptionsprivate-equityventure-capital

Captured live from the server via tools/list.

tengu_snapshot

Live price snapshot for one ticker: latest price plus basic trading stats. Call it when the user asks 'where is X trading right now?' or needs a current quote before any single-name analysis. Heavy endpoint — fetch one ticker per call.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_insider_clusters

Clusters of insider buying across companies: names where multiple distinct insiders bought around the same time. Call it when the user asks 'where are insiders buying?' or wants market-wide insider conviction rather than one company's filings.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_crypto

Live crypto quote from the market-data feed (real-time entitlement, 439 pairs): last-trade price, 24h change/volume (UTC-day basis), day + prev-day OHLC, optional last-7 daily bars, honest as_of. PRIMARY tool for 'what is BTC at?' — accepts BTC/BTCUSD/X:BTCUSD plus a vs currency (e.g. EUR); unknown symbols return a structured 404.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
vs	string	optional
series	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "vs": {
      "type": "string",
      "default": "USD"
    },
    "series": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_macro

One-call macro dashboard: VIX, DXY, treasury spreads, fear-greed, and the current regime read. Call it FIRST for any 'how is the overall market / macro backdrop?' question, or to frame a single-name view against market conditions.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_regime

Current market regime label plus the model's regime probabilities. Call it when the user asks 'what regime are we in?' or before positioning advice that depends on the prevailing regime; use tengu_v2_regime_forecast for the forward view and tengu_v2_regime_history for the past.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_research_knowledge

Research knowledge base

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_status

System status for the service. Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_ready

Readiness flags showing which subsystems are up and serving. Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_logs

Recent service log lines. Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale and status alone doesn't explain it.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_cache_stats

Cache hit-rate statistics for the data layer. Call when the user asks whether the system/data pipeline is healthy or why data looks stale or slow.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_intervals

Conformal prediction intervals for one ticker's forecast: a calibrated lower/upper band at the requested miscoverage alpha (default 0.1 = 90% interval). Call it when the user asks 'how confident is the model?' or wants an uncertainty range around a prediction rather than just a point estimate.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
alpha	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "alpha": {
      "type": "number",
      "default": 0.1,
      "minimum": 0.01,
      "maximum": 0.5
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v2_drift

Feature and prediction drift over a rolling window (default 30 days). Call it when the user asks whether the models are still well calibrated, why predictions look off, or whether model inputs have shifted recently.

Parameters1

window_days

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "window_days": {
      "type": "integer",
      "default": 30,
      "minimum": 1,
      "maximum": 365
    }
  }
}

tengu_v2_feature_importance

Top-N feature importances for the prediction models (default top 50, optionally filtered to one model). Call it when the user asks 'what is the model actually looking at?' or which inputs are driving current predictions.

Parameters2

top_n	integer	optional
model	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "top_n": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "model": {
      "type": "string"
    }
  }
}

tengu_v2_factor_decay

IC/IR half-life per factor — how fast each factor's predictive power decays. Call it when the user asks which signals are going stale, how long a factor's edge lasts, or before weighting factors in a strategy.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_regime_forecast

Forecast regime probabilities N days ahead (default 21-day horizon). Call it when the user asks 'is the regime about to change?' or wants the forward market-state outlook rather than today's label — use tengu_regime for the current read.

Parameters1

horizon_days

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "horizon_days": {
      "type": "integer",
      "default": 21,
      "minimum": 1,
      "maximum": 252
    }
  }
}

tengu_v2_regime_history

Historical regime labels over the last N days (default 180). Call it when the user asks how long the current regime has lasted, when the last regime shift happened, or wants past behavior broken out by regime.

Parameters1

days

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "default": 180,
      "minimum": 1,
      "maximum": 3650
    }
  }
}

tengu_v2_var

Portfolio VaR and CVaR at a chosen horizon and confidence (defaults: 1-day, 99%). Call it when the user asks 'how much could the portfolio lose?' or needs a tail-risk number before sizing or hedging decisions.

Parameters2

horizon_days	integer	optional
confidence	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "horizon_days": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 30
    },
    "confidence": {
      "type": "number",
      "default": 0.99,
      "minimum": 0.5,
      "maximum": 0.9999
    }
  }
}

tengu_v2_stress

Stress-test scenarios from the risk engine. Call it when the user asks 'what happens if things go bad?' before sizing risk; use tengu_v2_crash_scenarios to replay specific historical crashes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_crash_scenarios

Historical crash replay through past market crash episodes. Call it when the user asks 'how would this have held up in previous crashes?' or wants tail risk anchored to real historical events; use tengu_v2_stress for hypothetical scenarios.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_signal_correlation

Correlation matrix across the voter signals feeding the ensemble. Call it when the user asks whether the model's signals are independent or redundant — high pairwise correlation means the vote count overstates conviction.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_short_interest

Short interest for one ticker: shares short, days-to-cover (DTC), and fails-to-deliver (FTD). Call it FIRST for any 'is X heavily shorted / squeeze candidate?' question or before evaluating short-side risk in a position.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v2_alpha_discoveries

Mined alpha expressions from the research pipeline, filtered to a minimum information ratio (min_ir, default 0.5) and capped at `limit` (default 25). Call this when the user asks what alpha signals or factor expressions the research engine has actually discovered.

Parameters2

limit	integer	optional
min_ir	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 500
    },
    "min_ir": {
      "type": "number",
      "default": 0.5,
      "minimum": -5,
      "maximum": 10
    }
  }
}

tengu_v2_strategy_evolution

Strategy genealogy with out-of-sample (OOS) scores — how each evolved strategy variant descends from its parents and how it validated OOS, up to `limit` entries (default 50). Call this when the user asks how strategies were developed, mutated, or which generations survived validation.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v2_research_datasets

Discover the 39 licensed research datasets servable via the research-dataset reader — equity prices (daily/monthly/delistings/distributions/mutual funds), fundamentals (annual/quarterly/segments/customers/supply-chain), analyst estimates (summary/detail/guidance/price-targets/actuals/recs), implied volatility, securities-finance (full-history CDS + short interest), transcripts/ratings/key-developments, board relationships, forensic-audit filings, syndicated loans, ESG ratings, crowd estimates, TRACE bond trades and Fama-French factors. Call FIRST when unsure of a slug; not_ingested lists any slug awaiting a table (currently empty).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v2_research_read

Read any licensed research dataset by slug (discover via tengu_v2_research_datasets). ?ticker= pushes an exact server-side filter down the dataset's own symbol column when it has one; datasets keyed by an internal security id instead state explicitly that ticker was ignored. The `implied_vol_by_ticker` slug REQUIRES ?ticker= and resolves the symbol to that id automatically before pushdown. The `cds_composites` slug serves the FULL 2005–2025 spread history. Unfiltered reads are capped at 5000 rows.

Parameters3

dataset	string	required	Path parameter 'dataset' (required).
ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "description": "Path parameter 'dataset' (required)."
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 50000
    }
  },
  "required": [
    "dataset"
  ]
}

tengu_v3_agents_list

Catalogue of every agent in the swarm — one entry per agent. Call this when the user asks which agents exist, what the swarm is composed of, or to resolve an agent's name before drilling into its output.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_agent_status

Latest heartbeat + stats for one agent

Parameters1

agent_name

string

required

Path parameter 'agent_name' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "agent_name": {
      "type": "string",
      "description": "Path parameter 'agent_name' (required)."
    }
  },
  "required": [
    "agent_name"
  ]
}

tengu_v3_agent_latest

Recent outputs from a named agent

Parameters3

agent_name	string	required	Path parameter 'agent_name' (required).
ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_name": {
      "type": "string",
      "description": "Path parameter 'agent_name' (required)."
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "agent_name"
  ]
}

tengu_v3_trade_setups

Top trade setups from the decision engine with **defensive-alternates baked in**. When the screen is one-sided (>=70% same direction across 3+ picks), the response carries `universe_skew` = 'bearish' | 'bullish' | 'mixed' AND a `regime_warranted_alternative` block containing the editorial fallback basket (defensive | cash_heavy | value_tilt | momentum). Each alternative carries strategy label, curated candidates with thesis per name, and a one-sentence rationale. Brain consumes the alternative when the primary picks don't fit the user's risk frame — e.g. all-bearish screen on a long-bias capital-allocation query surfaces the `defensive` basket so the model never has to refuse or invent. Schema is ADDITIVE — primary `setups` array unchanged from v2.41.

Parameters2

limit	integer	optional
min_conviction	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 500
    },
    "min_conviction": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "maximum": 1
    }
  }
}

tengu_v3_universe_scan

Latest universe-scanner output: the most recent scan results across the tradable universe, up to `limit` names (default 100). Call this when the user asks what the scanner is flagging right now or wants a market-wide sweep before drilling into single tickers.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_ultimate_decision

Ultimate-engine aggregate decision for one ticker — the top-level verdict aggregated across the engine stack. PRIMARY tool for 'so what's the final call on <ticker>?' — call it when the user wants one consolidated decision rather than raw component signals.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_position_monitor

Live position monitor (exits, stops, flags)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_cost_estimate

Pre-trade expected execution cost for a ticker: spread, market impact, and commission for a given qty (default 100) and side (buy/sell). Call it to know what a trade will actually cost before sizing or routing it; use twap_plan/vwap_plan for the execution schedule itself.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
qty	integer	optional
side	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "qty": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 10000000
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "default": "buy"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_slippage

Realised slippage stats (mean/median/p95)

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
window_days	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "window_days": {
      "type": "integer",
      "default": 30,
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_twap_plan

TWAP child-order schedule for a ticker: a qty (default 100) sliced into evenly-timed child orders over `minutes` (default 60). Call this when the user asks how to work an order over time; use vwap_plan for a volume-curve schedule and cost_estimate for expected cost.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
qty	integer	optional
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "qty": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 10000000
    },
    "minutes": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 390
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_vwap_plan

VWAP child-order schedule for a ticker: a qty (default 100) sliced along the intraday U-curve volume profile. Call this when the user wants an order worked in line with typical intraday volume; use twap_plan for even time-slicing and cost_estimate for expected cost.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
qty	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "qty": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 10000000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_smart_route

Recommended venue mix (lit/dark/algo)

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
qty	integer	optional
side	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "qty": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 10000000
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ],
      "default": "buy"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_strategies_list

Catalogue of the 21-strategy library — one entry per strategy. Call this when the user asks which strategies exist or what the system can run, or to resolve a strategy name before drilling into its evolution or signals.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_strategy_signals

Latest signals from a named strategy

Parameters2

strategy_name	string	required	Path parameter 'strategy_name' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "strategy_name": {
      "type": "string",
      "description": "Path parameter 'strategy_name' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "strategy_name"
  ]
}

tengu_v3_strategy_metrics

Historical metrics for a named strategy

Parameters1

strategy_name

string

required

Path parameter 'strategy_name' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "strategy_name": {
      "type": "string",
      "description": "Path parameter 'strategy_name' (required)."
    }
  },
  "required": [
    "strategy_name"
  ]
}

tengu_v3_signals_fusion

Latest fused signals across all voters — the combined signal after voter aggregation, up to `limit` names (default 100). Call this when the user asks what the system's current signals are overall; use signals_mtf for one ticker's timeframe alignment.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_signals_mtf

One EQUITY cross-horizon ensemble row for a ticker. Despite the legacy `mtf` path name, the warehouse does NOT emit independent per-timeframe rows, so this tool cannot confirm 1m/4h/1w agreement and must not be cited as multi-timeframe evidence. Crypto requests fail closed.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_signals_veto

Active veto state — which risk, regime, or circuit-breaker (CB) vetoes are currently in force over signals. Call it to know whether signals are being suppressed before trusting any signal read; PRIMARY for 'why isn't the system acting on <ticker>?'.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_signals_cross_asset

Cross-asset regime signals — the regime read taken across asset classes rather than from single tickers. Call this when the user asks about the broader market regime or wants cross-asset confirmation of a single-asset view.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_self_healing

Recent and pending self-healing actions the system has taken or queued. Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_alerts_active

Currently-active alerts

Parameters1

severity

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "severity": {
      "type": "string",
      "enum": [
        "info",
        "warn",
        "error",
        "critical"
      ]
    }
  }
}

tengu_v3_system_health

Aggregate system health with per-subsystem status. Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_metrics

Recent system metrics (latency/QPS/error)

Parameters1

window_minutes

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "window_minutes": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 1440
    }
  }
}

tengu_v3_api_quotas

Per-feed external API quota usage and cap status (news, news-analytics, market-data, alt-data). Call when the user asks whether the system/data pipeline is healthy or why data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_accuracy

Realised-vs-predicted accuracy over a rolling window (window_days, default 90) — how well predictions matched what actually happened. Call this when the user asks how accurate the system has been or wants a track record before trusting a new call; use prediction_tracker for individual predictions.

Parameters1

window_days

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "window_days": {
      "type": "integer",
      "default": 90,
      "minimum": 1,
      "maximum": 3650
    }
  }
}

tengu_v3_resolver_status

Outcome-resolver status

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_prediction_tracker

Recent predictions with their resolution state, up to `limit` entries (default 200) — each call and whether it has resolved yet and how. Call this when the user asks what the system has predicted lately or how specific calls turned out; use accuracy for the aggregate hit-rate.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_optimizer_latest

Latest optimizer weights — the current weight set from the most recent optimization run. Call this when the user asks what the optimizer is currently recommending or how the latest run set its weights.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_memory_recall

Recall memory items by free-text query

Parameters2

query	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_memory_reflections

Post-trade reflections journal

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_backtest_runs

List recent backtest runs

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_backtest_run_detail

Detail for a single backtest run

Parameters1

run_id

string

required

Path parameter 'run_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "description": "Path parameter 'run_id' (required)."
    }
  },
  "required": [
    "run_id"
  ]
}

tengu_v3_lab_strategies

Strategies in the sandbox lab

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_lab_deployments

Live lab deployments (paper/tiny-cap)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_news_aggregated

MARKET-WIDE feed — not per-ticker (that is tengu_v3_news_summary). Aggregated cross-source news stream over the last N hours (default 24) for broad market-news sweeps and cross-source coverage checks.

Parameters2

hours	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "default": 24,
      "minimum": 1,
      "maximum": 168
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 1000
    }
  }
}

tengu_v3_news_events

Detected market-moving events across the market over a lookback window (hours param, default 24). Call this when the user asks 'did anything big happen today?' or wants a scan of recent catalysts market-wide; use tengu_v3_news_latest for headlines on one ticker.

Parameters1

hours

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "default": 24,
      "minimum": 1,
      "maximum": 168
    }
  }
}

tengu_v3_believability

Calibrated trust per signal source

Parameters2

source	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_thresholds

Currently-active decision thresholds — the live cutoff values gating automated trade decisions right now. Call it to know which thresholds are in force before interpreting why a signal did or didn't become a decision.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_hedging

Index hedge proposals (SPY/QQQ/IWM) computed from live dealer positioning — protective puts when dealers are short gamma and IV rank is cheap, collars when the 25-delta risk reversal shows calls rich, plus IV term-structure context

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_portfolio_risk_parity_latest

Latest naive risk-parity weights

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_validation_trials

Recent trials recorded in the DSR registry (limit param, default 100). Call it when the user asks what backtests or experiments have been run, or to audit the multiple-testing history behind a deflated Sharpe.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_validation_trial_count

Lifetime count of registered trials — the N used for DSR deflation. Call it to know how heavy the multiple-testing burden is before interpreting any deflated Sharpe, or when the user asks how many strategy variants have been tried.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_kelly_uncertainty

Uncertainty-discounted Kelly fraction for one ticker — the bet size after haircutting full Kelly for estimation error. Call this when the user asks 'how much should I bet on X?' or to know how large a position the evidence actually supports before sizing a trade.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_stream_ticks

SSE stream of live US-equity trades. A filtered connect queues cross-process T+Q coverage; the dedicated producer reconciles it asynchronously (target ~5s).

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_stream_bars

SSE stream of live 1-minute OHLCV bars for EVERY US-listed ticker (no subscribe step needed — the all-ticker feed is always on). Each frame closes one 1-minute candle ~1s after the venue closes it: open/high/low/close/volume/vwap + bar_period_s=60. The live-candle feed for charting; quiet outside ~04:00-20:00 ET, which is correct. For chart HISTORY use REST aggregates, not a stream.

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_stream_quotes

SSE stream of live per-venue bid/ask quote events for the requested symbols (bid/ask price+size + per-side venue IDs). Connecting auto-subscribes coverage within ~5s. Quiet outside US market hours — that is correct, not broken. Sizes are the venue's numbers untransformed; never present them as share counts.

Parameters1

symbols

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  },
  "required": [
    "symbols"
  ]
}

tengu_v3_stream_signals

SSE stream of fused signals

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_stream_decisions

SSE stream of decision-lifecycle events

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_stream_alerts

SSE stream of risk / guardrail alerts

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_news

SSE stream of structured-news items

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_stream_events

Per-user scoped SSE event stream

Parameters1

user_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string"
    }
  },
  "required": [
    "user_id"
  ]
}

tengu_v3_stream_market_events

SSE stream of freshness-labelled market events. Every record carries source as-of time, feed lag and staleness so old data cannot masquerade as a new breach.

Parameters1

symbols

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    }
  }
}

tengu_v3_market_events_catchup

Finite catch-up page for retained market events after a Redis stream id; use after reconnect and preserve each event's source freshness fields.

Parameters3

since	string	optional
symbols	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string"
    },
    "symbols": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  }
}

tengu_v3_stream_status

Bounded Redis reachability plus expiring market-producer and signal-pipeline heartbeats, per-capability readiness, coverage modes/limits and known SSE endpoints. Call before claiming live data or diagnosing missing/stale feeds.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_ingest_status

Live-data ingest daemon status: provider, subscribed symbols, connection uptime, tick/bar counters, last error. Call when the user asks why live data looks missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_signal_generator_status

Effective signal-generator status across the optional in-process worker and dedicated processor heartbeat: input ticks, emitted signals and deployment state. Call when live signals look missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_tick_writer_status

Tick writer (tick-persistence buffer) status: buffered rows, batches written, last flush duration. Call when the user asks whether the pipeline is healthy or why stored tick data looks missing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_decision_generator_status

Effective decision-generator status across the optional in-process worker and dedicated processor heartbeat: input signals, emitted decisions, deployment state and local gate counters. Call when decisions are missing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_news_publisher_status

News publisher status: polls completed, articles seen/published, dedup hits, newswire availability. Call when the user asks why news looks missing/stale or whether the pipeline is healthy.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_universe_status

Legacy in-process UniverseManager diagnostics for dev. For production cross-process warm coverage use tengu_v3_market_universe and tengu_v3_stream_status.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_market_universe

Cross-process shared warm-set catalog plus the dedicated US-equity producer heartbeat, research-universe count, capacity and effective readiness. Warm means requested, not provider-confirmed.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_stream_realtime_guide

Agent protocol for real-time queries: which SSE feed maps to which intent (live price, signals, decisions, news, alerts), payload shapes, when to prefer SSE over REST, and fallback rules when flags are off

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_news_latest

DRILL-DOWN ONLY — never a first-round call and never alongside tengu_v3_news_summary (it already includes recent stories). Raw newswire headlines for one ticker over a lookback window (minutes param, default 60; 60s TTL) for when the summary's stories are insufficient or you need a tighter time window.

Parameters2

ticker	string	optional
minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "minutes": {
      "type": "integer",
      "default": 60,
      "minimum": 5,
      "maximum": 1440
    }
  }
}

tengu_v3_news_by_topic

Topic-filtered headlines (earnings, analysts, dividend, mergers, acquisition, ipo, fda, guidance, stock_buyback, insider, lawsuit, esg, crypto, and more), optionally per ticker, over a date_range (default last7days, 50 items). Call it when the user asks about a specific event type — 'any FDA news?', 'recent M&A headlines'.

Parameters4

topic	string	required
ticker	string	optional
items	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  },
  "required": [
    "topic"
  ]
}

tengu_v3_news_sentiment_stats

Daily news-sentiment rollup for one ticker: a -1.5 to +1.5 score per day with article counts, over a date_range (default last30days). Call it when the user asks how sentiment on X is trending or whether coverage has turned negative; use tengu_v3_news_latest for the actual headlines.

Parameters2

ticker	string	required
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "default": "last30days"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_market_sentiment

Overall market-wide news-sentiment rollup over a date_range (default last7days). Call this when the user asks how the market 'feels' right now or whether the news backdrop is bullish or bearish — before drilling into single tickers.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  }
}

tengu_v3_news_trending

DRILL-DOWN ONLY — never alongside tengu_v3_news_summary (it already includes trending status). The newswire's noise-filtered top stories for a ticker, for when you specifically need the trending ranking on its own.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_news_top_mentions

Most-mentioned tickers in the news over a window (default today), optionally filtered by sector — a market-attention proxy. Call this when the user asks which stocks are getting the most buzz or where the crowd's focus is today.

Parameters2

date_range	string	optional
sector	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "today"
    },
    "sector": {
      "type": "string"
    }
  }
}

tengu_v3_news_sundown

Curated end-of-day 'sundown' digest — a market-close recap of the day's news from the newswire, over an optional date_range. Call this when the user asks 'what happened in the market today' or wants a daily wrap-up.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string"
    }
  }
}

tengu_v3_news_curated_events

Structured market events — earnings, M&A, FDA decisions, guidance changes, price-target moves — filterable by ticker, event_type, and date_range (default today). Call this when the user asks 'what events happened' or 'any catalysts for X' instead of scanning raw headlines.

Parameters4

ticker	string	optional
event_type	string	optional
date_range	string	optional
items	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "event_type": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "default": "today"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    }
  }
}

tengu_v3_news_ticker_news

FILTERED-SEARCH ONLY — reach for this when the user specifies filters (topic, sector, source, sentiment, date_range, article/video, free-text search) or multi-ticker search. Never for plain 'what's the news on X?' (that is tengu_v3_news_summary). Full newswire filter spec; sortby rank or oldestfirst.

Parameters17

tickers	string	required
items	integer	optional
page	integer	optional
date_range	string	optional
sector	string	optional
topic	string	optional
topic_or	string	optional
topic_exclude	string	optional
source	string	optional
source_exclude	string	optional
news_type	string	optional
sentiment	string	optional
sortby	string	optional
days	integer	optional
search	string	optional
search_or	string	optional
fallback	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string"
    },
    "sector": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    },
    "topic_or": {
      "type": "string"
    },
    "topic_exclude": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "source_exclude": {
      "type": "string"
    },
    "news_type": {
      "type": "string",
      "enum": [
        "article",
        "video"
      ]
    },
    "sentiment": {
      "type": "string",
      "enum": [
        "positive",
        "negative",
        "neutral"
      ]
    },
    "sortby": {
      "type": "string",
      "enum": [
        "rank",
        "oldestfirst"
      ]
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "search": {
      "type": "string"
    },
    "search_or": {
      "type": "string"
    },
    "fallback": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_news_ticker_only

News stories tagged with ONLY this one ticker — the strictest filter, excluding articles that co-tag competitors or peers. Call this when the user wants pure company-specific coverage without sector noise; use ticker_news for broader filtered search.

Parameters3

ticker	string	required
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_multi_ticker

News stories where ALL the listed tickers co-appear in the same article — a correlation feed. Call this when the user asks how two or more companies are linked in the news (deals, rivalries, shared catalysts); use ticker_news for per-ticker coverage.

Parameters3

tickers	string	required
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_news_all_tickers_sentiment

Sentiment leaderboard across the full tracked ticker universe over a date_range (default last7days), paginated. Call this when the user asks which stocks have the most positive or negative news sentiment right now — a screening pass before single-name digs.

Parameters2

date_range	string	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_v3_news_alerts

Headline-only alert stream — lighter and faster than full news items; category=general for market-wide or category=ticker with tickers for specific names. Call this when the user wants breaking headlines or the very latest on a name and speed matters more than article bodies.

Parameters4

category	string	optional
tickers	string	optional
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "general",
        "ticker"
      ]
    },
    "tickers": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  }
}

tengu_v3_news_ratings

Analyst rating actions — upgrades, downgrades, and initiations, filterable by tickers, rating_type, and date_range; history goes back to 2022-04-08. PRIMARY tool for 'any recent upgrades or downgrades on X?' and for gauging how sell-side conviction is shifting.

Parameters5

tickers	string	optional
rating_type	string	optional
date_range	string	optional
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "rating_type": {
      "type": "string",
      "enum": [
        "upgrade",
        "downgrade",
        "initiation"
      ]
    },
    "date_range": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  }
}

tengu_v3_news_event_by_id

All news items belonging to one clustered event, looked up by eventid, paginated. Call this when you already have an eventid from another news result and the user wants the full article set behind that single catalyst or story cluster.

Parameters3

eventid	string	required
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "eventid": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "eventid"
  ]
}

tengu_v3_news_category

Category-scoped news feed: section=general for market-wide or alltickers for company-tagged stories, filterable by topic, sector, industry, and source. Call this when the user wants themed or sector-level news rather than coverage of a specific ticker.

Parameters8

section	string	optional
topic	string	optional
sector	string	optional
industry	string	optional
source	string	optional
items	integer	optional
page	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "general",
        "alltickers"
      ],
      "default": "general"
    },
    "topic": {
      "type": "string"
    },
    "sector": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string"
    }
  }
}

tengu_v3_news_summary

One-shot news intelligence for a ticker: recent stories, sentiment stats, trending status, structured events, and analyst actions in a single parallel fetch (90s TTL). THE primary tool for 'what's the news on X?' — this ALONE answers most single-ticker news questions; do NOT stack other news tools in the same round unless it returns nothing useful.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_structured

LLM-structured news items — event_type, tickers, sentiment, magnitude, confidence

Parameters4

hours	integer	optional
ticker	string	optional
event_type	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "type": "integer",
      "default": 72,
      "minimum": 1,
      "maximum": 720
    },
    "ticker": {
      "type": "string"
    },
    "event_type": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 2000
    }
  }
}

tengu_v3_fundamentals_income_statements

SEC EDGAR income statements (P&L line-items, revenue through net income/EPS) for a ticker — quarterly, annual, or TTM (default quarterly, last 8 periods). Call this when the user asks about revenue or earnings trends and wants the actual reported statements.

Parameters3

ticker	string	required
period	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "quarterly"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_balance_sheets

SEC EDGAR balance sheets for a ticker — assets, liabilities, and equity line-items per period, quarterly or annual (default quarterly, last 8 periods). Call this when the user asks about cash on hand, debt load, or book value straight from reported filings.

Parameters3

ticker	string	required
period	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "quarterly"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_cash_flow_statements

SEC EDGAR cash-flow statements for a ticker — operating, investing, and financing flows per period, quarterly or annual (default quarterly, last 8 periods). Call this when the user asks about cash generation, capex, buybacks, or how earnings convert to actual cash.

Parameters3

ticker	string	required
period	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "quarterly"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_all

All three financial statements — income, balance sheet, and cash flow — for a ticker in one round-trip (default quarterly, last 4 periods). Call this when the user wants a full fundamental picture of a company instead of three separate statement calls.

Parameters3

ticker	string	required
period	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "quarterly"
    },
    "limit": {
      "type": "integer",
      "default": 4,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_metrics

Derived financial-metric rows per period for a ticker — P/E, ROE, margins, FCF yield, debt ratios — quarterly, annual, or TTM (default quarterly, last 4 periods). Call this when the user asks about valuation or quality ratios and their trend without needing raw statement line-items.

Parameters3

ticker	string	required
period	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "period": {
      "type": "string",
      "enum": [
        "annual",
        "quarterly",
        "ttm"
      ],
      "default": "quarterly"
    },
    "limit": {
      "type": "integer",
      "default": 4,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_metrics_snapshot

Latest financial-metrics snapshot for a ticker — a single TTM row of valuation and quality ratios. Call this for a quick 'what's the P/E, how profitable is X right now?' check; use fundamentals_metrics when the user needs the per-period history.

Parameters1

ticker

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_insider_trades

Form-4 insider transactions for one ticker — officer and director buys and sells (default limit 50). Call this when the user asks whether insiders are buying or selling a stock, or wants insider-conviction evidence for a name.

Parameters2

ticker	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_institutional_ownership

13F institutional holdings for one ticker, itemized by holding institution (default limit 50). Call this when the user asks which institutions or funds own a stock or how concentrated institutional ownership is.

Parameters2

ticker	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_companyfacts

Directory of every as-reported XBRL concept (us-gaap/dei/ifrs-full) a company has filed — unit(s), observation count and period coverage — from the in-house SEC EDGAR companyfacts corpus. Call it FIRST to find the concept tag for /fundamentals/xbrl/{ticker}/{concept}. Point-in-time, no vendor restatement.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
search	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "search": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 400,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_xbrl

One XBRL concept's as-reported history — period, value, fiscal year/period, SEC form, accession, filed date — from the in-house SEC EDGAR companyfacts corpus. Call it for exact as-filed fundamentals: as_of= for point-in-time (no restatement look-ahead), history=true for all restatements; find tags via /fundamentals/companyfacts.

Parameters10

ticker	string	required	Path parameter 'ticker' (required).
concept	string	required	Path parameter 'concept' (required).
taxonomy	string	optional
unit	string	optional
form	string	optional
start	string	optional
end	string	optional
as_of	string	optional
history	boolean	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "concept": {
      "type": "string",
      "description": "Path parameter 'concept' (required)."
    },
    "taxonomy": {
      "type": "string"
    },
    "unit": {
      "type": "string"
    },
    "form": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "as_of": {
      "type": "string"
    },
    "history": {
      "type": "boolean",
      "default": false
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker",
    "concept"
  ]
}

tengu_v3_tape_options_chain

Full historical OPTIONS CHAIN for one underlying on one snapshot day from FIRM's own daily market-data capture — per contract: strike, expiry, dte, bid/ask/mid/last, day volume + VWAP, implied volatility, the full greeks (delta/gamma/theta/vega), open interest and underlying price, plus a chain summary (contract/expiration counts, put/call OI + volume ratios, front-month ATM IV). Use it to reconstruct the IV surface, greeks or OI distribution AS IT STOOD on a past day, find where OI/volume concentrated, or pull the near-the-money strikes around an event. Omit date for the latest captured day (reported as snapshot_day); filter by side, expiration/dte, min OI/volume or a moneyness band; sort by open interest or dollar notional. Capture begins 2026-05-10. For the raw options TRADE tape use tengu_v3_tape_options; for live GEX/dealer flow use the options_flow tools.

Parameters11

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
contract_type	string	optional
expiration	string	optional
min_dte	integer	optional
max_dte	integer	optional
min_open_interest	number	optional
min_volume	number	optional
moneyness	number	optional
sort	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "contract_type": {
      "type": "string",
      "enum": [
        "call",
        "put"
      ]
    },
    "expiration": {
      "type": "string"
    },
    "min_dte": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650
    },
    "max_dte": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650
    },
    "min_open_interest": {
      "type": "number",
      "minimum": 0
    },
    "min_volume": {
      "type": "number",
      "minimum": 0
    },
    "moneyness": {
      "type": "number",
      "minimum": 0,
      "maximum": 5
    },
    "sort": {
      "type": "string",
      "enum": [
        "open_interest",
        "notional"
      ],
      "default": "open_interest"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_vol_surface

standardized implied-vol SURFACE for a company, joined from a plain equity ticker (resolves the symbol to the surface's internal id via the link table). Returns the standardized surface grid: for each maturity (days = 30/60/91/182/365) and delta node, per call/put the interpolated implied volatility and its dispersion — the clean vol skew + term structure behind risk-reversals, butterflies and the ATM vol term structure. Use to read a name's vol smile or how implied vol changes across expiries. Omit date for the latest-available surface (lagged academic archive — currently the 2011 slice, 3,956 names); pass date=YYYY-MM-DD for a specific session and days= to pin one maturity. Standardized grid, NOT the raw chain — for live per-contract quotes use /intel/options_chain.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
days	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "days": {
      "type": "number"
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_funds_mutual_fund_ownership

Which mutual funds hold a stock — each fund's percent_tna, shares and market value, largest first, plus report_dt and n_funds, from the survivor-bias-free holdings archive (coverage 2002-2021; no date = latest lagged quarter-end). Call it for mutual-fund demand base or holder concentration; for 13F institutional holders use /intel/sec13f.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
top	integer	optional
min_market_val	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "top": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 5000
    },
    "min_market_val": {
      "type": "number",
      "minimum": 0
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_factor_predictors

academic open-source predictor panel for one stock — a compact vector of 13 replicated accounting anomalies (Sloan accruals, Cooper-Gulen-Schill asset growth, Titman capital investment, Novy-Marx gross profitability, Fama-French operating profitability, cash-to-assets, leverage change, earnings consistency, revenue growth, positive-NI/positive-CFO flags, current ratio, net share issuance) at monthly grain. Call it for a ready-made feature vector when you don't need the full ~460-column factor panel. Returns the series newest-last, or with latest=true only the single most-recent row as a name->value map; with no start/end it serves the LATEST AVAILABLE rows (lagged quarterly archive) and reports the actual window. Ticker is resolved to its internal security key automatically (the table has no ticker column).

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
latest	boolean	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "latest": {
      "type": "boolean",
      "default": false
    },
    "limit": {
      "type": "integer",
      "default": 600,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_segments

Business + geographic SEGMENT breakdown for one company — decomposes a fiscal period into reportable segments by line of business, geography, ASC-280 operating segment and US state, each with sales, revenue, operating income and SIC, grouped by segment type. Call it to see WHERE a company earns: revenue mix by region (e.g. Greater China share) or which line of business carries the margin. Internally keyed (the ticker is resolved via the point-in-time name master, most-recent row); the archive lags, so with no year/date it returns the LATEST available period and reports the datadate served. Values are in the reported currency, fundamentals's millions convention.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
year	integer	optional
date	string	optional
stype	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "year": {
      "type": "integer",
      "minimum": 1960,
      "maximum": 2100
    },
    "date": {
      "type": "string"
    },
    "stype": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_earnings_press_releases

Full text of a company's earnings press releases, including guidance language (default limit 8). Call this when the user asks what management said or guided in an earnings release, or wants exact announcement wording.

Parameters2

ticker	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_sec_filings

SEC filings list for a ticker — 10-K, 10-Q, 8-K, S-1 and more, with an optional form_type filter (default limit 20). Call this when the user asks what a company has filed or wants to locate a specific filing type.

Parameters3

ticker	string	required
limit	integer	optional
form_type	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 200
    },
    "form_type": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_company_facts

Static company profile for one ticker — sector, industry, CIK, exchange, market cap and employee count. Call it to know what a company is and how big it is before deeper analysis. Not the XBRL corpus — that discovery lives at /fundamentals/companyfacts/{ticker}.

Parameters1

ticker

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_prices

Historical OHLCV bars for one ticker at second/minute/hour/day/week/month granularity (interval_multiplier for e.g. 5-minute bars; start_date/end_date window, default limit 1000). Call this when the user asks for price history, returns over a window, or intraday bars; for the latest quote use /fundamentals/price_snapshot. CRYPTO: pass asset_class=crypto for BTC/ETH/SOL/LTC/LINK etc. Several crypto symbols are ALSO US-listed equity tickers (BTC is a Grayscale trust at ~$29; LINK is Interlink Electronics), so a bare ticker returns the EQUITY. Never use an equity price for a crypto asset.

Parameters7

ticker	string	required
asset_class	string	optional
interval	string	optional
interval_multiplier	integer	optional
start_date	string	optional
end_date	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "asset_class": {
      "type": "string",
      "enum": [
        "equity",
        "crypto"
      ],
      "default": "equity"
    },
    "interval": {
      "type": "string",
      "enum": [
        "second",
        "minute",
        "hour",
        "day",
        "week",
        "month"
      ],
      "default": "day"
    },
    "interval_multiplier": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 60
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_price_snapshot

Latest quote for one ticker — last trade plus the current daily bar. Call this when the user asks what the price is now or how the stock is moving today; for history use /fundamentals/prices. CRYPTO: pass asset_class=crypto for BTC/ETH/SOL/LTC/LINK etc. Several crypto symbols are ALSO US-listed equity tickers (BTC is a Grayscale trust at ~$29; LINK is Interlink Electronics), so a bare ticker returns the EQUITY. Never use an equity price for a crypto asset. Check is_stale before using the price.

Parameters2

ticker	string	required
asset_class	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "asset_class": {
      "type": "string",
      "enum": [
        "equity",
        "crypto"
      ],
      "default": "equity"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_news

Curated news articles for one ticker from the fundamentals market-data feed, with start_date/end_date filtering (default 50). Call it for ticker-scoped headlines while working inside fundamentals; it is distinct from the primary news surface — use the news tools for broad or breaking coverage.

Parameters4

ticker	string	required
limit	integer	optional
start_date	string	optional
end_date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_full

One-shot fundamentals bundle for a ticker — metrics snapshot, TTM income, latest balance sheet and cash-flow, company facts, recent insider trades and top institutional holders, fetched in parallel. PRIMARY tool for 'give me the full fundamental picture of X' — call it instead of assembling the pieces one by one.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_company_full

One-call company snapshot — info + TTM + ratios + growth + MRQ balance (fundamentalsapi.com)

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_growth

Growth metrics — YoY, 3Y CAGR, 5Y CAGR and margin trends; accepts comma-separated tickers for one-call bulk comparison. Call this when the user asks how fast a company is growing, whether margins are trending up, or to compare growth across several names.

Parameters2

tickers	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_fundamentals_dividends

Dividend profile per ticker — DPS, payout ratio, consecutive-growth streak and 10Y history; accepts comma-separated tickers. Call this for any dividend-safety, income or 'how long has X raised its dividend' question.

Parameters1

tickers

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_fundamentals_peers

Same-industry comparables for a ticker, ranked by revenue, margins and ROE (default 10). Call this when the user asks who a company's competitors are or how it stacks up against peers — fetch it before any relative-valuation take.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_search

Fuzzy company lookup — resolves a free-text name or partial ticker to matching companies (default 10). Call it FIRST when the user names a company without a ticker, before firing any ticker-keyed fundamentals tool.

Parameters2

q	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "q"
  ]
}

tengu_v3_fundamentals_tickers

Paged listing of the full covered ticker universe, filterable to S&P 500 membership or one sector (limit/page paging). Call it when the user wants all the stocks in a sector or an index-membership list to feed a screen.

Parameters4

is_sp500	boolean	optional
sector	string	optional
limit	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "is_sp500": {
      "type": "boolean",
      "default": false
    },
    "sector": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 500
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 200
    }
  }
}

tengu_v3_fundamentals_screener

Multi-filter stock screener combining profitability (ROE, ROA, net margin), growth (revenue, EPS), financial-health (debt/equity, current ratio) and dividend filters, with sector/industry scoping and sort control. PRIMARY tool for 'find me stocks that…' asks; ready-made strategies live in /fundamentals/screener/presets.

Parameters16

sector	string	optional
industry	string	optional
roe_min	number	optional
roe_max	number	optional
roa_min	number	optional
net_margin_min	number	optional
revenue_growth_min	number	optional
eps_growth_min	number	optional
debt_to_equity_max	number	optional
current_ratio_min	number	optional
years_dividend_growth_min	integer	optional
payout_ratio_max	number	optional
sort_by	string	optional
sort_order	string	optional
limit	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sector": {
      "type": "string"
    },
    "industry": {
      "type": "string"
    },
    "roe_min": {
      "type": "number"
    },
    "roe_max": {
      "type": "number"
    },
    "roa_min": {
      "type": "number"
    },
    "net_margin_min": {
      "type": "number"
    },
    "revenue_growth_min": {
      "type": "number"
    },
    "eps_growth_min": {
      "type": "number"
    },
    "debt_to_equity_max": {
      "type": "number"
    },
    "current_ratio_min": {
      "type": "number"
    },
    "years_dividend_growth_min": {
      "type": "integer"
    },
    "payout_ratio_max": {
      "type": "number"
    },
    "sort_by": {
      "type": "string"
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "default": "desc"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 100
    }
  }
}

tengu_v3_fundamentals_screener_presets

Catalog of pre-built screener strategies — Aristocrats, Cash Cows, Value, Quality and more. Call it when the user asks for a named strategy screen or wants screening ideas before composing /fundamentals/screener filters.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_fundamentals_ai_analyze

AI-generated company analysis for one ticker — summary, strengths, concerns, peer comparison and a quality score. Call this when the user wants a synthesized qualitative read rather than raw numbers. Premium: metered at 100 credits/mo.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_historical

Multi-decade historical financial statements for one ticker from SEC EDGAR — income, balance, and cash-flow, filterable by statement_type and start_year/end_year, annual by default with include_quarterly opt-in. Call this when the user asks how fundamentals have trended over many years, not just the latest print.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
statement_type	string	optional
start_year	integer	optional
end_year	integer	optional
include_quarterly	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "statement_type": {
      "type": "string",
      "enum": [
        "income",
        "balance",
        "cashflow",
        "all"
      ],
      "default": "all"
    },
    "start_year": {
      "type": "integer",
      "minimum": 1990,
      "maximum": 2100
    },
    "end_year": {
      "type": "integer",
      "minimum": 1990,
      "maximum": 2100
    },
    "include_quarterly": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_options_flow

Recent unusual options-flow alerts across the whole market from the options-flow feed, filtered to trades above min_premium (default $50k). Call this when the user asks 'what is the smart money buying today?' or wants market-wide unusual options activity; use tengu_v3_intel_options_flow_ticker for a single name.

Parameters2

limit	integer	optional
min_premium	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    },
    "min_premium": {
      "type": "integer",
      "default": 50000,
      "minimum": 0,
      "maximum": 100000000
    }
  }
}

tengu_v3_intel_options_flow_ticker

Unusual options-flow alerts for one ticker from the options-flow feed (default 25). Call this when the user asks 'any unusual options activity in X?' or wants the large options bets hitting a specific name; use tengu_v3_intel_options_flow for the cross-market view.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_darkpool_recent

Most recent dark-pool prints across all tickers from the options-flow feed (default 50). Call this when the user asks about market-wide dark-pool or block activity — 'any big dark-pool prints today?'; use tengu_v3_intel_darkpool_ticker for a single name.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    }
  }
}

tengu_v3_intel_darkpool_ticker

Dark-pool prints for one ticker from the options-flow feed (default 50). Call this when the user asks whether large blocks are crossing off-exchange in a specific name; use tengu_v3_intel_off_exchange for daily aggregate off-exchange volume instead of individual prints.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_gex

Aggregate gamma exposure (GEX) and delta exposure for one ticker from the options-flow feed. Call this when the user asks about dealer positioning or gamma levels, or whether options exposure could dampen or amplify moves in a name; pair with tengu_v3_intel_max_pain for expiry pin levels.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_max_pain

Max-pain price per options expiration for one ticker from the options-flow feed. Call this when the user asks where a stock is likely to pin into expiry or what the max-pain level is; pair with tengu_v3_intel_gex for aggregate gamma/delta exposure.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_options_volume

Daily options volume and put/call ratio per day for one ticker from the options-flow feed (default 30 days). Call this when the user asks whether options activity or put/call skew is elevated versus recent days, or how bullish/bearish the options tape has been trending.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 30,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_factor_importance

What drives the model: Fama-French 5-factor loadings showing which systematic factors explain the strategy's returns, plus the ensemble's Bayesian voter posteriors ranking which signals it trusts most (top_n, default 50). PRIMARY tool for 'why does the model like this?' and 'what is the strategy actually betting on?' questions.

Parameters1

top_n

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "top_n": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_risk_portfolio_var

Consensus portfolio VaR + CVaR (USD) on the live top-decile shadow book — Cornish-Fisher + t-copula Monte-Carlo + filtered-historical-simulation blended, with a liquidity-adjusted VaR. Call this when the user asks how much the model portfolio could lose. Caveat: 1-day horizon only (horizon_days_served=1); multi-day is not scaled.

Parameters2

confidence	number	optional
horizon_days	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "confidence": {
      "type": "number",
      "default": 0.99,
      "minimum": 0.5,
      "maximum": 0.9999
    },
    "horizon_days": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 30
    }
  }
}

tengu_v3_research_correlation_mesh

Returns-correlation mesh around a seed ticker — nodes = tickers, edges = |rho| >= 0.6, from the 36-month realised-returns sidecar (depth expands the neighborhood). PRIMARY tool for 'what moves with X?' and finding hedge or pair candidates. Caveat: needs 36-month overlap; a freshly-listed or thinly-traded seed may be absent.

Parameters2

seed	string	required
depth	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "seed": {
      "type": "string"
    },
    "depth": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 3
    }
  },
  "required": [
    "seed"
  ]
}

tengu_v3_intel_insider_trades

SEC Form 4 insider trades for one ticker — recent buys and sells by officers, directors, and large holders (default 25). Call this when the user asks 'are insiders buying or selling X?' or wants to check insider conviction before acting on a name.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_congress

Congressional stock trades from two coverage sources — a realtime cross-ticker feed (provider=options_flow, default) or a bulk alternative-data feed (provider=alternative_data) — with an optional ticker filter. Call this when the user asks what Congress members have been buying or selling, market-wide or in a specific name.

Parameters3

ticker	string	optional
limit	integer	optional
provider	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "provider": {
      "type": "string",
      "enum": [
        "options_flow",
        "alternative_data"
      ],
      "default": "options_flow"
    }
  }
}

tengu_v3_intel_lobbying

Quarterly corporate lobbying spend for one ticker from the alternative-data feed (limit, default 50). Call this when the user asks how much a company spends lobbying or whether its policy exposure is growing; pair with tengu_v3_intel_gov_contracts for the government-contract side of the same story.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_gov_contracts

Federal government contracts awarded to one ticker's company from the alternative-data feed (limit, default 50). Call this when the user asks how much government business a company wins or whether contract awards are accelerating; pair with tengu_v3_intel_lobbying for the lobbying-spend side.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_wsb

Daily r/wallstreetbets mention count and sentiment for one ticker from the alternative-data feed (default 60 days). Call this when the user asks whether retail is piling into a name or how retail buzz is trending; pair with tengu_v3_intel_twitter for the Twitter-side social read.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_twitter

Daily Twitter mention volume and follower count for one ticker from the alternative-data feed (default 60 days). Call this when the user asks how much social buzz a name has or whether attention is spiking; pair with tengu_v3_intel_wsb for the r/wallstreetbets read.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_off_exchange

Daily off-exchange (dark pool + ATS) volume for one ticker from the alternative-data feed (default 30 days). Call this when the user asks how much of a stock's volume trades off-exchange or how dark-pool share is trending; use tengu_v3_intel_darkpool_ticker for individual prints.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 30,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_patents

Issued USPTO patents tagged to one ticker — date, title, IPC class, claim count, and abstract for each (default 25). Call this when the user asks what a company is patenting or wants an innovation-velocity read on its R&D pipeline.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_chart

Candlestick chart with optional RSI/MACD/Bollinger overlays — returns a base64 PNG in a standard image envelope plus an OHLCV summary block (interval minute|hour|day|week|month, default day; 120 bars). Call this when the user asks to see a chart; powers chart-emitting skills (TA Master, Trading Plan, Apex Equity Intel).

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
interval	string	optional
bars	integer	optional
indicators	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "interval": {
      "type": "string",
      "default": "day"
    },
    "bars": {
      "type": "integer",
      "default": 120,
      "minimum": 20,
      "maximum": 500
    },
    "indicators": {
      "type": "string",
      "default": "rsi,macd,bb"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_insiders

Live cross-ticker Form-4 insider-transaction feed (alternative-data, last ~20k rows): name, transaction_code, shares, price_per_share, value_usd, shares_owned_following. Call this when the user asks 'are insiders buying or selling?' — one name or market-wide. Optional ticker filter is applied client-side.

Parameters2

ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_intel_sec13f

Recent 13F position snapshots (alternative-data, cross-fund/cross-ticker, last ~10k rows): fund, ticker, shares, value_usd, report_period — the institutional-ownership signal. Call this when the user asks 'which funds hold X?' or 'what does fund Y own?'; filter by ticker and/or fund (substring match).

Parameters3

ticker	string	optional
fund	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "fund": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_intel_sec13f_changes

Quarter-over-quarter 13F position deltas (alternative-data), sign preserved: positive = added, negative = trimmed. Call this when the user asks 'are institutions adding or dumping X?'; set min_pct (absolute change fraction, e.g. 0.5 = 50%) to drop noise.

Parameters4

ticker	string	optional
fund	string	optional
min_pct	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "fund": {
      "type": "string"
    },
    "min_pct": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "maximum": 10
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_intel_top_shareholders

Top institutional / fund / insider shareholders for a ticker (alternative-data), as two lists — ownership (shares) and ownership_options (contracts) — because options exposure reads differently from equity holdings. Call this when the user asks 'who owns X?' or wants the largest holders.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_street_estimates

Street consensus EPS + options-implied expected move per earnings event, with beat_rate_pct and 8-quarter surprise history (est vs actual vs surprise_pct). Call this for 'what does the Street expect?' or 'how big a move is priced in?'. report_date_basis 'estimation' = projected date, NOT confirmed — cross-check tengu_v3_earnings_next.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_news_headlines

MARKET-WIDE ONLY — never for one ticker's news (that is tengu_v3_news_summary). Live cross-publisher newswire headlines: headline, publisher, tickers, is_major flag, feed-supplied sentiment; seconds-fresh, 120s cache. For 'what's happening in the market right now?' scans and cross-ticker sweeps.

Parameters2

ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    }
  }
}

tengu_v3_macro_treasury_curve

Live US Treasury yield curve (market-data feed, T+1): 1m-30y tenor points, per-tenor 1-day change (bps), computed 2s10s and 3m10y spreads with inversion flags. Call this when the user asks about rates, curve shape, or inversion. Honest as_of = the feed's record date.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_exec_compensation

Annual executive compensation history for a ticker (alternative-data): CEO + named officers with name, role, year, salary, bonus, stock_option_awards, total_compensation. Call this when the user asks 'how much is the CEO paid?' or wants pay-vs-performance context.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_etf_holdings

alternative-data: ETF composition or inverse-lookup. Pass ?etf=SPY for full holdings of an ETF, OR ?ticker=NVDA for every ETF that holds the stock (with weight). At least one is required; when both are passed, etf takes precedence.

Parameters3

etf	string	optional
ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "etf": {
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 1000
    }
  }
}

tengu_v3_intel_politicians

Full US Congress roster (House + Senate, alternative-data) with disclosed trade counts per member. Call it to resolve a politician name to a BioGuideID before pulling their trades, or for 'most-active disclosed traders in Congress' lists. Heavy full-roster pull.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 1000
    }
  }
}

tengu_v3_intel_corporate_donors

Corporate-PAC donations linked to the ticker's parent company (alternative-data): candidate, committee, amount, transaction_date, cycle — a campaign-finance influence signal. Call this when the user asks who a company donates to or about its political exposure.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_gov_contracts_live

Quarterly cross-ticker federal-contracts feed (alternative-data) — top-line award totals only, lighter than per-ticker tengu_v3_intel_gov_contracts (no agency or description fields). Call this for 'which companies win government money?' screens; use tengu_v3_intel_gov_contracts for line-items.

Parameters2

ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_intel_news_pro

Real-time newswire stories — cross-ticker, ticker-filtered (comma-separated), or by channel: id, title, teaser, url, ticker(s), channels, tags, created (ISO-8601); body=true adds full HTML (slower, larger). Call this when the user wants themed or full-text news beyond headlines. Confirmed-working channels (probed 2026-04-30; exact case + apostrophe matter): "Press Releases", "Crypto", "Movers", "Why It's Moving", "Earnings", "Earnings Beats", "Earnings Misses", "Guidance", "Top Stories", "Tech", "Markets", "Analyst Color", "Federal Reserve", "Government", "ETFs", "Forex", "Commodities", "Treasuries", "Futures", "Emerging Markets", "Eurozone", "Asia", "Global", "Equities", "Bonds", "Trading Ideas", "After-Hours Center".

Parameters4

tickers	string	optional
channels	string	optional
limit	integer	optional
body	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "channels": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "body": {
      "type": "boolean",
      "default": false
    }
  }
}

tengu_v3_intel_news_why_moving

MOVER-EXPLANATION ONLY — for 'why is X moving / what's driving X right now?' questions; never for generic 'latest news on X' (that is tengu_v3_news_summary). Newswire 'Why It's Moving' channel: short explainers for stocks making notable intraday moves. 60s cache.

Parameters3

tickers	string	optional
limit	integer	optional
body	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "body": {
      "type": "boolean",
      "default": false
    }
  }
}

tengu_v3_intel_news_press_releases

newswire 'Press Releases' channel — corporate press releases on the newswire (PR Newswire, Business Wire, GlobeNewswire). Use when the user asks for the company's own announcements rather than analyst/journalist coverage. 60s cache.

Parameters3

tickers	string	optional
limit	integer	optional
body	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "body": {
      "type": "boolean",
      "default": false
    }
  }
}

tengu_v3_intel_news_crypto

Newswire 'Crypto' channel — crypto news stream covering BTC, ETH, exchanges, regulation, miners. Call this when the user asks about crypto news; pair with coin-stock proxies (COIN, MSTR, RIOT, MARA) to fuse the equity-side reaction. 60s cache.

Parameters3

tickers	string	optional
limit	integer	optional
body	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "body": {
      "type": "boolean",
      "default": false
    }
  }
}

tengu_v3_intel_news_movers

Newswire 'Movers' channel — coverage of stocks making the biggest intraday moves (gainers, losers, halts, breakouts). Call this for 'biggest movers today' questions and end-of-day 'what moved' recaps; pass tickers to narrow. 60s cache.

Parameters3

tickers	string	optional
limit	integer	optional
body	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "body": {
      "type": "boolean",
      "default": false
    }
  }
}

tengu_v3_intel_earnings_history

Last N quarters of earnings for a ticker — report date, EPS estimate vs actual, surprise %, and the day-of-report intraday price move %. Used by the verdict prompt to anchor 'stock typically moves ±X% on earnings' claims in real numbers. Composite (newswire + market-data). 6h cache.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
lookback_quarters	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "lookback_quarters": {
      "type": "integer",
      "default": 4,
      "minimum": 1,
      "maximum": 12
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_earnings_next

Use when: the user asks for a specific ticker's next earnings date, when a company reports, the earnings calendar entry for a name, or anything of the form "when is X's next earnings?". This is the CANONICAL multi-source consensus tool — fans out to market-data, market-data, newswire, news, and web search in parallel; reconciles via primacy-weighted majority; returns a single canonical answer with per-source breakdown, deduplicated citations, and a ``vendor_coverage_alert`` when paid vendors silently lack data the web confirms. ``_meta.confidence`` is `high` (≥2 sources agree, or 1 primary source = market-data|web_search), `medium` (1 secondary source), or `low` (no confirmed date — projections demoted to ``_meta.next_earnings_date_projection_only``). Top-level ``summary`` field for FE rendering. 15-min cache.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_earnings_next_stream

STREAMING variant of ``tengu_v3_earnings_next`` — same consensus contract, delivered as Server-Sent Events (text/event-stream). Emits two events: ``partial`` when paid vendors reach consensus (~500ms first paint with `is_projected=false`, confidence=high based on paid alone) and ``result`` when web_search has verified (~2-3s; updates `vendor_coverage_alert` if web disagrees). Use when a consumer can render incrementally and wants the fastest possible first paint — chat surfaces and live tickers. Synchronous consumers should keep using ``tengu_v3_earnings_next`` (cost-aware: skips the web_search call entirely when paid agrees).

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_macro_snapshot

NOW WITH a `credit` block: CDX IG/HY on-the-run 5Y composite spreads + 1-session delta (T-2 by source, cadence-aware staleness; full series at /api/v3/credit/indices). Cross-asset macro composite returning REAL underlying values, all real-time where the data source permits. Fields: `vix` (real-time spot), `ten_year_yield_pct` (FRED DGS10, %), `usd_index_narrow_dxy` (computed from FRED 6-pair basket via the standard geometric weighted formula — the institutional standard ~99), `usd_index_trade_weighted_broad` (FRED DTWEXBGS — Fed's broader policy measure ~118), `wti_oil_usd_bbl` (FRED DCOILWTICO, $/bbl), `gold_usd_oz` (real-time forex spot, $/oz), `sp500` (real-time index; SPY×10 emergency fallback), `nasdaq100` (real-time index; QQQ×41 emergency fallback), `djia` (real-time index; null when unavailable — no ETF proxy emitted), `russell2000` (real-time index; IWM×10 emergency fallback). Every numeric field is gated by a plausibility guard — out-of-band values are nulled with an `error.implausible_value` field rather than served, so the chat Brain never cites a wrong number with the [macro_snapshot] tag. Includes `vol_regime` (low_vol/normal/elevated/stress per VIX bucket), `data_freshness` timestamp, and a `sources` block with the series reference for each indicator. 60s cache.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_ml_prediction

Latest ensemble ML prediction for the ticker, with full conformal interval + 19-voter decomposition. Sourced from the nightly ensemble scoring run (refreshed nightly Mon-Fri, ~13K tickers scored per cycle). Returns `prediction` block (predicted_return_pct, blended_score, conviction, decile, rank, percentile_rank, n_universe), `conformal_interval` block (lo/hi/half_width/method + stated_coverage 0.90 + realised_coverage_recent from live calibration table), `voter_decomposition` (per-voter contribution across the 19 voters — e.g. ml_ensemble, regime_hmm, technical_advanced, sentiment_finbert, macro_context, fundamental, options_flow, insider_flow, analyst_revisions, futures_macro, congress_trading, short_pressure), `context` (voter_coverage, confluence, feature_coverage), plus model_version, tier (small/mid/large universe), regime, sector. When a ticker isn't in the latest scoring universe, returns `available: false` with reason. 5min cache. NAMESPACE: predictions are US-EQUITY only. Nine crypto tickers collide with equities (BTC, ETH, LINK, LTC, COMP, ARB, NEAR, APT, ATOM) — such responses carry a `ticker_collision` note; for the crypto asset pass asset_class=crypto (fails closed 404: no crypto model yet). NEVER present an equity prediction as a crypto view.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
asset_class	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "asset_class": {
      "type": "string",
      "enum": [
        "equity",
        "crypto"
      ],
      "default": "equity"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_voter_attribution

Causal attribution for a voter's score on a ticker. Instrumented voters: `insider_flow` (EDGAR Form-4 + insider feed, deduped by name/date/value; CEO/CFO 2x, officer 1.5x, director 1.2x weighting; contribution amounts + reconstructed score); `options_flow` (options-flow alerts with direction inferred from option_type+side: CALL@ASK=+1, PUT@ASK=-1, CALL@BID=-1, PUT@BID=+1; weighted by premium/median); `fundamental` (metadata mode — surfaces which 4 ratios the voter consumes + how to interpret). Transforms scores into EVIDENCE rather than a number. Remaining voters (sentiment, analyst_revisions, regime_hmm, technical, ml_ensemble) pending instrumentation. Optional ?voter=insider_flow|options_flow|fundamental, ?days_back=30. 15min cache.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
voter	string	optional
days_back	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "voter": {
      "type": "string"
    },
    "days_back": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_voter_ic_drift

Per-voter information-coefficient drift vs baseline for all 19 voters, recomputed daily: live_ic vs baseline_ic, ic_ratio (sign-flip flagged at <0), drift_status (green/yellow/red), sorted by absolute drift severity. Call it before leaning on a verdict — reduce confidence in any voter with red drift_status. 60min cache.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_voter_coverage

Per-ticker accounting for every voter in the 19-voter ensemble. For each voter returns the current score, baseline weight, status (firing | silent_data | shadow | no_signal), and a human-readable `why` explaining each silent voter's upstream data source so an operator can chase the gap. The `coverage_summary` block reports `weight_firing` (effective ensemble weight in use) vs `weight_silent_live` (paid-for but silent). Use this when a model_prediction shows low voter_coverage — it tells you exactly which data pipelines to wake up. 5min cache.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_ml_drivers

Top-N SHAP feature attributions for the ML ensemble score on a ticker: drivers[] ranked by |SHAP| with feature (e.g. beta_cma, vol_21d), signed shap_value, direction (bullish/bearish/neutral). PRIMARY tool for 'why is the model bullish/bearish on X?'. Nightly run; default top=5, max 20; available:false outside the ML universe. 5min cache.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
top	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "top": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_model_calibration

Live conformal-coverage telemetry: how often the model's stated 90% intervals actually contain the realised 5d returns. Built nightly over the trailing 30 days of prediction-outcome pairs. Returns `stated_coverage` (target, typically 0.90), `realised_coverage` (actual, e.g. 0.78), `coverage_delta` (gap, negative = under-covering), `status` (red/amber/green), `n_pairs` (sample size, ~110K typical), `mean_interval_width_pct`, `mean_predicted_return_pct`, `mean_realised_return_pct`, and an `interpretation` string. Treat status=red as a verdict-grade caveat — chat should attach 'model intervals currently under-covering' to any ml_prediction citation when this returns red. 1h cache.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_pnl_attribution

Daily PnL track record for the paper book, Carhart 4-factor-decomposed. Snapshotted nightly. Returns `rows[]` of trading days with per-row gross/net return in basis points, transaction cost, turnover, plus the Carhart factor contributions (MKT-RF, SMB, HML, UMD) and residual alpha — the institutional skill measure that strips market/size/value/momentum beta. Window aggregate: mean daily bps, hit rate, annualised Sharpe, cumulative net + alpha. Default 30 trading days; query `?days=N` (bounded to 365). Use this to ground any track-record claim the chat makes — e.g. 'our paper book made +29 bps yesterday, +111 bps alpha contribution'. 1h cache.

Parameters1

days

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "string"
    }
  }
}

tengu_v3_intel_cftc_cot

CFTC Commitments-of-Traders report — futures positioning by cohort (producers/hedgers, money managers, other reportables, non-reportables). Polled weekly on Fridays at 18:00 ET, the CFTC's standard publication window. Without filter: returns top-10 money-manager longs and shorts across all contracts on the latest report — the institutional-spec directional bets. With `?contract=GOLD` (substring match, also accepts WTI, NATGAS, SP500-EMINI, BITCOIN-MICRO, 10Y-NOTE, etc.) returns the matched contract's 5-week positioning history with cohort net positions, % of OI, and a 4-week net delta. Extreme money-manager longs at the top of a rally historically mark exhaustion; commercial-hedger net longs at the bottom historically mark reaccumulation — leading indicator. 4h cache (CFTC publishes weekly so the data is stale-by-design).

Parameters1

contract

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "contract": {
      "type": "string"
    }
  }
}

tengu_v3_intel_short_interest

FINRA bi-monthly short interest: short_interest_shares, short_interest_pct_of_float, days_to_cover, short_interest_change_pct_30d (vs prior settlement), avg_daily_volume_at_settlement. Call for 'how shorted is X?' / squeeze questions. borrow_fee_pct_annualized is null — see /intel/borrow_cost. Market-data FINRA re-publish; 6h cache.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_analyst_consensus

Analyst consensus: rating_label (Strong Buy…Strong Sell), rating_score (1-5), bucket counts, price_target_avg/high/low/count, recent_actions[] (upgrades/downgrades/PT changes, firm+analyst+from→to; recent_action_limit). Call for 'what do analysts say about X?' / price targets. Actions from newswire (client-side ticker filter). 1h cache.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
recent_action_limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "recent_action_limit": {
      "type": "integer",
      "default": 10,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_borrow_cost

Securities-lending borrow cost (annualized fee %, rebate, utilization, shares available) — LIVE. Source chain, first hit wins (see `source`): 1) options-flow shorts feed (intraday) + recent SEC fails-to-deliver enrichment; 2) licensed-research securities-finance Securities Finance latest archived daily row; 3) implied-vol option-implied borrow. `is_stale` flags prints older than 48h (warehouse rows trail on the licensed-research refresh lag). data_source_pending=true ONLY when all three sources miss — then fall back to /intel/short_interest as the squeeze proxy. Use /intel/borrow_cost_history for the daily series. 15-min cache.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_sec_filing_extract

Structured extracts from the latest 10-K/10-Q/8-K via the SEC EDGAR JSON API: balance_sheet_summary, cash_flow_summary, shares_outstanding (basic+diluted+4Q trend), filing_date, filing_url, accession_number. Call for numbers straight from the latest filing. MVP: text_sections are deep-links only — use web_search on filing_url. 24h cache.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
filing_type	string	required	Path parameter 'filing_type' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "filing_type": {
      "type": "string",
      "description": "Path parameter 'filing_type' (required)."
    }
  },
  "required": [
    "ticker",
    "filing_type"
  ]
}

tengu_v3_intel_calendar_economics

Macro economic-release calendar from the newswire — CPI, NFP, FOMC, GDP, retail sales and more, filterable by ISO-3 country (USA, CAN, DEU) and date range; importance 5 = market-moving. Call this when the user asks what macro events or data releases are coming up or could move markets this week.

Parameters5

country	string	optional
date_from	string	optional
date_to	string	optional
importance	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "date_to": {
      "type": "string"
    },
    "importance": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    }
  }
}

tengu_v3_intel_calendar_ratings

Analyst rating actions and price-target changes from the newswire: analyst_firm, analyst_name, action_company (Maintains/Initiates), action_pt (Raises/Lowers), pt_current, pt_prior, pt_pct_change, rating_current/prior. Call this when the user asks about upgrades, downgrades, or price-target moves on a ticker.

Parameters5

tickers	string	optional
date_from	string	optional
date_to	string	optional
action	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "date_to": {
      "type": "string"
    },
    "action": {
      "type": "string",
      "enum": [
        "Raises",
        "Lowers",
        "Maintains",
        "Announces",
        "Initiates",
        "Reiterates"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    }
  }
}

tengu_v3_intel_calendar_conference_calls

newswire: upcoming earnings conference-call schedule. Returns ticker, company, date, start_time, period (Q1/Q2/...), webcast_url, phone_num, international_num, access_code, and importance (5 = mega-cap market-mover). Distinct from /calendar/earnings — this carries the call logistics analysts need to attend.

Parameters5

tickers	string	optional
date_from	string	optional
date_to	string	optional
importance	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "date_to": {
      "type": "string"
    },
    "importance": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    }
  }
}

tengu_v3_intel_commodities

REAL-TIME spot prices for the macro commodities (oil WTI/Brent, gold, silver, nat-gas, copper). AUTHORITATIVE source for any numeric commodity claim — call this BEFORE quoting a price level. QUOTE 'spot' DIRECTLY — it's the live commodity price (FRED's last published close anchored to the live commodity-tracking ETF's cumulative return since that date, so it reflects today's market not FRED's T+1..T+5 publish lag). 'unit' tells you the dimension (USD/barrel for oil, USD/MMBtu for natgas, USD/metric-ton for copper). Response fields per item: 'spot' (live number — quote this), 'unit' (dimension), 'spot_basis' ('live_etf_bridged' = FRED+ETF bridge | 'fred_close' = FRED only, no ETF available | 'etf_share_price' = FRED dead, falling back to ETF SHARE price [unit reads 'USD per share of {ETF}'] — DO NOT claim $/oz when basis is etf_share_price), 'spot_time' (timestamp of the live observation), 'live_spot_estimate' (same as spot when bridged, else null), 'live_basis' (transparent arithmetic, e.g. 'FRED WTI $99.89 (2026-04-27) × (USO 142.80 / 134.72)'), 'bridge_return_pct' (ETF return applied to FRED), 'official_close' + 'official_close_as_of' (FRED audit value — quote ONLY if user explicitly asks for the last settlement / closing price), 'change_pct_1d/5d/30d' (FRED-window returns), 'history_5d' (last 6 FRED observations newest-first), 'fred_days_stale' + 'is_stale' (publish-lag flags — informational; spot is still live regardless), 'etf_proxy_quote' (the underlying ETF snapshot used for the bridge; for transparency only). 'symbol=oil' returns both WTI and Brent; default 'all' returns all six.

Parameters1

symbol

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "enum": [
        "all",
        "oil",
        "wti_oil",
        "brent_oil",
        "gold",
        "silver",
        "natgas",
        "copper"
      ],
      "default": "all"
    }
  }
}

tengu_v3_news_crypto_latest

Recent crypto news with sentiment for one or more symbols: title, source, sentiment (Positive/Neutral/Negative), date, topic tags. PRIMARY tool for ticker-specific crypto drilling (BTC, ETH, SOL, COIN, MSTR) — call when the user asks what's happening with a specific coin; use by_category for market-wide questions. 60s cache.

Parameters3

tickers	string	required
items	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last7days",
        "last30days"
      ],
      "default": "today"
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_news_crypto_by_category

Crypto news by section: section='general' for overall crypto-market headlines, section='alltickers' for cross-coin coverage. PRIMARY tool for broad 'what's happening in crypto today' questions — for a single coin use news_crypto_latest instead. 120s cache.

Parameters3

section	string	optional
items	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "general",
        "alltickers"
      ],
      "default": "general"
    },
    "items": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string",
      "default": "today"
    }
  }
}

tengu_v3_news_crypto_sentiment_stats

crypto-news: daily sentiment rollup for a crypto symbol (-1.5 to +1.5). Densest single-call signal — N days of (positive_count, negative_count, neutral_count, sentiment_score). Use to detect sentiment regime shifts on BTC/ETH/etc. 300s cache.

Parameters2

ticker	string	required
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "enum": [
        "last7days",
        "last30days",
        "last60days"
      ],
      "default": "last30days"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_crypto_market_sentiment

Overall crypto market sentiment rollup across the news feed (no ticker filter). Call this when the user asks whether crypto as a whole looks bullish or bearish right now — for a specific coin's sentiment use news_crypto_latest. 300s cache.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  }
}

tengu_v3_news_crypto_trending

Trending crypto headlines, noise-filtered down to top stories only. Pass ticker to filter to one coin; omit for market-wide trending. Call this when the user asks what the biggest crypto stories are right now. 120s cache.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_news_crypto_ticker_only

Crypto news mentioning ONLY the requested coin, with no co-tagged altcoins — the strictest per-coin filter. Call this when the user wants pure single-coin coverage and news_crypto_latest brings back too much cross-coin noise.

Parameters3

ticker	string	required
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_crypto_multi_ticker

Crypto news where ALL the listed coins co-appear in the same story — a correlation feed. Call this when the user asks how two or more coins are linked in the news, e.g. stories covering both BTC and ETH together.

Parameters3

tickers	string	required
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "tickers"
  ]
}

tengu_v3_news_crypto_all_tickers_sentiment

Sentiment leaderboard across the full tracked crypto universe — every coin's sentiment_score over the window (default last7days). Call this when the user asks which coins have the most bullish or most bearish news sentiment right now.

Parameters2

date_range	string	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_v3_news_crypto_top_mentions

Top 50 most-mentioned crypto tickers over the window (default last7days) — a crypto-attention proxy. Call this when the user asks which coins are getting the most buzz or news coverage lately.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  }
}

tengu_v3_news_crypto_events

Clustered crypto headline events — related stories grouped into discrete events; fetch recent events, filter by ticker, or drill into one eventid. Call this when the user asks what distinct news events hit a coin rather than a raw headline list.

Parameters3

tickers	string	optional
eventid	string	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "eventid": {
      "type": "string"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_v3_news_crypto_sundown

Evening crypto market-recap digest, published Mon-Fri at 7pm ET. Call this when the user asks for an end-of-day crypto wrap-up or a morning briefing needs an overnight crypto recap.

Parameters1

page

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 10
    }
  }
}

tengu_v3_news_crypto_ticker_price

Delayed crypto prices with 24h volume and price changes — a single coin, a list, or the top 50 by 24h volume when tickers is omitted. Call this when the user asks where a coin is trading or which coins are moving; prices are delayed, not real-time.

Parameters1

tickers

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    }
  }
}

tengu_v3_news_crypto_whale_transactions

Large crypto on-chain and exchange transactions for BTC/ETH/SOL/TRX plus major exchanges, filterable by min_amount USD (updated ~every 5min). Call this when the user asks about whale moves or big transfers; use whale_summary for the aggregated buy-vs-sell read.

Parameters5

tickers	string	optional
date_range	string	optional
min_amount	integer	optional
items	integer	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "default": "last24hours"
    },
    "min_amount": {
      "type": "integer",
      "minimum": 0
    },
    "items": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_v3_news_crypto_whale_summary

Aggregated whale-transaction stats over the window: total volume, net exchange flow (in vs out), and biggest single tx. PRIMARY tool for 'is smart money buying or selling this coin?' — use whale_transactions for the individual transfers.

Parameters2

tickers	string	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  }
}

tengu_v3_news_crypto_summary

crypto-news: one-shot per-coin intel summary. Parallel-fetches recent news (24h) + 7-day sentiment stats + trending headlines. The single call to make when asked 'what's going on with BTC?' or any crypto-name analysis. 90s cache.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_forex_latest

Recent FX news with sentiment for one or more currency pairs: title, source, sentiment (Positive/Neutral/Negative), date, topic tags. PRIMARY tool for pair-specific drilling (EUR-USD, GBP-USD, USD-JPY, AUD-USD) — call when the user asks what's moving a specific pair; use by_category for macro themes. 180s cache.

Parameters3

pairs	string	required
items	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "pairs": {
      "type": "string"
    },
    "items": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last7days",
        "last30days"
      ],
      "default": "today"
    }
  },
  "required": [
    "pairs"
  ]
}

tengu_v3_news_forex_by_category

Macro and cross-pair FX news: section='general' = market macro (Fed, CPI, ECB, NFP, BoJ, BoE), section='alltickers' = cross-pair coverage; optional topic filter (cpi, fed, oil, gold, recession...) on general. Call this when the user asks about macro FX themes rather than one pair — use news_forex_latest for pair drilling. 300s cache.

Parameters4

section	string	optional
topic	string	optional
items	integer	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "enum": [
        "general",
        "alltickers"
      ],
      "default": "general"
    },
    "topic": {
      "type": "string",
      "enum": [
        "cpi",
        "unemployment",
        "fed",
        "ecb",
        "boj",
        "boe",
        "gdp",
        "inflation",
        "war",
        "election",
        "oil",
        "gold",
        "recession",
        "tradedeals"
      ]
    },
    "items": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    },
    "date_range": {
      "type": "string",
      "default": "today"
    }
  }
}

tengu_v3_news_forex_sentiment_stats

fx-news: daily sentiment rollup for an FX pair (-1.5 to +1.5). Densest single-call signal — N days of (positive_count, negative_count, neutral_count, sentiment_score). Use to detect regime shifts on EUR-USD/GBP-USD/etc. 600s cache.

Parameters2

pair	string	required
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "enum": [
        "last7days",
        "last30days",
        "last60days"
      ],
      "default": "last30days"
    }
  },
  "required": [
    "pair"
  ]
}

tengu_v3_news_forex_market_sentiment

Overall FX market sentiment rollup (no pair filter) — gauges DXY-style market posture rather than any single pair. Call this when the user asks about broad FX market mood; use news_forex_latest for a specific pair's sentiment. 600s cache.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "default": "last7days"
    }
  }
}

tengu_v3_news_forex_top_mentions

fx-news: most-mentioned FX pairs over a window with sentiment tilt. High-leverage 'what is the FX market talking about?' single call. 300s cache.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string",
      "enum": [
        "today",
        "last7days",
        "last30days"
      ],
      "default": "last7days"
    }
  }
}

tengu_v3_news_forex_trending

Trending FX headlines, noise-filtered down to top stories only. Pass pair (e.g. EUR-USD) to filter; omit for market-wide trending. Call this when the user asks what the biggest FX stories are right now. 300s cache.

Parameters1

pair

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string"
    }
  }
}

tengu_v3_news_forex_sundown_digest

Daily evening FX market summary article. Call this when the user asks for an end-of-day FX wrap-up or a morning briefing needs an overnight FX recap; optional date_range filter (today/last7days). 600s cache.

Parameters1

date_range

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "date_range": {
      "type": "string"
    }
  }
}

tengu_v3_news_forex_events

Clustered FX news events from a forex newswire — high press-coverage stories like central-bank decisions, rate hikes, and intervention rumors, optionally filtered to one pair (e.g. EUR-USD). Call this when the user asks 'what major macro events hit today' or what's moving a currency. 300s cache.

Parameters3

pair	string	optional
date_range	string	optional
items	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string"
    },
    "date_range": {
      "type": "string",
      "default": "today"
    },
    "items": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    }
  }
}

tengu_v3_news_forex_economic_calendar

Economic calendar with actual, forecast, and previous values for macro releases (Fed/CPI/NFP/ECB) — these prints are priced-in by FX traders, so call it for any 'what did CPI print / what macro data hit this week' question. Filter by currency (USD/EUR/JPY) and importance (high/medium/low). 600s cache.

Parameters3

currency	string	optional
importance	string	optional
date_range	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string"
    },
    "importance": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ]
    },
    "date_range": {
      "type": "string",
      "enum": [
        "today",
        "last7days",
        "last30days"
      ],
      "default": "last7days"
    }
  }
}

tengu_v3_news_forex_prices

Live FX mid prices (15-min upstream refresh): pass pairs for specific quotes (e.g. EUR-USD,GBP-USD) or base for all pairs vs one currency (base=USD). Call this when the user asks where a currency pair is trading right now. 30s cache.

Parameters2

pairs	string	optional
base	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "pairs": {
      "type": "string"
    },
    "base": {
      "type": "string"
    }
  }
}

tengu_v3_news_forex_summary

fx-news: one-shot per-pair intel summary. Parallel-fetches recent news (24h) + 7-day sentiment stats + trending headlines. The single call to make when asked 'what's going on with EUR-USD?' or any FX-pair analysis. 180s cache.

Parameters1

pair

string

required

Path parameter 'pair' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "type": "string",
      "description": "Path parameter 'pair' (required)."
    }
  },
  "required": [
    "pair"
  ]
}

tengu_v3_research_web_search

Multi-mode web search in parallel across link, cited-synthesis and social-sentiment coverage. Returns synthesized_answer, social_sentiment, citations, and a deduplicated list of links. Call this BEFORE relying on model knowledge for time-sensitive questions (markets, earnings, regulation, breaking news, macro events). 15-min LRU cache.

Parameters4

query	string	required
providers	string	optional
freshness	string	optional
count	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "providers": {
      "type": "string",
      "default": "links,synthesis"
    },
    "freshness": {
      "type": "string",
      "enum": [
        "pd",
        "pw",
        "pm"
      ]
    },
    "count": {
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ]
}

tengu_v3_research_fetch_url

Read ONE specific page you already have the URL for — call ONLY after a search returned the link, never to discover pages. Returns the page's readable body as clean markdown with title, author, published date, and a domain trust tier; handles paywalls. Read at most the 2-3 most load-bearing links per question. NOT a search tool: tengu_v3_research_web_search finds the links this tool reads.

Parameters2

url	string	required
max_chars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "max_chars": {
      "type": "integer",
      "default": 8000,
      "minimum": 500,
      "maximum": 10000
    }
  },
  "required": [
    "url"
  ]
}

tengu_v3_research_synthesis

Citation-rich research synthesis (grounded LLM). Returns a concise synthesized answer plus the list of source URLs that grounded it. Use when the user wants the answer GROUNDED with explicit sources (e.g. 'summarize NVIDIA's last earnings call and link the transcript'). Distinct from web_search — this returns prose + citations, not a list of headlines.

Parameters2

query	string	required
system_prompt	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "system_prompt": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

tengu_v3_research_x_sentiment

Real-time X/Twitter sentiment narrative. Pass ticker=NVDA for a focused fintwit read on a name, or query=... for a free-form social-media question. Returns the narrative answer with quantified bullish/bearish ratio and any source URLs social-search grounded against. Use when you want the *vibe* on a name right now (retail sentiment, breaking rumours, unusual social activity), not the news article list.

Parameters2

ticker	string	optional
query	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    },
    "query": {
      "type": "string"
    }
  }
}

tengu_v3_intel_yield_curve

Live US Treasury yield curve + recession-watch spreads + breakeven inflation. Returns DGS1MO/3MO/2/5/10/30 yields, the 10Y-2Y and 10Y-3M spreads (with 'inverted' flags — classic recession signal), 5Y/10Y breakeven inflation, and the trade-weighted USD index. Quote these numbers verbatim — DO NOT recall yields from training data, which is months stale. 5-min cache. For a focused short-end + cash-park view, use tengu_v3_intel_risk_free_rate.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_risk_free_rate

Current US T-bill yields + parked-cash quick-reference. Use this for capital-allocation responses — the model needs to compare risky vs risk-free expected return ('T-bills currently yield X% — the equity allocation must clear that hurdle'). Returns 1m/3m/2y/10y yields, `parked_yield_example` showing annual coupon on $10k principal across tenors, and curated T-bill ETF references (SGOV, BIL, SHV) with expense ratios + use-case so the model has something specific to cite. Sourced from FRED. 5-min cache.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_intel_options_chain

Options-chain snapshot for a ticker: every contract with Greeks (delta/gamma/theta/vega), implied volatility, open interest, last quote/trade; filter by expiry or call/put side. PRIMARY tool for 'where's the gamma / IV smile / max pain by strike'. Pair with options_volume (flow) and gex (dealer positioning). 60s cache.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
expiration_date	string	optional
contract_type	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "expiration_date": {
      "type": "string"
    },
    "contract_type": {
      "type": "string",
      "enum": [
        "call",
        "put"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 250,
      "minimum": 1,
      "maximum": 250
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_etf_summary

One-call ETF intelligence rollup — top holdings + commodity exposure + which other v3 tools work for this ticker. Returns top constituents by weight (holdings provider), and for commodity-tracking ETFs (USO/BNO/GLD/IAU/SGOL/SLV/SIVR/UNG/BOIL/CPER) the linked FRED spot + live proxy price. CALL THIS BEFORE saying 'no data' on any ETF question — most ETFs have rich underlying-level intel even when the wrapper itself doesn't trade analyst targets / insider flow.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_skills_ta_master

One-call technical read on a ticker: fuses candlestick chart (RSI/MACD/BB), GEX, max pain, options flow/volume, insider and congressional trades, and off-exchange volume into a signal list, aggregate bull/bear stance, and embedded PNG chart. Call this FIRST for 'how does the chart/setup look?' — one round-trip replaces ~8 calls.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
interval	string	optional
bars	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "interval": {
      "type": "string",
      "default": "day"
    },
    "bars": {
      "type": "integer",
      "default": 120,
      "minimum": 40,
      "maximum": 400
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_skills_apex_equity

Apex Equity Intelligence — single-call omnibus brief for 'what do you think about $TICKER'. Fuses 12 vendor calls in parallel (daily + hourly charts, company facts, income/balance statements, snapshot, insider, congress, lobbying, gov-contracts, WSB, patents, off-exchange). Returns: 'fundamentals' (12 scalar fields — name, sector, market_cap, last_price, day_change_pct, latest_revenue, latest_net_income, latest_eps, total_assets/liabilities/equity, filing_date), 'intel' (8 scalar fields — insider/congress 30d buy-sell counts, ttm_lobbying_usd, ttm_gov_contract_usd, wsb_7d_mentions+sentiment, patent_filings_recent, avg_dark_pool_pct_30d), 'flags' (notable patterns: insider_cluster_buy/sell, elevated_dark_pool, retail_attention_spike, etc.), 'chart' (primary daily 120-bar candlestick PNG with RSI/MACD/BB indicators, palette-quantized to keep the tool result under 32KB), and 'charts' (a list of ADDITIONAL charts beyond the primary — currently just the hourly intraday chart; do NOT expect the daily here, it's only in 'chart'). 'components' carries raw counts of items behind each digest. 'vendor_errors' is non-empty when one of the parallel fetches failed; the rest of the payload is still usable. For full per-section detail (complete insider trade list, full income statements, etc.) call the dedicated tools tengu_v3_fundamentals_*/tengu_v3_intel_* — apex_equity is the digest, not the firehose.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_skills_trading_plan

Actionable long/short plan for a ticker: entry, stop (recent swing or 1.5x-ATR proxy), 1R/2R/3R targets, position size for a given risk_pct, plus a thesis citing supporting signals (trend, flow tilt, insider, congress) and an embedded PNG chart. Call this when the user asks 'how would I trade X'; bias=auto picks direction from TA stance.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
bias	string	optional
risk_pct	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "bias": {
      "type": "string",
      "default": "auto"
    },
    "risk_pct": {
      "type": "number",
      "default": 1,
      "minimum": 0.1,
      "maximum": 5
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_framework_list

Lightweight catalogue of all registered frameworks — one row per framework with framework_id + intent + 1-line applies_when + version. Useful for discovery / debugging without parsing the full library. For the actual decision template, call tengu_v3_framework_lookup.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_briefing_daily

Daily briefing for a given user_id: regime, overnight futures, earnings_today, macro_today, watchlist_signals, news_highlights, risk_exposure, top_movers. ALWAYS returns a briefing — served from a precomputed cache (~5ms) when available, else built on demand (~3s, no LLM calls). The response carries '_source': 'precomputed' or 'computed:request_time' so callers can tell which path served them. Pass precompute_only=true ONLY when you specifically need to know whether the cron has already run (e.g. monitoring scripts) — that path returns 404 instead of building.

Parameters4

user_id	string	required
date	string	optional
fallback_build	boolean	optional
precompute_only	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "fallback_build": {
      "type": "boolean",
      "default": true
    },
    "precompute_only": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "user_id"
  ]
}

tengu_v3_briefing_status

Presence check for today's briefing payload for a user/date. Call when the user asks whether the daily briefing was generated or why it looks missing.

Parameters2

user_id	string	required
date	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string"
    },
    "date": {
      "type": "string"
    }
  },
  "required": [
    "user_id"
  ]
}

tengu_ml_health

ML pipeline freshness probe: has_predictions, has_weights_history, latest_as_of_ts, n_tickers. Call when the user asks whether the ML pipeline is healthy or why predictions look missing/stale.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_ml_predict

Latest ML ensemble prediction for one ticker: blended_score, conviction, decile rank, and per-voter sub-scores. Call this when the user asks 'what does the model think of X' or wants a quantitative score to weigh against fundamentals.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_ml_top_picks

Top-N ranked tickers from the latest ML ensemble scoring snapshot, optionally floored by min_conviction. PRIMARY tool for 'what are the model's top picks / best-ranked stocks right now'; use tengu_ml_predict for one ticker's detail.

Parameters2

limit	integer	optional
min_conviction	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20
    },
    "min_conviction": {
      "type": "number",
      "default": 0
    }
  }
}

tengu_ml_weights

Current live ML ensemble voter weights (latest history row, broken out per market regime). Call it to know how the ensemble is blending its voters before interpreting a prediction; use tengu_ml_weights_history for drift over time.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_ml_weights_history

Time series of ML ensemble voter weights (per regime, newest first; days=1-365, default 30). Call this when the user asks how the model's weighting has drifted or shifted across regimes; use tengu_ml_weights for the current row.

Parameters1

days

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "default": 30
    }
  }
}

tengu_v3_private_markets_search

Search PRIVATE companies / investors (VC/PE) / funds / people / limited partners by name (prefix, case-insensitive), ticker, or CIK — relevance-ranked so the prominent entity is #1 (brand/AKA/former-name aware: 'Nubank'→Nu Holdings, 'Square'→Block). Use this FIRST for any private-company question (e.g. 'tell me about Stripe', 'who is Sequoia') to resolve the entity id, then call the company/dossier/realtime tools. type=all searches every entity kind. detail=full returns every column per hit (for rich tables).

Parameters5

q	string	optional
type	string	optional
limit	integer	optional
detail	string	optional
fields	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "company",
        "investor",
        "fund",
        "person",
        "lp",
        "serviceprovider",
        "all"
      ],
      "default": "company"
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "minimum": 1,
      "maximum": 50
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ],
      "default": "lean"
    },
    "fields": {
      "type": "string"
    }
  }
}

tengu_v3_private_markets_search_suggest

INSTANT (sub-100ms) private-company typeahead — prominence-ranked with the SAME ranking as search, so the famous company is never truncated; each hit carries authoritative website/domain/logo_url plus sector, last-known valuation, ticker. Call this FIRST to resolve a name to company_id; use /search for multi-entity or detail=full.

Parameters2

q	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_v3_private_markets_company

FULL private-company profile by company_id: financials (revenue/EBITDA/EBIT/net income/EV/net debt), complete financing history (round size/valuation/date/type), classification, HQ/contact, parent hierarchy, and cikcode/ticker to join public data. Call it after resolving the id via search_suggest for the deep dive on one company.

Parameters1

company_id

string

required

Path parameter 'company_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_company_dossier

EVERYTHING on a private company in ONE call — the complete detail-page payload: full profile (incl. financials & full financing history) + full deal history + investors + competitors + similar companies + board/team.

Parameters6

company_id	string	required	Path parameter 'company_id' (required).
deals	integer	optional
peers	integer	optional
investors	integer	optional
blocks	string	optional
fields	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    },
    "deals": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    },
    "peers": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    },
    "investors": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 300
    },
    "blocks": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_company_realtime

LIVE real-time overlay for a private company — the fast-moving complement to the (weekly, possibly STALE) private-markets profile, on a short TTL with per-field source provenance. ALWAYS call this for a private company to check whether it has GONE PUBLIC: it returns a `public_transition` block (new ticker, IPO date, SEC evidence) even when the snapshot still shows 'In IPO Registration'/no ticker — then pivot to the public-equity tools (price_snapshot / company_facts / sec_filings) for live data. Also surfaces live headcount / jobs / funding freshness when those providers are set.

Parameters1

company_id

string

required

Path parameter 'company_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_company_deals

Funding-round and M&A deal history for a private company (deal size, type, VC round, pre/post-money valuation), newest first. Call this when the user asks 'when did X last raise / at what valuation / who acquired it'; use /investors for who participated.

Parameters2

company_id	string	required	Path parameter 'company_id' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_company_investors

Investor roster for a private company, resolved through the deal-investor relation; detail=full adds every investor column (AUM, dry powder, activity). Call this when the user asks 'who backed X / which VCs are on the cap table'; use /deals for the rounds themselves.

Parameters3

company_id	string	required	Path parameter 'company_id' (required).
limit	integer	optional
detail	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 500
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ],
      "default": "lean"
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_companies

SCREEN private companies by sector, geography, financing/business status, size (total raised/valuation/employees, $MILLIONS), founding year; rows carry ticker/cikcode to join public data. PRIMARY tool for list questions like 'VC-backed fintech in Europe raised >$100M'; status=active_private excludes public/acquired/defunct.

Parameters23

sector	string	optional
industry_group	string	optional
country	string	optional
region	string	optional
financing_status	string	optional
business_status	string	optional
q	string	optional
min_raised	number	optional
max_raised	number	optional
min_valuation	number	optional
max_valuation	number	optional
min_employees	integer	optional
max_employees	integer	optional
founded_after	integer	optional
founded_before	integer	optional
has_ticker	boolean	optional
status	string	optional
sort	string	optional
desc	boolean	optional
limit	integer	optional
offset	integer	optional
detail	string	optional
fields	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sector": {
      "type": "string"
    },
    "industry_group": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "region": {
      "type": "string"
    },
    "financing_status": {
      "type": "string"
    },
    "business_status": {
      "type": "string"
    },
    "q": {
      "type": "string"
    },
    "min_raised": {
      "type": "number"
    },
    "max_raised": {
      "type": "number"
    },
    "min_valuation": {
      "type": "number"
    },
    "max_valuation": {
      "type": "number"
    },
    "min_employees": {
      "type": "integer"
    },
    "max_employees": {
      "type": "integer"
    },
    "founded_after": {
      "type": "integer"
    },
    "founded_before": {
      "type": "integer"
    },
    "has_ticker": {
      "type": "boolean"
    },
    "status": {
      "type": "string",
      "enum": [
        "any",
        "active_private"
      ],
      "default": "any"
    },
    "sort": {
      "type": "string",
      "enum": [
        "totalraised",
        "lastknownvaluation",
        "employees",
        "yearfounded",
        "lastfinancingdate",
        "revenue",
        "ebitda"
      ],
      "default": "totalraised"
    },
    "desc": {
      "type": "boolean",
      "default": true
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 50000
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ],
      "default": "lean"
    },
    "fields": {
      "type": "string"
    }
  }
}

tengu_v3_private_markets_company_comparables

Private peer set for one company: same industry sector and similar size band (0.2x-5x total raised), excluding the company itself. Call this when the user asks 'who are X's private comps' or needs a peer group for valuation framing; detail=full returns every column per peer.

Parameters4

company_id	string	required	Path parameter 'company_id' (required).
limit	integer	optional
detail	string	optional
fields	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 100
    },
    "detail": {
      "type": "string",
      "enum": [
        "lean",
        "full"
      ],
      "default": "lean"
    },
    "fields": {
      "type": "string"
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_aggregates

Private-market landscape aggregates grouped by sector, industry_group, region, or country: company counts, total and median capital raised, median valuation, median employees. Call this for market-level questions like 'which sectors raise the most' — not for single companies.

Parameters2

by	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "by": {
      "type": "string",
      "enum": [
        "sector",
        "industry_group",
        "region",
        "country"
      ],
      "default": "sector"
    },
    "limit": {
      "type": "integer",
      "default": 30,
      "minimum": 1,
      "maximum": 200
    }
  }
}

tengu_v3_private_markets_investor

Investor profile for one VC/PE/family office by investor_id: type, AUM, dry powder, year founded, investment focus, and median valuation/round. Call this when the user asks who an investor is or how big/active they are; use investor_relations for portfolio, funds, and co-investors.

Parameters1

investor_id

string

required

Path parameter 'investor_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "investor_id": {
      "type": "string",
      "description": "Path parameter 'investor_id' (required)."
    }
  },
  "required": [
    "investor_id"
  ]
}

tengu_v3_private_markets_fund

Fund profile + performance: vintage, size, category, status, and returns (IRR/DPI/TVPI/RVPI/NAV/quartile) when loaded.

Parameters1

fund_id

string

required

Path parameter 'fund_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "fund_id": {
      "type": "string",
      "description": "Path parameter 'fund_id' (required)."
    }
  },
  "required": [
    "fund_id"
  ]
}

tengu_v3_private_markets_person

Person profile (founder/exec/board member) by person_id: role, board seats, affiliated deals/funds, education, and professional-profile link. Call this when the user asks who a founder or executive is; use person_relations to walk their full career and deal history.

Parameters1

person_id

string

required

Path parameter 'person_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "Path parameter 'person_id' (required)."
    }
  },
  "required": [
    "person_id"
  ]
}

tengu_v3_private_markets_limited_partner

Limited-partner profile by lp_id: LP type, AUM, total/active commitments, allocation to alternatives, and openness to first-time funds. Call this when the user asks who an LP is or how much it commits; use limited_partner_relations for its fund commitments and mandates.

Parameters1

lp_id

string

required

Path parameter 'lp_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "lp_id": {
      "type": "string",
      "description": "Path parameter 'lp_id' (required)."
    }
  },
  "required": [
    "lp_id"
  ]
}

tengu_v3_private_markets_deal

Single deal / financing round by deal_id: deal size, type, VC round, pre/post-money valuation, and a synopsis. Call this when the user asks about a specific round ('what was the Series C?'); use deal_relations for the investors, lenders, and tranches behind it.

Parameters1

deal_id

string

required

Path parameter 'deal_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "deal_id": {
      "type": "string",
      "description": "Path parameter 'deal_id' (required)."
    }
  },
  "required": [
    "deal_id"
  ]
}

tengu_v3_private_markets_service_provider

Advisory-firm profile by sp_id — the law firm, investment bank, auditor or consultancy behind private-market deals: type, employees, parent, and count of companies serviced. Call this when the user asks who advised a deal or how big an adviser is; use service_provider_relations for its client list.

Parameters1

sp_id

string

required

Path parameter 'sp_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "sp_id": {
      "type": "string",
      "description": "Path parameter 'sp_id' (required)."
    }
  },
  "required": [
    "sp_id"
  ]
}

tengu_v3_private_markets_service_provider_relations

Reverse adviser index for one service provider: every deal, company, investor, fund or LP the firm has advised (relation= picks the edge, limit default 50). PRIMARY tool for 'which deals did this bank run?' / 'who does this law firm work for?' — the counterparty-selection view the forward service_providers relation cannot express.

Parameters3

sp_id	string	required	Path parameter 'sp_id' (required).
relation	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sp_id": {
      "type": "string",
      "description": "Path parameter 'sp_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "deals",
        "companies",
        "investors",
        "funds",
        "limited_partners",
        "board"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "sp_id",
    "relation"
  ]
}

tengu_v3_private_markets_relations

Catalogue of every queryable relation per private-markets entity type — the map of the private-capital graph. Call it first when unsure which relation= value a company/investor/fund/deal/person/LP relations tool accepts before traversing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_private_markets_company_relations

Traverse a company's private-market graph one edge per call (relation=): competitors, investors, board, similar companies, affiliates, buyside targets, service providers, industries/verticals, news, financials, employee history and more. Call this when the user asks who backs, competes with, or sits on the board of a company.

Parameters3

company_id	string	required	Path parameter 'company_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string",
      "description": "Path parameter 'company_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "competitors",
        "investors",
        "board",
        "similar",
        "affiliates",
        "buyside",
        "lead_partners",
        "service_providers",
        "industries",
        "verticals",
        "naics",
        "sic",
        "locations",
        "news",
        "financials",
        "clinical_trials",
        "market_analysis",
        "stock_exchanges",
        "entity_types",
        "morningstar_codes",
        "employee_history",
        "cik_codes"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "company_id"
  ]
}

tengu_v3_private_markets_deal_relations

Traverse a deal's graph one edge per call (relation=): investors, tranches, debt lenders, sellers, service providers, bonds, loans, distribution beneficiaries. Call this when the user asks who funded, lent into, or sold in a specific round after fetching the deal itself.

Parameters3

deal_id	string	required	Path parameter 'deal_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "deal_id": {
      "type": "string",
      "description": "Path parameter 'deal_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "investors",
        "tranches",
        "debt_lenders",
        "sellers",
        "service_providers",
        "bonds",
        "loans",
        "distrib_beneficiaries"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "deal_id"
  ]
}

tengu_v3_private_markets_investor_relations

Traverse an investor's graph one edge per call (relation=): portfolio companies, funds raised, co-investors, LPs, board, deals, news, and investment focus by industry/year. Call this when the user asks what a VC/PE firm holds, who invests alongside it, or who its LPs are.

Parameters3

investor_id	string	required	Path parameter 'investor_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "investor_id": {
      "type": "string",
      "description": "Path parameter 'investor_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "portfolio_companies",
        "funds",
        "co_investors",
        "board",
        "limited_partners",
        "affiliates",
        "deals",
        "locations",
        "news",
        "invest_industries",
        "invest_years",
        "service_providers",
        "entity_types",
        "types"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "investor_id"
  ]
}

tengu_v3_private_markets_fund_relations

Traverse a fund's graph one edge per call (relation=): investors, LP commitments, team, portfolio holdings, close history, fund family, service providers, and returns time-series. Call this when the user asks what a fund holds, who committed capital, or how it has performed.

Parameters3

fund_id	string	required	Path parameter 'fund_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "fund_id": {
      "type": "string",
      "description": "Path parameter 'fund_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "investors",
        "lp_commitments",
        "team",
        "portfolio_holdings",
        "close_history",
        "family",
        "service_providers",
        "returns"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "fund_id"
  ]
}

tengu_v3_private_markets_person_relations

Traverse a person's graph one edge per call (relation=): career positions, board seats, education, affiliated deals/funds, advisory roles. Call this when the user asks where a founder or exec worked before, what boards they sit on, or which deals they touched.

Parameters3

person_id	string	required	Path parameter 'person_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "description": "Path parameter 'person_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "positions",
        "board_seats",
        "education",
        "affiliated_deals",
        "affiliated_funds",
        "advisory"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "person_id"
  ]
}

tengu_v3_private_markets_limited_partner_relations

Traverse an LP's graph one edge per call (relation=): fund commitments, board, mandates, news, service providers. Call this when the user asks which funds an LP has committed to or what mandates it is running.

Parameters3

lp_id	string	required	Path parameter 'lp_id' (required).
relation	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lp_id": {
      "type": "string",
      "description": "Path parameter 'lp_id' (required)."
    },
    "relation": {
      "type": "string",
      "enum": [
        "fund_commitments",
        "board",
        "mandates",
        "news",
        "service_providers"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "lp_id"
  ]
}

tengu_v3_tape_bars

Intraday minute bars for one equity from FIRM's own market-data capture (~10.5k tickers, extended hours included). Use when an agent needs REAL intraday price/volume history — how a ticker traded through an event, VWAP context, or a finer-grained chart than daily bars. Archive begins 2026-05-10; pass date=YYYY-MM-DD (or start+end, max 5 trading days). 1m is the native grain; 5m/15m/1h are resampled server-side.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
start	string	optional
end	string	optional
interval	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "1h"
      ],
      "default": "1m"
    },
    "limit": {
      "type": "integer",
      "default": 5000,
      "minimum": 1,
      "maximum": 10000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_tape_index_bars

Intraday minute bars for the major index tapes — SPX, NDX, DJI, RUT, VIX — from FIRM's own market-data indices capture. Use for intraday market/vol context around an event (how did SPX and VIX move through the FOMC statement?) or as the benchmark leg next to tengu_v3_tape_bars. Archive begins 2026-05-14; one day or max 5 trading days per call.

Parameters6

index	string	required	Path parameter 'index' (required).
date	string	optional
start	string	optional
end	string	optional
interval	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Path parameter 'index' (required)."
    },
    "date": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "interval": {
      "type": "string",
      "enum": [
        "1m",
        "5m",
        "15m",
        "1h"
      ],
      "default": "1m"
    },
    "limit": {
      "type": "integer",
      "default": 5000,
      "minimum": 1,
      "maximum": 10000
    }
  },
  "required": [
    "index"
  ]
}

tengu_v3_tape_options

Raw options trade prints for one underlying on one trading day from FIRM's own market-data capture — per-print premium (notional_usd), strike, expiry, block/sweep flags, sorted largest premium first. Use when an agent needs the actual options tape behind a flow signal: whale prints, sweep activity, what struck around a specific time. Archive begins 2026-05-11; date is mandatory (70 GB day-partitioned table).

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
date	string	required
min_premium	number	optional
side	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "min_premium": {
      "type": "number",
      "minimum": 0
    },
    "side": {
      "type": "string",
      "enum": [
        "C",
        "P"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker",
    "date"
  ]
}

tengu_v3_tape_futures

Raw CME futures trade prints for one root (NG, CL, ES...) and one day, from FIRM's own capture: per-print price, size, notional, block flag across contract months. Call it for real futures flow: energy tape, rolls, block prints. date mandatory; archive from 2026-05-13, mostly CME energy (NG heavy) — empty = not-yet-captured, not quiet.

Parameters3

root	string	required	Path parameter 'root' (required).
date	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "root": {
      "type": "string",
      "description": "Path parameter 'root' (required)."
    },
    "date": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "root",
    "date"
  ]
}

tengu_v3_tape_futures_curve

Futures term structure for one CME root (27 roots incl. ES, NQ, CL, NG, GC, ZN) from FIRM's daily chain snapshots — per contract month: last/settlement, bid/ask, session OHLC, volume, open interest, days-to-expiry. Call it for curve shape (contango/backwardation), roll, or OI distribution; omit date for latest, snapshots begin 2026-05-18.

Parameters3

root	string	required	Path parameter 'root' (required).
date	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "root": {
      "type": "string",
      "description": "Path parameter 'root' (required)."
    },
    "date": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 120,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "root"
  ]
}

tengu_v3_tape_microstructure

60s microstructure windows per ticker from FIRM's live tape: rolling vwap, trade count/avg size, block count/vol, buy/sell imbalance, large-trade premium. Call it to separate smart-money accumulation from retail moves. Active-set coverage (~few hundred names/session; empty = uncaptured); omit date for latest, capture from 2026-05-13.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_options_flow_history

Historical options-flow aggregates for one ticker — the ~60s warehouse capture behind the live /intel/options_flow tool. Call when you need how flow EVOLVED (e.g. 'was NVDA flow bullish before the earnings pop?') rather than the current snapshot. Rows: as_of_ts, polarity (-1..1 net bullish/bearish score), n_alerts, premium_total (USD) + a window summary (total premium, avg polarity, bullish/bearish snapshot counts). REQUIRES date OR start(+end), max 7 days per request (422 otherwise); warehouse coverage begins 2026-05-10. 5-min cache.

Parameters7

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
start	string	optional
end	string	optional
min_premium	number	optional
side	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "min_premium": {
      "type": "number",
      "minimum": 0
    },
    "side": {
      "type": "string",
      "enum": [
        "bullish",
        "bearish"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_iv_analytics

LIVE implied-volatility analytics in one call: IV RANK (current IV + its 1-year percentile — the standard 'is vol cheap or rich' gauge, with a plain-language verdict), SKEW (risk-reversal per delta — put-vs-call demand / crash premium), and TERM STRUCTURE (IV per expiry + option-implied move, labelled backwardation vs contango). Use for 'should I buy or sell premium on X', earnings-vol setups, and hedging cost. Omit date for the latest session. Each block degrades independently. NOT the same as /intel/vol_surface, which serves the lagged academic surface.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 400
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_gex_history

Historical dealer gamma-exposure (GEX) for one ticker — daily per-strike snapshots behind the live /intel/gex tool. Call for 'how did dealer positioning shift into OPEX / earnings?'. Default returns ONE ROW PER TRADING DAY (call/put/net GEX totals, strike count, max-gamma strike); pass per_strike=true for the full strike ladder (gamma/charm/vanna + call/put GEX per strike). REQUIRES date OR start(+end), max 30 days per request (422 otherwise); coverage begins 2026-05-10. 10-min cache.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
start	string	optional
end	string	optional
per_strike	boolean	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "per_strike": {
      "type": "boolean",
      "default": false
    },
    "limit": {
      "type": "integer",
      "default": 10000,
      "minimum": 1,
      "maximum": 50000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_darkpool_history

Historical dark-pool (off-exchange) prints for one ticker — the per-print warehouse capture behind the live /intel/darkpool tool. Call to find WHEN large blocks hit and whether they printed at bid/mid/ask. Each row is an individual execution: executed_at, price, size, premium (USD), market center + the NBBO at print time; newest first, plus total premium/size summary. REQUIRES date OR start(+end), max 7 days per request (422 otherwise); coverage begins 2026-05-10. 5-min cache.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
date	string	optional
start	string	optional
end	string	optional
min_premium	number	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "date": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "min_premium": {
      "type": "number",
      "minimum": 0
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_borrow_cost_history

Daily securities-lending borrow-cost HISTORY for one ticker from the licensed-research warehouse (default: last 90 days of coverage; max 365-day window). Primary source securities-finance Securities Finance (~50M rows 2010->latest licensed-research drop): annualized fee_pct / rebate_pct, utilization_pct and on-loan/lendable share quantities — the institutional squeeze-watch series (rising fee + utilization = tightening borrow). Falls back to implied-vol option-implied borrow (shortest tenor per day) when securities-finance lacks the name. licensed-research refreshes on a lag — check as_of before treating the newest row as current; use /intel/borrow_cost for the live snapshot. 1h cache.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 365,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_transcripts_list

List a company's earnings calls and investor-event transcripts (licensed institutional, 1.75M calls), newest first — call this FIRST to get the ``event_id`` you pass to the full-text route. One row per call (versions collapsed to the best copy: Proofed > Edited > Spellchecked) with date, title and event type. Full text coverage is 2020-2025; older calls are metadata-only.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
since	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "since": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_transcript_text

Full earnings-call transcript as ordered speaker turns — use when the user wants what management or analysts actually SAID on a call. ``event_id`` comes from /api/v3/transcripts/{ticker} or /transcripts/search. Each turn carries speaker name + role (executive/analyst/operator) and section (presentation vs qa). ~2 MB text cap (``truncated: true`` when hit — refetch with components= to slice). Text coverage 2020-2025.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
event_id	string	required	Path parameter 'event_id' (required).
components	string	optional
max_turns	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "event_id": {
      "type": "string",
      "description": "Path parameter 'event_id' (required)."
    },
    "components": {
      "type": "string",
      "enum": [
        "all",
        "presentation",
        "qa"
      ],
      "default": "all"
    },
    "max_turns": {
      "type": "integer",
      "default": 800,
      "minimum": 1,
      "maximum": 1500
    }
  },
  "required": [
    "ticker",
    "event_id"
  ]
}

tengu_v3_transcripts_search

Search earnings-call transcripts. scope=headlines (default) searches call titles across ALL companies; scope=text searches the spoken words inside one company's transcripts (ticker REQUIRED) and returns per-call hit counts + a snippet. Use when the user asks 'which calls mention X' — then fetch the full text with the returned event_id.

Parameters5

q	string	optional
ticker	string	optional
since	string	optional
scope	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "since": {
      "type": "string"
    },
    "scope": {
      "type": "string",
      "enum": [
        "headlines",
        "text"
      ],
      "default": "headlines"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "minimum": 1,
      "maximum": 50
    }
  }
}

tengu_v3_events

Company corporate-event history from a licensed events feed (41.9M events, 1990-2026): M&A, guidance changes, buybacks, exec changes, activism, offerings, index adds/drops + 100 more types, newest-first dated headlines + summaries. PRIMARY tool for 'what happened at COMPANY'; filter type= (see /api/v3/events/types), since/until.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
type	string	optional
since	string	optional
until	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "type": {
      "type": "string"
    },
    "since": {
      "type": "string"
    },
    "until": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_events_types

Legend of the 105 licensed institutional KeyDev corporate-event types: id, human label, and the slug accepted by the type= filter of /api/v3/events/{ticker}. Static — call once to discover valid event-type filters.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_credit

One-call credit snapshot for a company — call FIRST for any 'how risky is this company's debt?' question: latest securities-finance 5Y CDS spread (bps) with ~90-quote trend + market-implied default probability, current S&P rating with the last upgrade/downgrade action, a recent FINRA TRACE bond yield/volume summary, and the syndicated-loan-facility count. Blocks degrade independently (a missing dataset returns an error field in its block, never a failed call). Drill down with the credit bonds/cds/ratings/loans tools.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_credit_bonds

FINRA TRACE corporate-bond trade prints for one issuer — individual OTC trades (price, yield, volume, buy/sell side) showing where the company's bonds ACTUALLY trade (realised credit spreads, not quotes). Matched by the FINRA bond-symbol prefix of the equity ticker; window spans at most 90 days (422 beyond). TRACE on licensed-research lags realtime by months — when the default recent window is empty the response includes latest_available; page backwards from it.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_origin_short_activity

How shorted is this name, from the tape itself: the DAILY consolidated short-volume prints (short ratio per session, full-market coverage) joined with the settled SHORT INTEREST published twice monthly (position, days-to-cover). Call it for squeeze setups, crowded shorts, or to check whether daily shorting is rising while settled interest lags. The two measures are a FLOW and a STOCK and can diverge — never treat them as the same number. Share volume is FRACTIONAL by design (retail fractional trading), so sub-1-share values are genuine.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
days	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "days": {
      "type": "integer",
      "default": 30,
      "minimum": 5,
      "maximum": 180
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_origin_whale_holdings

What the tracked managers own, as filed on Form 13F: latest-period positions with value, share/principal count and portfolio weight, filterable by manager or issuer. Call it for whale positioning and conviction sizing. 13F is filed within 45 days of quarter end and covers LONG US equity only — it is a lagged, partial view of a book, never a live one.

Parameters3

manager	string	optional
ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "manager": {
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_origin_insider_flow

Insider transactions straight from the Form 4 filings: owner, title, transaction code, direction, shares, price and shares held after. Call it for insider conviction around events. Transaction codes matter — 'P'/'S' are open-market buys/sells while 'M' is an option exercise and 'A' an award; treating them alike overstates conviction. Coverage is a tracked issuer set, not the whole market.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
days	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "days": {
      "type": "integer",
      "default": 90,
      "minimum": 7,
      "maximum": 365
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_origin_macro_pulse

One call for the cross-asset state of the world from the issuing authorities: volatility futures TERM STRUCTURE (contango vs backwardation — the stress regime flag), the composite LEADING INDICATOR by country, official-sector positioning (primary-dealer series + central-bank balance sheet), recent TREASURY AUCTIONS, and physical-trade throughput at the maritime chokepoints. Call it to frame regime before a single-name view. Each block reports its own availability; the leading indicator publishes with a ~2-month reference lag BY CONSTRUCTION — that is not staleness.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_origin_ipo_pipeline

What is going public: deals that are priced, upcoming or newly filed, with offer size, share count, exchange and dates. Call it for new-issue supply, going-public timing, or to corroborate a private-company transition signal. This is a SECOND, independent view of going-public activity — corroborate it against the filing index rather than treating either source as complete alone.

Parameters2

status	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "priced",
        "upcoming",
        "filed"
      ],
      "default": "upcoming"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 200
    }
  }
}

tengu_v3_credit_indices

Credit-index composites — the credit market's VIX-equivalents: CDX (NA IG/HY) + iTraxx (Europe/Asia/SovX) daily composite spreads and prices by series/version/tenor, 2018 to T-2. Call it for credit-market risk appetite, spread-widening episodes, or cross-asset stress context. FRESHNESS IS T-2 (daily composite) — never present as realtime.

Parameters4

family	string	optional
index_ticker	string	optional
days	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "family": {
      "type": "string",
      "enum": [
        "CDX",
        "ITRAXX-EUROPE",
        "ITRAXX-ASIA",
        "ITRAXX-SOVX"
      ]
    },
    "index_ticker": {
      "type": "string"
    },
    "days": {
      "type": "integer",
      "default": 7,
      "minimum": 1,
      "maximum": 90
    },
    "limit": {
      "type": "integer",
      "default": 2000,
      "minimum": 1,
      "maximum": 5000
    }
  }
}

tengu_v3_credit_cds_history

Daily 5Y single-name CDS spread history: composite par spreads (raw + bps), market-implied default probability, average/implied agency rating. Call it for how default risk has trended (tengu_v3_credit is the one-call snapshot). Coverage 2005 to end-2025, 5Y tenor; tickers match the equity symbol for liquid US names (F, T, GE...).

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_credit_ratings

Full S&P rating-action history for one issuer's debt — every licensed institutional action (new rating, upgrade, downgrade, outlook/creditwatch change) with from/to symbols, newest first. Use when asked what a company is rated or when/why it was up/downgraded. Equity ticker is resolved to the issuer CUSIP-6 via the fundamentals security master; actions are instrument-level, so several rows can share a date.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_credit_loans

Syndicated loan book for one borrower: per-facility size, type (revolver/term), maturity, security/seniority, all-in drawn/undrawn spread bps, covenants; include_lenders adds recent-facility syndicate allocations. Private-credit complement to the TRACE bond tape; call for leverage, facility or covenant questions; match on borrower ticker.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional
include_lenders	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 1000
    },
    "include_lenders": {
      "type": "boolean",
      "default": false
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_factor_characteristics

Latest monthly firm-characteristic vector from the academic firm-characteristic panel (~460 columns incl. the 102 published anomaly characteristics — size, book-to-market, momentum, liquidity, accruals, analyst coverage, plus macro interactions). Call it when you need the full quant feature set for one stock, or a point-in-time vector via as_of. Ticker is resolved to its internal security key automatically.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
as_of	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "as_of": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_factor_characteristic_history

Monthly time series of ONE factor characteristic for a stock (e.g. mom_12m, bm, mktcap, realized_vol, sue, turnover), newest first. Call it to chart how an anomaly signal evolved for a name or to compare signal drift across names; a typo in `char` returns 422 with the full list of valid column names.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
char	string	optional
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "char": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 600,
      "minimum": 1,
      "maximum": 1200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_factor_exposures

Rolling factor betas (Fama-French 5 + momentum) for one stock: beta_mkt/smb/hml/rmw/cma/umd with alpha, idiosyncratic/total volatility and regression R², plus the monthly history of those loadings. Call it to know what factor bets a position actually carries before hedging or sizing it.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 60,
      "minimum": 1,
      "maximum": 1200
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_governance

One-call corporate-governance dossier: board size + composition (independent vs executive directors, current members, from board-relationship), director interlocks with other boards, restatement record, auditor-change history, and the latest year's executive compensation (CEO/CFO and top-5 named officers, from executive-compensation). Call it for any management-quality, board-oversight or comp question; blocks degrade independently. For graded forensic red flags use /api/v3/intel/accounting_flags.

Parameters1

ticker

string

required

Path parameter 'ticker' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_accounting_flags

Forensic accounting red flags with plain-language reasons, from the forensic-audit dataset: fraud/SEC-investigation/adverse restatements, auditor resignations, going-concern or disagreement auditor changes, auditor churn, audit-fee swings >50% yoy, and non-audit-fee dominance (independence risk). Each flag carries severity + reason with the evidence rows attached. Call it before trusting reported financials on any name with earnings-quality doubts (e.g. SMCI returns the 2024 EY-resignation cluster); an empty flags list on a covered name is a genuinely clean record.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_news_sentiment_history

Daily aggregated news sentiment for one company back to 2000 — mean event sentiment (ESS), event count and mean relevance per day from the news-analytics archive (2000-2025) stitched with the live feed. Call it for long-run sentiment regimes or news reaction around past events; for today's headlines use the /news routes instead.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
min_relevance	number	optional
entity	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "min_relevance": {
      "type": "number",
      "default": 70,
      "minimum": 0,
      "maximum": 100
    },
    "entity": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 400,
      "minimum": 1,
      "maximum": 10000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_sec13f_history

Institutional-holder history — a holder × quarter matrix of 13F positions (shares per quarter-end + latest value) from the institutional-holdings 13F archive. Call it to track when funds built or exited a stock across quarters; for only the latest snapshot use /intel/sec13f.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
quarters	integer	optional
top	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "quarters": {
      "type": "integer",
      "default": 12,
      "minimum": 1,
      "maximum": 40
    },
    "top": {
      "type": "integer",
      "default": 25,
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_street_estimates_history

Analyst-level estimate revision timeline — every individual broker estimate (announce/revision dates, analyst id, fiscal period, value, realised actual) from the analyst-estimate detail archive back to 1980. Call it to reconstruct how the street walked numbers up or down before a print; for the consensus snapshot use /intel/street_estimates.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
measure	string	optional
days	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "measure": {
      "type": "string",
      "default": "EPS"
    },
    "days": {
      "type": "integer",
      "default": 365,
      "minimum": 1,
      "maximum": 9500
    },
    "limit": {
      "type": "integer",
      "default": 2000,
      "minimum": 1,
      "maximum": 50000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_street_estimates_guidance

Management guidance history — every company-issued guidance range (measure, period, low/high, announce date, street consensus at that date) from the analyst-estimate Guidance archive. Call it to compare what management promised vs what the street expected, or to study guidance-cut reactions.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
measure	string	optional
start	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "measure": {
      "type": "string"
    },
    "start": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_prices_history

Survivorship-bias-free daily price history — research-grade daily closes, total returns, volume and cumulative split adjustment factors (cfacpr/cfacshr) 2000-2024, stitched with live market-data daily bars 2025→today, plus the research-grade delisting record. Call it for backtests and long-horizon charts; for intraday or recent-only bars use /api/market/ohlc.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 15000,
      "minimum": 1,
      "maximum": 15000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_prices_corporate_actions

Complete corporate-action history — every cash dividend, stock split and distribution (research-grade distcd-coded with divamt, facpr/facshr factors and declare/ex/record/pay dates) back to first listing. Call it to build adjusted price series or dividend-growth analyses.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 1000,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_short_interest_history

Deep short-selling history — daily off-exchange short-volume series (short vs total shares across FINRA venues + short ratio, back to 2006) plus the official bi-monthly short-interest series from the securities-finance/licensed-research archive. Call it for multi-year squeeze setups or shorting pressure around events; for today's borrow cost use /intel/short_interest.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 400,
      "minimum": 1,
      "maximum": 5000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_workforce_momentum

Monthly EMPLOYMENT MOMENTUM for one company — headcount trend, hiring vs attrition and salary level, from a monthly workforce panel rather than an annual filing. Returns the latest month's headcount with its hiring, attrition and net-hiring rates (percent of headcount per month plus annualized twins), 1m/3m/12m headcount growth, average salary per employee (USD per year) with its coverage, and the full monthly series. Call it to see a company expanding or shrinking MONTHS before the next 10-K, or to catch attrition rising while headcount looks flat. Values are modelled estimates, not company-reported figures. The panel is being backfilled: `coverage` reports the months actually present and any lookback the panel cannot support returns null with a reason — never an interpolated number. Ticker is not unique across venues; the response names the entity served and lists alternates you can pin with employer_id.

Parameters3

ticker	string	required	Path parameter 'ticker' (required).
months	integer	optional
employer_id	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "months": {
      "type": "integer",
      "default": 24,
      "minimum": 2,
      "maximum": 120
    },
    "employer_id": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_workforce_layoffs

WARN-Act LAYOFF FILINGS for one company — the public notices an employer must file WEEKS BEFORE a cut, so they lead the press release and the next earnings call. Returns each filing (notice date, effective date, employees affected, site city/state, layoff type) newest first, plus TRUE window totals, a month-by-month series and the largest single filing; with_workforce also sizes the total against estimated headcount and names the headcount month used. Call it as a downside early-warning, or to confirm the scale of an announced restructuring — filings are SITE-level, so one restructuring appears as many rows. Coverage is US WARN notices from 1989 forward including forward-dated notices; only employers matched to a listed symbol are reachable by ticker, so an empty result is not proof there were no layoffs.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
months	integer	optional
limit	integer	optional
with_workforce	boolean	optional
employer_id	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "months": {
      "type": "integer",
      "default": 24,
      "minimum": 1,
      "maximum": 480
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 2000
    },
    "with_workforce": {
      "type": "boolean",
      "default": true
    },
    "employer_id": {
      "type": "integer"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_workforce_layoff_screen

CROSS-SECTIONAL LAYOFF SCREEN — which listed companies filed WARN-Act layoff notices in the last N days, ranked by employees noticed. One row per ticker (company, filing count, employees noticed, first/latest event date, states touched, largest single filing) across the whole listed universe. Call it for 'who is cutting right now' — notices are filed weeks before the cut, so this surfaces restructurings before the press release. Only employers matched to a listed symbol appear; most WARN filers are private and are excluded by design. For one company's filings use /workforce/layoffs/{ticker}.

Parameters4

days	integer	optional
min_employees	integer	optional
state	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "default": 90,
      "minimum": 1,
      "maximum": 1825
    },
    "min_employees": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 1000000
    },
    "state": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 1000
    }
  }
}

tengu_v3_workforce_momentum_screen

CROSS-SECTIONAL HIRING SCREEN — rank listed employers by headcount growth between the panel's latest month and N months earlier: ticker, company, headcount then and now, percent and absolute change, latest hiring and attrition rates and average salary, sorted fastest-growing or fastest-shrinking. This is the workforce factor as a screen — who is actually staffing up (or quietly shrinking) months before it reaches a filing. The monthly panel is MID-BACKFILL, so a months_back longer than the loaded window returns an explicit warning listing the lookbacks that ARE available — never a silently shortened comparison.

Parameters4

months_back	integer	optional
min_headcount	number	optional
order	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "months_back": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 36
    },
    "min_headcount": {
      "type": "number",
      "default": 1000,
      "minimum": 0
    },
    "order": {
      "type": "string",
      "enum": [
        "fastest_growing",
        "fastest_shrinking"
      ],
      "default": "fastest_growing"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 500
    }
  }
}

tengu_v3_supply_chain_relationships

The SUPPLY-CHAIN GRAPH around one company — its customers, suppliers, competitors and partners in one call, each with the relationship's start date, whether it is still open, which side reported it, and revenue dependence where it was estimated. Both directions are merged and normalised to the queried company's point of view, so 'customers' includes companies that report THIS company as their supplier. Call it to map second-order exposure (whose earnings move when this name moves) or to find the listed suppliers behind a product cycle. Defaults to CURRENT relationships; status=all or as_of=YYYY-MM-DD gives history. One entry per counterparty by default (several records can back one pair) — group_by=record gives the underlying versions. revenue_percent belongs to the company named in revenue_percent_of_ticker, is an ESTIMATE on every row, and is present on only a minority of edges; coverage is reported per group.

Parameters8

ticker	string	required	Path parameter 'ticker' (required).
rel_type	string	optional
status	string	optional
as_of	string	optional
listed_only	boolean	optional
group_by	string	optional
limit	integer	optional
company_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "rel_type": {
      "type": "string",
      "enum": [
        "customers",
        "suppliers",
        "competitors",
        "partners"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "current",
        "all"
      ],
      "default": "current"
    },
    "as_of": {
      "type": "string"
    },
    "listed_only": {
      "type": "boolean",
      "default": false
    },
    "group_by": {
      "type": "string",
      "enum": [
        "counterparty",
        "record"
      ],
      "default": "counterparty"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "company_id": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_supply_chain_revenue_dependence

REVENUE DEPENDENCE, both sides — the revenue-at-risk map around one company. `customer_concentration`: how much of THIS company's revenue each customer accounts for. `dependents_on_company`: other companies whose revenue depends on THIS one (e.g. a component maker that books most of its revenue from one handset vendor) — the list that reprices when this name changes its orders, and it is in no filing screen. Percentages are of the DEPENDENT company's revenue and every row names whose revenue it is, so the number can never be read backwards. Coverage is sparse and disclosed: only a minority of relationships carry an estimated percentage, so absence means UNKNOWN, never zero.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
status	string	optional
as_of	string	optional
min_percent	number	optional
limit	integer	optional
company_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "status": {
      "type": "string",
      "enum": [
        "current",
        "all"
      ],
      "default": "current"
    },
    "as_of": {
      "type": "string"
    },
    "min_percent": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "maximum": 100
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 500
    },
    "company_id": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_supply_chain_geo_revenue

GEOGRAPHIC REVENUE EXPOSURE for one company — where the revenue actually comes from, estimated region by region and country by country for a fiscal period, with a per-row confidence score. This is the tariff / geopolitical lens: it answers 'how much of this company's revenue is China?' for names that never break that out. Returns the requested hierarchy layer as `regions`, the country leaves as `countries`, concentration metrics (largest country share and an HHI), the period served and the other periods available. ?country=CN,TW returns a per-period HISTORY for exactly those countries. Each layer sums to 100 on its own, so never add a region to a country. Amounts carry NO currency code in the source and the reporting currency can change between periods, so compare on PERCENT, not amount. Estimates, not company-reported segments — for reported segments use /fundamentals/segments/{ticker}.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
period	string	optional
layer	integer	optional
country	string	optional
top_countries	integer	optional
company_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "period": {
      "type": "string"
    },
    "layer": {
      "type": "integer",
      "default": 1,
      "minimum": 0,
      "maximum": 4
    },
    "country": {
      "type": "string"
    },
    "top_countries": {
      "type": "integer",
      "default": 25,
      "minimum": 0,
      "maximum": 250
    },
    "company_id": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_pit

WHAT THE MARKET ACTUALLY KNEW on a given date — as-FIRST-REPORTED quarterly financials for a ticker as they stood on `as_of`: for each fiscal period, the latest published version whose knowledge date is on or before that day. Later restatements are excluded BY CONSTRUCTION, which is what makes this safe to backtest on — the ordinary financials endpoints serve the restated view and will leak look-ahead. Each period also reports whether it has been restated since and what the figure reads today, so you are never silently handed a stale number. Omit as_of for the current view. Figures are in MILLIONS of each filing's own reporting currency (carried per period) — never assume USD.

Parameters7

ticker	string	required	Path parameter 'ticker' (required).
as_of	string	optional
periods	integer	optional
indfmt	string	optional
consol	string	optional
popsrc	string	optional
datafmt	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "as_of": {
      "type": "string"
    },
    "periods": {
      "type": "integer",
      "default": 8,
      "minimum": 1,
      "maximum": 60
    },
    "indfmt": {
      "type": "string"
    },
    "consol": {
      "type": "string"
    },
    "popsrc": {
      "type": "string"
    },
    "datafmt": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_pit_vintages

THE RESTATEMENT TRAIL for one fiscal quarter — every published version of the period in order, each with the day it became the live view, the day it was superseded, and exactly WHICH line items changed from the previous version. Call it to check whether a figure you are relying on has been quietly revised, and by how much: a quarter can be restated several times, and only the trail shows it. The still-current version reports a null supersede date rather than a far-future sentinel. Omit datadate for the most recent quarter held.

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
datadate	string	optional
indfmt	string	optional
consol	string	optional
popsrc	string	optional
datafmt	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "datadate": {
      "type": "string"
    },
    "indfmt": {
      "type": "string"
    },
    "consol": {
      "type": "string"
    },
    "popsrc": {
      "type": "string"
    },
    "datafmt": {
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_fundamentals_pit_coverage

The honest bounds of the point-in-time primitive: how many published versions are held, for how many companies, the span of KNOWLEDGE dates (which is what an as_of query can answer) and the span of fiscal periods covered. Call it before trusting an as_of earlier than the archive starts — outside the knowledge span the answer is 'not knowable here', not 'no data'. Pass a ticker for per-company bounds.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_intel_insider_flow

INSIDER TRANSACTIONS SPLIT BY WHETHER THE TRADE WAS PRE-SCHEDULED — Form 4/5 activity for one company with the metadata free feeds drop: the Rule 10b5-1 flag and the filing lag. Sales made under a 10b5-1 plan were scheduled in advance and carry NO view, so they are aggregated separately from discretionary trades and never blended into one 'net insider flow'; a third bucket holds rows with no plan flag, which is unknown, not discretionary. Only open-market buys and sells enter the flow buckets — grants, option exercises and tax-withholding are counted apart. Use as_of to reproduce what was PUBLIC on a date: it filters on the filing date, the only correct as-of key for insider data (a trade-date filter leaks late-filed trades).

Parameters6

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
as_of	string	optional
record_type	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "as_of": {
      "type": "string"
    },
    "record_type": {
      "type": "string",
      "enum": [
        "nonderiv",
        "deriv"
      ]
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 2000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_insider_form144

INSIDER INTENT-TO-SELL NOTICES — supply before it hits the tape. Form 144 is filed BEFORE a sale of restricted or control stock, so it is forward-looking: who intends to sell, roughly how many shares, through which broker, at what notified market value, and how the stock was acquired. Call it to see overhang building ahead of the completed sales, which only show up later in the Form-4 flow. A notice is an INTENT — it may be executed smaller, later, or not at all, so never treat notified value as realised selling.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
start	string	optional
end	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "start": {
      "type": "string"
    },
    "end": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_insider_flow_coverage

What insider history exists, for which dates, and how much of it carries a Rule 10b5-1 plan flag — rows by record type, distinct filers, the transaction- and filing-date spans, and the share of rows that actually carry the plan flag. Call it before reading a plan split as complete: rows without the flag are unknown, and this says how many there are. Pass a ticker for per-company coverage.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_intel_top_shareholders_current

CURRENT INSTITUTIONAL HOLDERS of a company, largest first — holder-level positions with shares, market value (USD), percent of shares outstanding (percent, 0-100) and the change against the prior report, so new, increased, decreased and exited positions are visible. This is the FRESH ownership view; /intel/top_shareholders and /intel/sec13f serve the older archive. The archive is being backfilled, so the response lists every quarter it actually holds with its holder count, defaults to the most COMPLETE quarter and flags any quarter still loading rather than serving a half-loaded snapshot as fact. A 'new_position' can also be a renamed or re-coded holder entity, which the response says explicitly.

Parameters4

ticker	string	required	Path parameter 'ticker' (required).
quarter	string	optional
limit	integer	optional
min_pct	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "quarter": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "minimum": 1,
      "maximum": 1000
    },
    "min_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_v3_intel_top_shareholders_coverage

How much institutional-ownership history has actually landed — per quarter: rows, securities and distinct holders held right now, plus a flag on any quarter still loading. Call it BEFORE treating a quarter-on-quarter change as a real position change: during a backfill a newly-opened quarter is incomplete, and a naive comparison makes every name look like it lost most of its holders. Pass a ticker for per-company coverage.

Parameters1

ticker

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string"
    }
  }
}

tengu_v3_reference_crosswalk

IDENTITY CROSSWALK for one symbol — every identifier the security and its issuer carry, which rung matched, and how confident that match is. Returns SECURITY-grain identifiers (CUSIP9, CUSIP8, ISIN, SEDOL, ticker, estimate-vendor ticker) kept deliberately SEPARATE from the ISSUER-grain keys (gvkey, CUSIP6, regulator filer number, entity id), because those identify a company and not a share line; plus the issuer's other listed securities, the dated timeline of every identifier this security has ever been bound to, and the bridge into the private-company graph with that link's confidence grade. Call it to join two data sets that key on different identifiers, to translate a CUSIP-keyed holdings file into tickers, or to find out what a symbol used to be. as_of=YYYY-MM-DD returns the identifiers that were IN FORCE on that date, not today's — FB resolves today to an ETF and Meta's 2012-02-01→2022-06-08 hold on the string comes back as a dated prior binding, never as the answer. A symbol shared by more than one current security is REFUSED with its candidate list rather than guessed; pass prefer_country to choose. Coverage is a number in every response: what THIS answer contains, and the corpus census (77,313 securities / 58,179 issuers / 969,333 identifier bindings / 26,189 issuers linked to the private graph, live-measured 2026-08-02). Identifier-history depth is uneven by construction — 38,850 of 77,313 securities carry a prior ticker — and every source block states its own as-of, its age in days and whether that age is past its expected refresh cadence.

Parameters6

symbol	string	required	Path parameter 'symbol' (required).
as_of	string	optional
prefer_country	string	optional
include_history	boolean	optional
include_share_classes	boolean	optional
include_private_graph	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Path parameter 'symbol' (required)."
    },
    "as_of": {
      "type": "string"
    },
    "prefer_country": {
      "type": "string"
    },
    "include_history": {
      "type": "boolean",
      "default": true
    },
    "include_share_classes": {
      "type": "boolean",
      "default": true
    },
    "include_private_graph": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "symbol"
  ]
}

tengu_v3_reference_lookup

REVERSE IDENTIFIER LOOKUP — give it a CUSIP, ISIN, SEDOL, ticker, estimate-vendor ticker, gvkey, regulator filer number, entity id or private-company-graph id and it returns the security (or, for an ISSUER key, every security under that issuer) plus which rung matched and whether that binding is still current. Exactly one identifier per call. RETIRED identifiers resolve by default — 759,618 of the 969,333 bindings on file are retired, which is precisely why a stale identifier in your own data still lands, and it comes back with the date it was replaced and by what. Issuer keys NEVER nominate one security: an issuer can carry a common line, other share classes and a foreign listing, so all of them are returned and the grain is stated. Use it to turn a CUSIP-keyed custodian file into tickers, to find the ticker behind a regulator filing, or to audit whether an identifier in your own data has gone stale. Rung coverage, measured 2026-08-02: CUSIP9 and CUSIP8 100% of 77,313 securities, ISIN 79.4%, SEDOL 74.2%, regulator filer number 67.8%, estimate-vendor ticker 37.2%.

Parameters10

cusip	string	optional
isin	string	optional
sedol	string	optional
ticker	string	optional
ibtic	string	optional
gvkey	string	optional
cik	string	optional
entity_id	string	optional
private_company_id	string	optional
include_retired	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cusip": {
      "type": "string"
    },
    "isin": {
      "type": "string"
    },
    "sedol": {
      "type": "string"
    },
    "ticker": {
      "type": "string"
    },
    "ibtic": {
      "type": "string"
    },
    "gvkey": {
      "type": "string"
    },
    "cik": {
      "type": "string"
    },
    "entity_id": {
      "type": "string"
    },
    "private_company_id": {
      "type": "string"
    },
    "include_retired": {
      "type": "boolean",
      "default": true
    }
  }
}

tengu_v3_reference_history

IDENTIFIER HISTORY for one symbol — every identifier this security has ever been bound to, with the dates each binding started and ended, plus the dated events where the ISSUER changed its name, ticker or CUSIP. This is the part of a crosswalk a current-state table cannot give you: it answers 'what was this on 2015-06-30', 'when did this CUSIP change' and 'what was this company called then'. Returns the timeline grouped by identifier rung (each entry with valid_from, valid_thru and whether it is still current), the issuer change events with what changed at each one, and — with as_of — the exact set of identifiers in force on that date. Use it to back-map a historical holdings file, to audit identifier drift in your own data, or to explain a ticker that no longer exists. STALENESS, stated rather than implied: the issuer change log is a VINTAGE snapshot that lags the live security master (as-of 2026-04-20 when this shipped, 104 days old, newest change event 2026-01-30). Its age in days and its expected cadence are in every response, and any disagreement between it and the live spine is named explicitly rather than blended into one confident answer. Coverage is a number: 969,333 identifier bindings on file, 759,618 of them retired, 38,850 of 77,313 securities carrying at least one prior ticker.

Parameters4

symbol	string	required	Path parameter 'symbol' (required).
as_of	string	optional
prefer_country	string	optional
include_change_log	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Path parameter 'symbol' (required)."
    },
    "as_of": {
      "type": "string"
    },
    "prefer_country": {
      "type": "string"
    },
    "include_change_log": {
      "type": "boolean",
      "default": true
    }
  },
  "required": [
    "symbol"
  ]
}

tengu_v3_reference_batch

BATCH CROSSWALK — up to 100 symbols resolved in ONE pass, each returning its current identifiers (CUSIP9, CUSIP8, ISIN, SEDOL, ticker, estimate-vendor ticker), its issuer keys (gvkey, CUSIP6, regulator filer number), which rung matched and its status. This is the endpoint for mapping a whole portfolio or watchlist in a single call rather than N of them. Every symbol comes back with an explicit status — resolved, historical (renamed or delisted; the security and what it trades as now are both returned), ambiguous (shared by more than one current security: the candidates are listed and NO identity is guessed) or unknown (not carried). Symbols beyond the 100 limit come back as explicit over_limit entries, never silently dropped, and the response reports how many of the requested symbols resolved as a number and a percentage (measured 2026-08-02 on a 102-symbol large-cap list: 100 looked up, 99 resolved, 1 historical, 2 over_limit).

Parameters2

symbols	string	required
prefer_country	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "type": "string"
    },
    "prefer_country": {
      "type": "string"
    }
  },
  "required": [
    "symbols"
  ]
}

tengu_v3_reference_coverage

CROSSWALK COVERAGE — what the reference dataset actually contains, measured live and stated as numbers rather than adjectives: securities and issuers carried and how many are still active, identifier bindings held and how many are RETIRED, the percentage of securities carrying each rung, how many issuers bridge into the private-company graph and how those links break down by confidence grade, and how many dated issuer change events are on file. It also NAMES the rungs this crosswalk deliberately does not serve and why — a missing rung is a stated fact here, not a silent gap a customer discovers after integrating. Every source is listed with its own as-of date, its age in days and whether that age is beyond its expected refresh cadence, so a vintage component can never pass as current. Live-measured 2026-08-02: 77,313 securities (25,512 active), 58,179 issuers, 969,333 identifier bindings (209,715 current / 759,618 retired) across 9 indexed rungs, 26,189 issuers (45.0%) linked to the private graph. Call it before you buy, or before you build against it.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_features_catalogue

FEATURE-STORE CATALOGUE — the derived research panels this platform computes for its own models: what exists, how much of it there is, how far back it goes, and how fresh it actually is. Every entry carries MEASURED coverage (rows, symbols, distinct observation dates, history window) and a measured freshness block. freshness.status is `current` when the producer is inside twice its own declared cadence, or `archival` when the producer has stopped but the dataset is a genuine historical panel — an archival dataset is still readable and EVERY read of it says so. A second, independent flag, stale_for_its_own_cadence, fires when the newest observation is old relative to the table's own typical gap: it catches a panel rewritten nightly whose data still ends months ago because the upstream licence lags. Datasets whose producer stopped and which are NOT panels are listed under `withheld` with the measurement that disqualified them and have NO route at all; `excluded` lists live datasets deliberately not sold here, with the reason. Live-measured 2026-08-02: 19 servable datasets totalling 17,062,613 rows — 14 current, 5 archival (spanning 1962, 1970, 2000, 2025-05 and 2026-05 forward) — plus 5 withheld and 2 excluded. Call it first: it is the only place the slugs for /api/v3/features/{dataset} are published.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_v3_features_dataset

READ ONE DERIVED FEATURE PANEL — the model-ready research features this platform computes for itself: price/return and liquidity features, monthly fundamentals, analyst-estimate dynamics, options and volatility-surface features, insider and institutional-ownership features, news-sentiment features, betas, regime and macro features. Discover the slugs via /api/v3/features/datasets — they are product names, not table names. With ?ticker= you get that symbol's observations newest first; without it you get the LATEST cross-section (every symbol on the most recent observation date), which is bounded by construction rather than by sorting the whole panel. Symbols resolve through the shared security resolver first and identity.identity_verified states whether the read was keyed on an authoritative identifier or on the resolved security's symbol; an ambiguous symbol is refused, never guessed. Every response carries the dataset's measured coverage (rows_total, symbols_total, observation_dates, history window) and its freshness, so an empty rows array arrives beside the count of symbols that DO have rows and can never be read as a dead upstream — `result` is the machine-readable outcome (rows, no_rows_for_symbol, no_rows_in_window). Five of the 19 servable datasets are `archival`: their producer has stopped, they are served for their history, and every response says so rather than implying currency. An unknown or withheld slug is a 404 and an unreadable store is a 503 — both refunded, because a billed 200 over an empty array is the defect this endpoint exists to remove.

Parameters5

dataset	string	required	Path parameter 'dataset' (required).
ticker	string	optional
limit	integer	optional
since	string	optional
until	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "description": "Path parameter 'dataset' (required)."
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 500,
      "minimum": 1,
      "maximum": 5000
    },
    "since": {
      "type": "string"
    },
    "until": {
      "type": "string"
    }
  },
  "required": [
    "dataset"
  ]
}

tengu_copilot_score_ticker

Full per-ticker quant analysis. CALL THIS when the user asks about any specific stock (e.g. 'should I buy NVDA', 'what do you think of TSLA'). Returns blended_score, decile, conformal expected-return interval (90% band), 12-voter breakdown, factor tier, regime context, suggested position size, and a self-contained narrative. Use the narrative as a quotable summary; use the structured fields for follow-up questions. NAMESPACE: FIRM's universe is US EQUITIES. Nine tickers (BTC ETH LINK LTC COMP ARB NEAR APT ATOM) are ALSO crypto symbols; for those the response carries a `ticker_collision` block stating the score describes the US-listed EQUITY. If the user means the CRYPTO asset pass asset_class=crypto, which 404s (no FIRM crypto model yet). NEVER present an equity score as a crypto view.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
asset_class	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "asset_class": {
      "type": "string",
      "enum": [
        "equity",
        "crypto"
      ],
      "default": "equity"
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_copilot_top_picks

Today's top N picks (long or short side). CALL THIS when the user asks 'what should I buy', 'give me trade ideas', 'top picks today', 'daily briefing', or similar list-of-ideas queries. Each pick comes with the same full quant analysis as score_ticker (score, interval, voter breakdown, narrative).

Parameters2

side	string	optional
n	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ],
      "default": "long"
    },
    "n": {
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 20
    }
  }
}

tengu_copilot_universe

The ENTIRE scored universe in one call (limit=0 = all ~13k names), ranked, each with the model's absolute suggested_position_pct AND a relative normalized_weight that sums to ~100% across the returned set. Pass tickers=AAPL,NVDA,… to score+SIZE a specific holdings basket (the per-holding rebalance path); omit it to screen/rank the universe (limit/min_decile/side). Use normalized_weight for rebalance targets.

Parameters6

side	string	optional
tickers	string	optional
limit	integer	optional
min_decile	integer	optional
normalize	boolean	optional
max_weight	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "side": {
      "type": "string",
      "enum": [
        "long",
        "short"
      ],
      "default": "long"
    },
    "tickers": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "maximum": 20000
    },
    "min_decile": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 10
    },
    "normalize": {
      "type": "boolean",
      "default": true
    },
    "max_weight": {
      "type": "number",
      "default": 0.15
    }
  }
}

tengu_copilot_macro_regime

Current macro regime + plain-English interpretation of how strong the model's edge is in this regime. CALL THIS when the user asks about market conditions, regime, 'is it a good time to invest', or how confident the model is right now.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_copilot_track_record

Out-of-sample model performance — Sharpe, IC, conformal coverage, factor-decomp alpha. CALL THIS when the user asks 'how do I know this works', 'what's your track record', 'is this real alpha vs factor exposure'. Covers out-of-sample backtest, strict-OOS, conformal-validation and factor-decomposition metrics, refreshed weekly.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_copilot_signal_health

CONTRACT C2 — is the alpha signal fit to trade, and do we actually know? CALL THIS BEFORE acting on /top-picks or /score. Returns a closed-vocabulary `status` (healthy | degraded | do_not_trade | unknown), a `tradeable` boolean to branch on, `decile_convention` (10_is_best), the per-horizon live IC, and prose guidance. Fail CLOSED on anything other than `healthy` — treat it as an empty candidate list. `unknown` is a real verdict, not a placeholder: it means no BELIEVABLE current measurement exists, which carries the same instruction as red. The contract checks whether the measurement is trustworthy, not merely recent — a drift job that re-stamps a frozen input publishes today's date over old numbers, and this refuses to grade that as fresh.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_copilot_live_ic_drift

Live IC drift status — comparison of realised live IC vs training-time IC. The canonical alpha-decay early warning. CALL THIS when the user asks 'is the model still working?', 'any drift?', 'should we trust today's predictions?'. Returns ic_ratio (live / training) per horizon, drift status (green / yellow / red), and a plain-English narrative. Sub-second; refreshed daily after the close. ic_ratio < 0 = sign flip (halt new positions); ic_ratio < 0.3 = severe (retrain ASAP); ic_ratio > 1.0 = model outperforming training expectation.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_copilot_voter_ic_drift

Per-voter IC drift breakdown — pinpoints WHICH of the 12 voters in the ensemble is decaying. The blended-IC drift tool tells you IF the ensemble is decaying; this tells you WHICH voter. CALL THIS when the user asks 'which voter is the problem?', 'why did the model decay?', 'should we re-weight?'. Critically distinguishes 'data_silent' (voter source offline → not the voter's fault) from 'real decay' (voter producing scores that no longer predict). Returns per-voter live IC, causal-marginal-ATE baseline, ic_ratio, drift severity, current weight, and operator-suggested weight delta (capped ±0.05 absolute per cycle).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

tengu_copilot_ticker_transparency

ML-transparency aggregation for one ticker — collapses 5 individual tools (ml_drivers, ml_prediction, model_calibration, voter_ic_drift, voter_coverage) into a SINGLE call. Use when Brain's verdict needs the model-transparency layer ('why is the model saying this?'). Saves 4 HTTP calls per verdict. Returns a 5-layer payload + `degraded:bool` + `missing_layers:[...]` so partial failures still produce usable output. Cache TTL 60s. Pass `cache_max_age_s=0` to bypass cache.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
cache_max_age_s	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "cache_max_age_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 3600
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_copilot_ticker_smartmoney

Smart-money aggregation for one ticker — collapses 7 individual tools (sec13f_changes, institutional_ownership, insider_trades, options_flow, darkpool, max_pain, gex) into ONE call. Use when Brain's verdict needs positioning context ('who's accumulating?', 'what is the options market saying?'). Saves 6 HTTP calls per verdict. Same `degraded` / `missing_layers` contract as ticker_transparency. Cache TTL 180s — positioning doesn't tick at chat cadence.

Parameters2

ticker	string	required	Path parameter 'ticker' (required).
cache_max_age_s	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "cache_max_age_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 3600
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_copilot_ticker_full

OMNIBUS aggregation for one ticker — Brain's primary single-stock verdict path. Pulls BOTH the 5-layer transparency cluster AND the 7-layer smartmoney cluster in ONE call (up to 12 underlying tools in parallel inside FIRM). Replaces Brain's 24-72 HTTP-burst fan-out with a single call. Use for 'should I buy X?' / 'what do you think of Y?' / 'verdict on Z' shapes. `include_smartmoney` and `include_transparency` flags let comparison views skip clusters they don't need. Cache TTL 60s. Pass `cache_max_age_s=0` to bypass cache.

Parameters5

ticker	string	required	Path parameter 'ticker' (required).
include_smartmoney	boolean	optional
include_transparency	boolean	optional
candidate_weight_pct	number	optional
cache_max_age_s	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Path parameter 'ticker' (required)."
    },
    "include_smartmoney": {
      "type": "boolean",
      "default": true
    },
    "include_transparency": {
      "type": "boolean",
      "default": true
    },
    "candidate_weight_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "cache_max_age_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 3600
    }
  },
  "required": [
    "ticker"
  ]
}

tengu_copilot_decision_review

REVIEW A TRACKED DECISION. Pass the decision_id returned by decision_track. FIRM re-fetches the same verdict shape (ticker_full) and computes a structured DELTA against the original snapshot. Returns thesis_status in {intact, weakening, broken, n/a} based on the score delta projected into the user's side direction. Includes a narrative the chat can render verbatim. Returns 404 if the decision expired (90-day TTL) or was never recorded. Use this for the 'your AAPL position you opened Tuesday is up X% — thesis is tracking' callback shape.

Parameters1

decision_id

string

required

Path parameter 'decision_id' (required).

Raw schema

{
  "type": "object",
  "properties": {
    "decision_id": {
      "type": "string",
      "description": "Path parameter 'decision_id' (required)."
    }
  },
  "required": [
    "decision_id"
  ]
}

tengu_v3_copilot_thesis_alerts

EMPTY UNTIL FIRST USE — not broken. Tracked decisions live in Redis and a row is appended ONLY on a state CHANGE, so this populates the FIRST time a tracked decision transitions. Say that to the user rather than reporting an outage. Alerts from the tracked-decision monitor: thesis intact/weakening/broken transitions, earnings-imminent, interval breaches — poll after decision_track. The 2x/day monitor job sweeps every tracked decision and appends a row ONLY on state change (deduped), so every alert here is a NEW transition worth surfacing. alert_type in {status_change, earnings_imminent, interval_breach, stale_decision}; each row carries entry/last price, realised return, score_original → score_current delta, prev_status → thesis_status, severity and a render-ready narrative. Filter with ?ticker= and ?since_hours= (default 72).

Parameters3

since_hours	number	optional
ticker	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "since_hours": {
      "type": "number",
      "default": 72,
      "minimum": 1,
      "maximum": 720
    },
    "ticker": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "minimum": 1,
      "maximum": 1000
    }
  }
}

README.md13 KBView on GitHub

Wealthnow MCP server

Institutional financial data for AI agents: corporate bond prints and CDS spreads, a 10.6M-company private-markets graph, replayable options-chain history, 13F and insider flows, transcripts, and point-in-time fundamentals. 370+ REST endpoints across 22 data products, one sign-in.

Wealthnow is a hosted Model Context Protocol server. Add one URL to your AI app, sign in to Wealthnow, and your agent can call financial data tools directly.


Endpoint	`https://mcp.wealthnow.io/mcp`
Transport	Streamable HTTP
Sign-in	OAuth 2.1. Your AI app opens Wealthnow's sign-in page and returns you connected, with no key to copy.
API key	Optional, for scripts and apps without OAuth: send it in the `X-API-Key` header.
Registry	`io.wealthnow/mcp` in the official MCP Registry
Free plan	1,000 credits a month, no card needed. Connecting from an AI app starts it for you.

Market data tools are read-only; nothing places orders or moves money.

Default list: your agent first sees account_status and up to 12 starter tools.
Full catalogue: connect to https://mcp.wealthnow.io/mcp?catalog=full to list every public tool. The same list is in the server card.
Plans: your agent can call any tool your plan includes, whether or not it is listed. The Free plan covers market data, fundamentals and SEC filings.

Data and structured signals, not investment advice.

What your agent can reach

Most finance MCP servers stop at quotes and statements. Wealthnow exposes data that desks usually get through a terminal contract:

Corporate credit: FINRA TRACE bond prints, 21.8M daily single-name CDS observations back to 2005, 15.8M credit-rating actions, and syndicated loans with pricing and covenants, keyed off the equity ticker.
Private markets: 10.6M companies, 3M deals, 4.9M people, 645k investors and funds with IRR, DPI and TVPI, and 100k+ limited partners, with round-by-round syndicates, comparables and a valuation mark.
Options chain history and tape: the entire chain with greeks, implied vol and open interest for every trading day captured since May 2026, replayable exactly as it stood, plus per-print options and futures trades and minute bars for about 10.5k tickers.
Transcripts and events: 1.75M earnings-call transcript versions and 41.9M dated corporate events back to 1990.
Institutional and insider flows: 13F holdings with quarter-over-quarter changes, a 308M-row mutual-fund holdings archive, Form 4, Rule 10b5-1 plans, Form 144 notices, insider buying clusters and congressional trades.
Fundamentals done right: point-in-time vintages, as-reported XBRL, business segments and survivorship-bias-free prices, so backtests do not see the future.
And more: options flow and gamma exposure, short interest and borrow cost, alternative data (WARN layoffs, supply-chain dependence, forensic accounting flags, lobbying, contracts, patents), news sentiment back to 2000, macro and rates, crypto, and a point-in-time ticker, CUSIP, ISIN and CIK crosswalk.

Try asking your agent:

"Using Wealthnow, is the bond market more worried about Boeing than the stock market is?"
"Using Wealthnow, who led each funding round for this startup, and what are its closest private peers?"
"Using Wealthnow, what did NVDA's options chain look like the day before its last earnings?"

The Free plan (1,000 credits a month) covers prices, fundamentals and SEC filings. Credit, private markets and options history are on the Pro plan. Failed calls are never charged. Pricing · Get a free key

Connect

Claude (claude.ai, Claude Desktop, Claude mobile)

Add Wealthnow to Claude

To add it by hand instead:

In Claude, open Settings → Connectors → Add custom connector.
Enter the name Wealthnow and the URL https://mcp.wealthnow.io/mcp.
Click Connect, sign in to Wealthnow, then click Connect on the Wealthnow page.

A connector you add on the web also appears in Claude Desktop and on mobile.

Claude Code

bash

claude mcp add --transport http wealthnow https://mcp.wealthnow.io/mcp

Then run /mcp inside Claude Code, choose wealthnow, and sign in.

Or install it as a plugin from this repository:

bash

/plugin marketplace add Hlobo-dev/wealthnow-mcp
/plugin install wealthnow@wealthnow

ChatGPT

Open ChatGPT on the web and go to Settings → Apps. Some accounts label this Apps & Connectors or Connectors.
Open Advanced settings and turn on Developer mode.
Back on Apps, click Create.
Enter the URL https://mcp.wealthnow.io/mcp and choose OAuth.
Sign in to Wealthnow when ChatGPT sends you there.

Cursor

Add Wealthnow to Cursor

Or add this to ~/.cursor/mcp.json:

json

{
  "mcpServers": {
    "wealthnow": { "url": "https://mcp.wealthnow.io/mcp" }
  }
}

The first time you use it, Cursor asks you to sign in to Wealthnow.

Codex

bash

codex mcp add wealthnow --url https://mcp.wealthnow.io/mcp
codex mcp login wealthnow

codex mcp login opens the Wealthnow sign-in in your browser. To use an API key instead, set bearer_token_env_var = "WEALTHNOW_API_KEY" under [mcp_servers.wealthnow] in ~/.codex/config.toml.

Other MCP apps

In most apps that support remote MCP servers with OAuth, you add https://mcp.wealthnow.io/mcp as a remote (Streamable HTTP) server, and the app registers itself and runs the sign-in.

Full sign-in tested end to end (sign in, back in the app, tools listed): Claude, ChatGPT, Grok, Cursor and Perplexity.
Checked to reach the Wealthnow sign-in page (2026-09-28, 70 of 72 client variants): VS Code, Zed, GitHub Copilot CLI and the Copilot desktop app, Codex, Goose, Devin Desktop (formerly Windsurf), Warp, Continue, Cline, Raycast, the Code tab in Claude Desktop, Devin, Cline, Kiro, Amp, LM Studio, Postman, Slack and Figma. The steps after sign-in are the same as for the apps above.
Gemini CLI 0.60 and later requires an iss parameter on the sign-in response; Wealthnow sends it. We have not yet run a Gemini CLI sign-in end to end.
OpenCode cannot finish sign-in yet because of a bug in OpenCode (opencode#50510). Connect it with an API key (below).
Devin Desktop (formerly Windsurf) and Warp refused the sign-in until 2026-09-28: their clients drop the iss parameter and report it missing (devin-cli#5). The server no longer asks clients to require it (it still sends it), so their sign-in is no longer refused for that reason. A key (below) also works.

If sign-in fails in your app, connect it with an API key instead:

Keep the key in your user-level settings, never in a project file that may be committed to a repository.

VS Code (.vscode/mcp.json): VS Code prompts for the key once and stores it securely.

json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "wealthnow-key",
      "description": "Wealthnow API key",
      "password": true
    }
  ],
  "servers": {
    "wealthnow": {
      "type": "http",
      "url": "https://mcp.wealthnow.io/mcp",
      "headers": { "X-API-Key": "${input:wealthnow-key}" }
    }
  }
}

Gemini CLI (-s user saves it in ~/.gemini/settings.json; without it the key is written into the current project's .gemini/settings.json):

bash

gemini mcp add -s user --transport http wealthnow https://mcp.wealthnow.io/mcp -H "X-API-Key: YOUR_WEALTHNOW_API_KEY"

Goose (~/.config/goose/config.yaml):

yaml

extensions:
  wealthnow:
    type: streamable_http
    name: wealthnow
    enabled: true
    uri: https://mcp.wealthnow.io/mcp
    headers:
      X-API-Key: YOUR_WEALTHNOW_API_KEY
    timeout: 300

OpenCode (your global config, ~/.config/opencode/opencode.json; the key comes from an environment variable):

json

{
  "mcp": {
    "wealthnow": {
      "type": "remote",
      "url": "https://mcp.wealthnow.io/mcp",
      "headers": { "X-API-Key": "{env:WEALTHNOW_API_KEY}" },
      "oauth": false
    }
  }
}

Devin Desktop and Warp sign in on their own; a key also works, for example on a machine without a browser.

Devin Desktop (formerly Windsurf; ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows; the key comes from an environment variable):

json

{
  "mcpServers": {
    "wealthnow": {
      "serverUrl": "https://mcp.wealthnow.io/mcp",
      "headers": { "X-API-Key": "${env:WEALTHNOW_API_KEY}" }
    }
  }
}

Warp (Settings → Agents → MCP servers, then add a server):

json

{
  "wealthnow": {
    "url": "https://mcp.wealthnow.io/mcp",
    "headers": { "X-API-Key": "YOUR_WEALTHNOW_API_KEY" }
  }
}

VS Code and Zed sign in on their own; a key also works, for example on a machine without a browser.

Zed (your user settings, ~/.config/zed/settings.json): Zed skips sign-in when an Authorization header is set, and the server accepts the key as a bearer token.

json

{
  "context_servers": {
    "wealthnow": {
      "url": "https://mcp.wealthnow.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_WEALTHNOW_API_KEY" }
    }
  }
}

With an API key

Get a key from the Wealthnow dashboard and send it in the X-API-Key header. Keys start with wn_; keys created before October 2026 start with tengu_ and keep working. This works in any client that lets you set headers:

json

{
  "mcpServers": {
    "wealthnow": {
      "url": "https://mcp.wealthnow.io/mcp",
      "headers": { "X-API-Key": "YOUR_WEALTHNOW_API_KEY" }
    }
  }
}

If your app only runs local servers, bridge to the remote one with mcp-remote:

json

{
  "mcpServers": {
    "wealthnow": {
      "command": "npx",
      "args": ["-y", "mcp-remote@0.14.2", "https://mcp.wealthnow.io/mcp",
               "--header", "X-API-Key:${WEALTHNOW_API_KEY}"],
      "env": { "WEALTHNOW_API_KEY": "YOUR_WEALTHNOW_API_KEY" }
    }
  }
}

Try it

Once connected, ask your agent:

Using Wealthnow, what's the latest quote for AAPL?

Or call it directly with an API key:

bash

curl -s -X POST https://mcp.wealthnow.io/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H "X-API-Key: $WEALTHNOW_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"fundamentals_price_snapshot","arguments":{"ticker":"AAPL"}}}'

More in examples/: a quickstart, Python and TypeScript.

What it covers

Live prices where licensed, each labeled with its age, plus historical prices for stocks and crypto
Fundamentals: income statement, balance sheet, cash flow, metrics, screener and peers
SEC filings: 10-K, 10-Q, 8-K and structured extracts
Insider trades (Form 4), institutional holdings (13F) and congressional trades
News and sentiment, macro, rates, FX and commodities
Options flow, alternative data and private markets (companies, deals, investors)

Discovery

MCP server card: https://mcp.wealthnow.io/.well-known/mcp/server-card.json
OAuth protected resource metadata: https://mcp.wealthnow.io/.well-known/oauth-protected-resource
REST API (OpenAPI 3.1): https://firm.wealthnow.io/api/openapi.json

License

The examples and listing files in this repository are MIT licensed; see LICENSE. The Wealthnow service is covered by its terms. "Wealthnow" is a mark of Tengu LLC.

Disclosure

Wealthnow is a trade name of Tengu LLC, which is not a broker-dealer or a registered investment adviser. Data only, not investment advice.

Install

Tools (336)

tengu_snapshottengu_insider_clusterstengu_cryptotengu_macrotengu_regimetengu_research_knowledgetengu_statustengu_ready

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://firm.tengu.co/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tengu-firm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://firm.tengu.co/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Tengu FIRM MCP Server (io.github.Hlobo-dev/tengu-firm)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

tengu_snapshot

tengu_insider_clusters

tengu_crypto

tengu_macro

tengu_regime

tengu_research_knowledge

tengu_status

tengu_ready

tengu_logs

tengu_cache_stats

tengu_v2_intervals

tengu_v2_drift

tengu_v2_feature_importance

tengu_v2_factor_decay

tengu_v2_regime_forecast

tengu_v2_regime_history

tengu_v2_var

tengu_v2_stress

tengu_v2_crash_scenarios

tengu_v2_signal_correlation

tengu_v2_short_interest

tengu_v2_alpha_discoveries

tengu_v2_strategy_evolution

tengu_v2_research_datasets

tengu_v2_research_read

tengu_v3_agents_list

tengu_v3_agent_status

tengu_v3_agent_latest

tengu_v3_trade_setups

tengu_v3_universe_scan

tengu_v3_ultimate_decision

tengu_v3_position_monitor

tengu_v3_cost_estimate

tengu_v3_slippage

tengu_v3_twap_plan

tengu_v3_vwap_plan

tengu_v3_smart_route

tengu_v3_strategies_list

tengu_v3_strategy_signals

tengu_v3_strategy_metrics

tengu_v3_signals_fusion

tengu_v3_signals_mtf

tengu_v3_signals_veto

tengu_v3_signals_cross_asset

tengu_v3_self_healing

tengu_v3_alerts_active

tengu_v3_system_health

tengu_v3_metrics

tengu_v3_api_quotas

tengu_v3_accuracy

tengu_v3_resolver_status

tengu_v3_prediction_tracker

tengu_v3_optimizer_latest

tengu_v3_memory_recall

tengu_v3_memory_reflections

tengu_v3_backtest_runs

tengu_v3_backtest_run_detail

tengu_v3_lab_strategies

tengu_v3_lab_deployments

tengu_v3_news_aggregated

tengu_v3_news_events

tengu_v3_believability

tengu_v3_thresholds

tengu_v3_hedging

tengu_v3_portfolio_risk_parity_latest

tengu_v3_validation_trials

tengu_v3_validation_trial_count

tengu_v3_kelly_uncertainty

tengu_v3_stream_ticks

tengu_v3_stream_bars

tengu_v3_stream_quotes

tengu_v3_stream_signals

tengu_v3_stream_decisions

tengu_v3_stream_alerts

Tengu FIRM MCP Server (`io.github.Hlobo-dev/tengu-firm`)