{ "components": { "schemas": { "StandardResponse": { "description": "The envelope every tn-api response is wrapped in.", "properties": { "code": { "description": "Error code if failed.", "type": [ "string", "null" ] }, "data": { "description": "Response payload. Shape depends on the endpoint." }, "failed": { "default": false, "description": "Whether the request failed.", "type": "boolean" }, "message": { "description": "Human-readable message.", "type": [ "string", "null" ] }, "success": { "default": true, "description": "Whether the request succeeded.", "type": "boolean" } }, "type": "object" }, "TnapiCoinbasePremiumInput": { "properties": { "interval": { "default": "1h", "description": "Bucket interval: 1m, 5m, 15m, 1h, 1d", "title": "Interval", "type": "string" }, "limit": { "default": 500, "description": "Max buckets fetched per venue leg", "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, "title": "CoinbasePremiumInput", "type": "object" }, "TnapiDerivativesAnalysisInput": { "additionalProperties": false, "description": "Input parameters for the derivatives_analysis tool.", "properties": { "exchange_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional derivatives venue pin, e.g. 'hyperliquid_perp' for HIP-3 builder-dex assets (xyz:* pairs), 'binance_futures', or 'bybit_futures'. Omit to let the data layer select the venue.", "title": "Exchange Id" }, "sections": { "anyOf": [ { "items": { "$ref": "#/components/schemas/TnapiDerivativesAnalysisInputDerivativesSection" }, "minItems": 1, "type": "array" }, { "type": "null" } ], "default": null, "description": "Optional response evidence scope. Null or omission uses the least-privilege funding/open-interest scope; liquidation evidence is returned only when 'liquidations' is selected.", "title": "Sections" }, "token_address": { "description": "Token identifier (e.g. 'bitcoin', 'ethereum')", "title": "Token Address", "type": "string" } }, "required": [ "token_address" ], "title": "DerivativesAnalysisInput", "type": "object" }, "TnapiDerivativesAnalysisInputDerivativesSection": { "description": "Independently selectable sections of the derivatives response.", "enum": [ "funding", "open_interest", "liquidations" ], "title": "DerivativesSection", "type": "string" }, "TnapiEtfFlowInput": { "properties": { "asset": { "default": "btc", "description": "Base coin: btc or eth", "title": "Asset", "type": "string" }, "limit": { "default": 365, "description": "Max trading days returned", "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, "title": "EtfFlowInput", "type": "object" }, "TnapiEventV2Input": { "description": "Input parameters for the event_v2 tool.\n\n``token_address`` and ``query`` are the two independent selection axes and at least one\nis required (see ``_require_a_selector``):\n\n* ``token_address`` \u2014 WHICH asset, matched structurally against the story's resolved\n entities. Alias-resolved on both sides already (the pipeline resolves each article's\n entities at ingest; the caller holds a canonical id), so it never depends on wording.\n* ``query`` \u2014 WHAT about it, matched as text against the article title/summary/body.\n\nNever restate the asset in ``query`` when ``token_address`` is set: as a text clause it\nadditionally demands that the article literally spell that word, which silently drops the\nmajority of the asset's own coverage (articles write \"Nvidia\", not \"NVDA\").", "properties": { "event_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filter to a single event type", "title": "Event Type" }, "include_body": { "default": false, "description": "Include full article/analysis body in results", "title": "Include Body", "type": "boolean" }, "include_full_summary": { "default": false, "description": "Include the complete enrichment summary in addition to the compact preview", "title": "Include Full Summary", "type": "boolean" }, "limit": { "default": 20, "description": "Max results to request from the index", "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" }, "min_rank_score": { "anyOf": [ { "maximum": 100, "minimum": 0, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Minimum final rank score", "title": "Min Rank Score" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "TOPIC to look for, as free text matched against article text (e.g. 'earnings', 'China export', 'Fed', 'tariffs'). At least one of token_address or query is required. Omit it to get the asset's events unfiltered. Do NOT pass the asset's own symbol/name here when token_address is set \u2014 that filters on wording, not identity. Without token_address a recognized asset name here is resolved to its canonical token identity instead of being matched as text.", "title": "Query" }, "sort_by": { "default": "relevance", "description": "Result order: 'relevance' for free-form catalyst research within the selected time window, or 'time' for newest-first information feeds.", "enum": [ "relevance", "time" ], "title": "Sort By", "type": "string" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filter to a single source", "title": "Source" }, "ticker": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Deprecated \u2014 prefer token_address. Names the asset by ticker (e.g. 'BTC'); it is resolved to the asset filter, so do not also repeat the asset in query.", "title": "Ticker" }, "time_window": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "24h", "description": "Optional recency filter as a positive integer hour/day duration (for example '6h', '72h', '7d', or '30d'), or 'all'", "title": "Time Window" }, "token_address": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "The asset to search, as a canonical id (e.g. 'bitcoin', 'stock_nvda', 'comm_gold'). At least one of token_address or query is required. This is exact-match \u2014 free text like 'NVDA' or 'Nvidia' will not match.", "title": "Token Address" }, "top_only": { "default": false, "description": "Only return top-ranked catalysts", "title": "Top Only", "type": "boolean" }, "topic": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filter to a single topic", "title": "Topic" } }, "title": "EventV2Input", "type": "object" }, "TnapiFearGreedInput": { "properties": { "limit": { "default": 365, "description": "Max days returned", "maximum": 3000, "minimum": 1, "title": "Limit", "type": "integer" } }, "title": "FearGreedInput", "type": "object" }, "TnapiFinancialAnalystEstimatesInput": { "properties": { "limit": { "default": 30, "description": "Max forecast periods.", "minimum": 1, "title": "Limit", "type": "integer" }, "period": { "default": "annual", "description": "'annual' or 'quarter'.", "title": "Period", "type": "string" }, "ticker": { "description": "US stock ticker (e.g. AAPL).", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "AnalystEstimatesInput", "type": "object" }, "TnapiFinancialCompanyFactsInput": { "properties": { "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "CompanyFactsInput", "type": "object" }, "TnapiFinancialEarningsCalendarInput": { "properties": { "end_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive upper bound (YYYY-MM-DD); defaults to start+14d.", "title": "End Date" }, "limit": { "default": 30, "description": "Max events.", "minimum": 1, "title": "Limit", "type": "integer" }, "start_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive lower bound (YYYY-MM-DD); defaults to today.", "title": "Start Date" }, "tickers": { "anyOf": [ { "items": { "type": "string" }, "maxItems": 25, "type": "array" }, { "type": "null" } ], "default": null, "description": "Optional ticker filter (max 25).", "title": "Tickers" } }, "title": "EarningsCalendarInput", "type": "object" }, "TnapiFinancialEarningsDataInput": { "properties": { "limit": { "default": 30, "description": "Max quarterly periods.", "minimum": 1, "title": "Limit", "type": "integer" }, "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "EarningsDataInput", "type": "object" }, "TnapiFinancialEconomicCalendarInput": { "properties": { "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Single country code filter (e.g. US); omit for all.", "title": "Country" }, "end_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive upper bound (YYYY-MM-DD); defaults to start+14d.", "title": "End Date" }, "start_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive lower bound (YYYY-MM-DD); defaults to today.", "title": "Start Date" } }, "title": "EconomicCalendarInput", "type": "object" }, "TnapiFinancialFundamentalGraphInput": { "properties": { "include_html": { "default": true, "description": "When true, include a self-contained lightweight HTML/SVG dashboard in the result.", "title": "Include Html", "type": "boolean" }, "limit": { "default": 8, "description": "Max reporting periods per statement source.", "minimum": 1, "title": "Limit", "type": "integer" }, "metrics": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Optional metric keys to render. Omit for the full available dashboard: core statement metrics, derived ratios, segmented revenue mix cards, earnings actual-vs-estimate cards, and available analyst estimate/rating cards.", "title": "Metrics" }, "period": { "default": "annual", "description": "'annual', 'quarter', or 'quarterly'. Quarterly is normalised to 'quarter'.", "title": "Period", "type": "string" }, "ticker": { "description": "US stock ticker (e.g. AAPL).", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "FundamentalGraphInput", "type": "object" }, "TnapiFinancialInsiderTradesInput": { "properties": { "end_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive upper bound (YYYY-MM-DD).", "title": "End Date" }, "limit": { "default": 30, "description": "Max Form 4 events.", "minimum": 1, "title": "Limit", "type": "integer" }, "start_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive lower bound (YYYY-MM-DD).", "title": "Start Date" }, "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" }, "transaction_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "SEC Form 4 code filter (P/S/A/M/F/...). Leave unset for all.", "title": "Transaction Code" } }, "required": [ "ticker" ], "title": "InsiderTradesInput", "type": "object" }, "TnapiFinancialInstitutionalOwnershipInput": { "description": "Inputs for ``financial_institutional_ownership``.", "properties": { "limit": { "default": 20, "description": "Max institutional holders to return (sorted by market value descending).", "maximum": 200, "minimum": 1, "title": "Limit", "type": "integer" }, "quarter": { "anyOf": [ { "maximum": 4, "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Optional filing quarter override (1-4). Must be supplied together with ``year``.", "title": "Quarter" }, "ticker": { "description": "US stock ticker (e.g. AAPL).", "title": "Ticker", "type": "string" }, "year": { "anyOf": [ { "maximum": 2100, "minimum": 1900, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Optional filing year override. Must be supplied together with ``quarter``. Default: latest filed 13F quarter.", "title": "Year" } }, "required": [ "ticker" ], "title": "InstitutionalOwnershipInput", "type": "object" }, "TnapiFinancialMetricsInput": { "properties": { "limit": { "default": 4, "description": "Max reporting periods.", "minimum": 1, "title": "Limit", "type": "integer" }, "period": { "default": "annual", "description": "'annual' or 'quarter'.", "title": "Period", "type": "string" }, "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "FinancialMetricsInput", "type": "object" }, "TnapiFinancialResolveStockTickerInput": { "properties": { "query": { "description": "Free-text \u2014 accepts tickers ('AAPL'), company names ('apple'), brand aliases, or natural-language prompts. 1..160 chars.", "maxLength": 160, "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "ResolveStockTickerInput", "type": "object" }, "TnapiFinancialSegmentedRevenueInput": { "properties": { "limit": { "default": 20, "description": "Max reporting periods (the data layer caps at 200).", "minimum": 1, "title": "Limit", "type": "integer" }, "period": { "default": "annual", "description": "'annual' or 'quarterly'.", "title": "Period", "type": "string" }, "report_period_end": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive upper bound on report_period (YYYY-MM-DD).", "title": "Report Period End" }, "report_period_start": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive lower bound on report_period (YYYY-MM-DD).", "title": "Report Period Start" }, "segment_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional segment-type filter (e.g. 'ProductOrService', 'StatementGeographical', 'StatementBusinessSegments').", "title": "Segment Type" }, "ticker": { "description": "US stock ticker (e.g. AAPL).", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "SegmentedRevenueInput", "type": "object" }, "TnapiFinancialStatementsInput": { "properties": { "limit": { "default": 30, "description": "Max reporting periods.", "minimum": 1, "title": "Limit", "type": "integer" }, "period": { "default": "annual", "description": "'annual' or 'quarter'.", "title": "Period", "type": "string" }, "statement_type": { "default": "income", "description": "'income', 'balance', 'cashflow', or 'key-stats'.", "title": "Statement Type", "type": "string" }, "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "FinancialStatementsInput", "type": "object" }, "TnapiFinancialStockDividendsInput": { "properties": { "limit": { "default": 30, "description": "Max dividend events.", "minimum": 1, "title": "Limit", "type": "integer" }, "ticker": { "description": "US stock ticker.", "title": "Ticker", "type": "string" } }, "required": [ "ticker" ], "title": "StockDividendsInput", "type": "object" }, "TnapiHyperliquidSmartMoneyInput": { "description": "Input parameters for the hyperliquid_smart_money tool.", "properties": { "sort_by": { "default": "abs_size", "description": "Sort criterion: 'abs_size', 'position_value', 'unrealized_pnl', 'leverage', or 'margin_used'", "enum": [ "abs_size", "position_value", "unrealized_pnl", "leverage", "margin_used" ], "title": "Sort By", "type": "string" }, "token_address": { "description": "the data provider ID for the token (e.g. 'bitcoin', 'ethereum')", "title": "Token Address", "type": "string" }, "top_n": { "default": 10, "description": "Number of top positions to return (1-100)", "maximum": 100, "minimum": 1, "title": "Top N", "type": "integer" } }, "required": [ "token_address" ], "title": "HyperliquidSmartMoneyInput", "type": "object" }, "TnapiKlineAnalysisInput": { "additionalProperties": false, "description": "Input parameters for the kline_analysis tool.", "properties": { "exchange_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional explicit venue id, e.g. 'hyperliquid_perp', 'COMEX', 'NASDAQ'", "title": "Exchange Id" }, "start_end_datetime": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Time range for historical data (ISO 8601 format)", "title": "Start End Datetime" }, "timeframe": { "default": "1h", "description": "Chart timeframe. Single: '5m','15m','1h','4h','1d'", "title": "Timeframe", "type": "string" }, "token_address": { "description": "Token identifier (e.g. 'bitcoin', 'ethereum')", "title": "Token Address", "type": "string" } }, "required": [ "token_address" ], "title": "KlineAnalysisInput", "type": "object" }, "TnapiLiquidationRiskInput": { "description": "Input parameters for the liquidation_risk tool.", "properties": { "current_price": { "description": "Current market price", "exclusiveMinimum": 0, "title": "Current Price", "type": "number" }, "direction": { "description": "Position direction: 'long' or 'short'", "enum": [ "long", "short" ], "title": "Direction", "type": "string" }, "liquidation_price": { "description": "Exchange-provided liquidation price", "exclusiveMinimum": 0, "title": "Liquidation Price", "type": "number" }, "token_address": { "description": "Token identifier (the data provider ID, e.g. 'bitcoin', 'ethereum')", "title": "Token Address", "type": "string" } }, "required": [ "token_address", "direction", "current_price", "liquidation_price" ], "title": "LiquidationRiskInput", "type": "object" }, "TnapiMarketSessionInput": { "description": "Input parameters for the ``market_session`` tool.", "properties": { "at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "UTC instant or ISO timestamp; defaults to now", "title": "At" }, "symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional symbol for display and symbol-specific notes", "title": "Symbol" }, "timestamp": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Alias for at, accepted for CLI convenience", "title": "Timestamp" }, "timezone": { "default": "UTC", "description": "IANA timezone for user-facing local output", "title": "Timezone", "type": "string" }, "venue": { "description": "Market venue or supported alias: hyperliquid_perp, us_equities/nyse/nasdaq, cme_comex_gold", "title": "Venue", "type": "string" } }, "required": [ "venue" ], "title": "MarketSessionInput", "type": "object" }, "TnapiMarketWhalePositionsInput": { "properties": { "base_coin": { "default": "BTC", "description": "Base coin to filter, such as BTC.", "title": "Base Coin", "type": "string" }, "size": { "default": 50, "description": "Maximum leaderboard rows.", "maximum": 100, "minimum": 1, "title": "Size", "type": "integer" } }, "title": "MarketWhalePositionsInput", "type": "object" }, "TnapiMvrvInput": { "properties": { "limit": { "default": 10000, "description": "Max days returned (newest N, served ascending)", "maximum": 10000, "minimum": 1, "title": "Limit", "type": "integer" } }, "title": "MvrvInput", "type": "object" }, "TnapiOptionsReportInput": { "description": "Input parameters for the options_report tool.", "properties": { "token_address": { "description": "Token identifier (the data provider ID, e.g. 'bitcoin', 'ethereum', 'solana', 'ripple', 'tron', 'avalanche-2')", "title": "Token Address", "type": "string" } }, "required": [ "token_address" ], "title": "OptionsReportInput", "type": "object" }, "TnapiPerformanceScannerInput": { "additionalProperties": false, "description": "Input parameters for the performance_scanner tool.", "properties": { "lookback_days": { "default": 7, "description": "Lookback period in days (1-30)", "maximum": 30, "minimum": 1, "title": "Lookback Days", "type": "integer" }, "token_universe": { "$ref": "#/components/schemas/TnapiPerformanceScannerInputTokenUniverse", "default": "crypto_top_by_volume_and_market_cap", "description": "Universe to scan: crypto_top_by_volume_and_market_cap (default; volume \u2229 market-cap), crypto_top_by_volume (volume-only), ondo_tokenized_stock, commodity, or us_equities_sp500" }, "top_n": { "default": 29, "description": "Number of ranked performers returned; distinct from presentation row count", "maximum": 100, "minimum": 1, "title": "Top N", "type": "integer" }, "universe_size": { "default": 30, "description": "Number of tokens in the candidate universe (1-200)", "maximum": 200, "minimum": 1, "title": "Universe Size", "type": "integer" } }, "title": "PerformanceScannerInput", "type": "object" }, "TnapiPerformanceScannerInputTokenUniverse": { "description": "Token universe classification for scanners and filters.", "enum": [ "crypto_top_by_volume", "crypto_top_by_volume_and_market_cap", "ondo_tokenized_stock", "commodity", "us_equities_sp500" ], "title": "TokenUniverse", "type": "string" }, "TnapiPolymarketInsightInput": { "description": "Input parameters for the polymarket_insight tool.", "properties": { "event_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Exact the prediction-market venue event slug to fetch via Gamma /events", "title": "Event Slug" }, "limit": { "default": 5, "description": "Maximum number of markets to return (1-10)", "maximum": 10, "minimum": 1, "title": "Limit", "type": "integer" }, "query_type": { "description": "Market category: 'crypto_price', 'macro_outlook', 'regulatory', or 'general'", "enum": [ "crypto_price", "macro_outlook", "regulatory", "general" ], "title": "Query Type", "type": "string" }, "search_terms": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Custom search terms to override the default query", "title": "Search Terms" }, "token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Token name or symbol \u2014 required when query_type is 'crypto_price'", "title": "Token" } }, "required": [ "query_type" ], "title": "PolymarketInsightInput", "type": "object" }, "TnapiResolveAssetInput": { "description": "Input parameters for the resolve_asset tool.", "properties": { "asset_class": { "default": "auto", "description": "Optional hint: 'auto' (default), 'crypto', 'equity', 'stock', or 'etf'.", "title": "Asset Class", "type": "string" }, "query": { "description": "Ticker, symbol, or asset name to resolve (e.g. 'SPCX', 'BTC', 'AAPL')", "title": "Query", "type": "string" } }, "required": [ "query" ], "title": "ResolveAssetInput", "type": "object" }, "TnapiTechnicalAnalysisInput": { "additionalProperties": false, "description": "Input parameters for the technical_analysis tool.", "properties": { "exchange_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional explicit venue id, e.g. 'hyperliquid_perp', 'COMEX', 'NASDAQ'", "title": "Exchange Id" }, "start_end_datetime": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Time range for historical analysis (ISO 8601 format)", "title": "Start End Datetime" }, "timeframe": { "default": "1h", "description": "One chart timeframe: '5m', '15m', '1h', '4h', or '1d'.", "title": "Timeframe", "type": "string" }, "token_address": { "description": "Token identifier (e.g. 'bitcoin', 'ethereum')", "title": "Token Address", "type": "string" } }, "required": [ "token_address" ], "title": "TechnicalAnalysisInput", "type": "object" }, "TnapiTrendingDiscoveryInput": { "description": "Input parameters for the trending_discovery tool.", "properties": { "include_categories": { "default": false, "description": "Include trending categories alongside tokens", "title": "Include Categories", "type": "boolean" }, "limit": { "default": 10, "description": "Maximum number of trending tokens to return (5-15)", "maximum": 15, "minimum": 5, "title": "Limit", "type": "integer" } }, "title": "TrendingDiscoveryInput", "type": "object" }, "TnapiVenueCostsInput": { "properties": { "asset_class": { "default": "crypto", "description": "crypto, stock, or commodity.", "enum": [ "crypto", "stock", "commodity" ], "title": "Asset Class", "type": "string" }, "instrument": { "description": "Instrument identifier (e.g. 'BTC', 'AAPL').", "title": "Instrument", "type": "string" }, "instrument_type": { "default": "spot", "description": "spot or perp.", "enum": [ "spot", "perp" ], "title": "Instrument Type", "type": "string" }, "venue": { "default": "auto", "description": "Venue override; 'auto' picks default for the asset/instrument.", "title": "Venue", "type": "string" } }, "required": [ "instrument" ], "title": "VenueCostsInput", "type": "object" } }, "securitySchemes": { "mcpKey": { "description": "A per-user MCP API key, used only against the MCP server (see the connection recipe in this document's description) \u2014 not accepted by tn-api or the gateway.", "in": "query", "name": "token", "type": "apiKey" }, "privyJwt": { "bearerFormat": "JWT", "description": "A Privy-issued JWT for a signed-in TrueNorth user. Send as `Authorization: Bearer `.", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Read-only market data for crypto, US equities, FX, and macro \u2014 the same data\nthat powers TrueNorth's own trading surfaces, over plain HTTP.\n\n**No API key required.** Every endpoint in this reference is open: no signup,\nno credential, no rate-limit registration. Try any of them right now with the\n**Test Request** button, or copy the ready-made cURL command from any page.\n\n**Two ways to call, one response envelope.** Every response is wrapped the same\nway \u2014 `data` holds the payload, alongside `success`, `message`, `code`, and\n`failed`.\n\n- **Plain REST** \u2014 a normal `GET` with query parameters, e.g.\n `GET /api/fear-greed?limit=30`. Pasteable straight into a browser.\n- **Tool call** \u2014 `POST /api/agent-tools/call` with\n `{\"toolName\": \"...\", \"arguments\": {...}}`. Every tool in the sidebar has its\n own page showing the exact request body and a real response.\n\nEvery response example was captured live from production. Long payloads are\nabridged for readability; an `\"...\"` entry marks where fields were omitted\nfrom the example and is never part of an actual response.\n\n**Building with an AI agent?** Point it at [llms.md](llms.md) \u2014 a single-file\nintegration guide written for coding agents \u2014 or [endpoints.json](endpoints.json)\nfor the machine-readable endpoint list. TrueNorth is also available as an MCP\nserver; see the connection recipe below.\n\n\n## About the per-tool pages\n\nEach tool in the sidebar is documented on its own page for readability, but every tool call is the same real request: `POST /api/agent-tools/call` with `{\"toolName\": ..., \"arguments\": {...}}`. The `#toolName` suffix you may notice in a page's path is a documentation label only \u2014 it is never sent over the wire.\n\n---\n\n## Connecting via MCP\n\nUse TrueNorth inside Claude, ChatGPT, or any MCP-compatible agent \u2014 the same\nread-only tools documented on this page, with no integration code to write.\n\n**1 \u00b7 Get a key.** Sign in at\n[app.true-north.xyz/mcp-api-key](https://app.true-north.xyz/mcp-api-key) and\nchoose **Create API Key**. Keys are free and self-served.\n\n**2 \u00b7 Use your endpoint.** Your personal MCP URL is your key appended to the\nserver address:\n\n```\nhttps://mcp.true-north.xyz/mcp?token=YOUR_KEY\n```\n\nAdd that URL as a remote MCP server in your client. Step-by-step guides for\nClaude and ChatGPT are at\n[docs.truenorth.xyz](https://docs.truenorth.xyz/truenorth-mcp/editor).\n\n**3 \u00b7 Check it works.** From a terminal:\n\n```bash\ncurl -X POST 'https://mcp.true-north.xyz/mcp?token=YOUR_KEY' \\\n -H 'Content-Type: application/json' \\\n -H 'Accept: application/json, text/event-stream' \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\nYou should get back the full tool list.\n\nMCP access is read-only: the tools return market data and analysis, and\ncannot place trades, move funds, or touch an account balance. Your key\nidentifies your own account \u2014 treat it like a password and rotate it from the\nsame page if it is ever exposed.\n", "title": "TrueNorth API \u2014 partner reference", "version": "2026-08-19-77d3a6bc4119" }, "openapi": "3.1.0", "paths": { "/api/agent-tools": { "get": { "description": "Lists every tool callable through tn-api's unauthenticated compatibility route.\n**What you get** \u2014 the machine-readable catalog of every tool you can call, so a client can discover the surface instead of hard-coding it:\n\n- `tools[].name` / `.description` \u2014 the tool identifier and what it returns, e.g. `historical_bars` (causal OHLCV bars) or `basic_market_info` (all-time high, market cap, supply).\n- `tools[].inputSchema` \u2014 a JSON-Schema `properties`/`required` block per tool. `historical_bars`, for example, requires `instruments` and accepts `timeframe`, `venue`, `asset_class`, `align`, and `limit` (default 500, max 5000).\n- `totalCount` \u2014 55 tools in the captured example.\n\n**When to use it** \u2014 check what a tool needs before POSTing to `/api/agent-tools/call`, or enumerate the whole surface to generate a typed client or SDK.\n\n**Good to know** \u2014 no credential is required, and this route answers browser preflight, so you can call it directly from frontend code. Response shapes aren't declared here; each tool's own page documents its payload with a real captured example.\n\n**Tier:** L1", "operationId": "get_api_agent_tools", "responses": { "200": { "content": { "application/json": { "examples": { "live": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "tools": [ { "description": "Causal OHLCV bars across crypto, stock, and commodity asset classes. Returns the SDK TimeSeriesResponse envelope with as_of enforcement, multi-instrument alignment (inner/outer), pagination cursor, and freshness metadata. Used by backtests, strategies, and time-series analysis.", "inputSchema": { "properties": { "align": { "default": "inner", "description": "inner = shared timestamps; outer = union with null fills.", "enum": [ "inner", "outer" ], "title": "Align", "type": "string" }, "as_of": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Causal cutoff; bars satisfy t_close <= as_of.", "title": "As Of" }, "asset_class": { "default": "crypto", "description": "crypto, stock, or commodity.", "enum": [ "crypto", "stock", "...truncated 1 more" ], "title": "Asset Class", "type": "string" }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Pagination cursor from a prior response.", "title": "Cursor" }, "end": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive ISO end (upper bound).", "title": "End" }, "instrument_type": { "default": "spot", "description": "spot or perp. perp adds funding_rate / open_interest / mark_price fields.", "enum": [ "spot", "perp" ], "title": "Instrument Type", "type": "string" }, "instruments": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ], "description": "Single instrument or list. Crypto uses token IDs ('bitcoin'), stock uses tickers ('AAPL'), commodity uses aliases ('gold').", "title": "Instruments" }, "limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Max aligned bars. Defaults to 500, max 5000.", "title": "Limit" }, "start": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Inclusive ISO start (lower bound).", "title": "Start" }, "timeframe": { "default": "1h", "description": "Bar timeframe: 1m, 5m, 15m, 30m, 1h, 4h, 12h, 1d, 1w (asset-class restricted).", "title": "Timeframe", "type": "string" }, "venue": { "default": "auto", "description": "Venue override, or 'auto' for default.", "title": "Venue", "type": "string" } }, "required": [ "instruments" ], "title": "HistoricalBarsInput", "type": "object" }, "name": "historical_bars", "outputSchema": null, "requiresAuthUser": false }, { "description": "Get fundamental market data: ATH, market cap, supply, and price ranges. Use this tool when the user asks about all-time high (ATH), market cap, circulating supply, or general market overview for a token.", "inputSchema": { "description": "Input parameters for the basic_market_info tool.", "properties": { "token_address": { "description": "Token identifier: a the data provider ID (e.g. 'bitcoin', 'ethereum') for crypto fundamentals, or a 'stock_*' HIP-3 synthetic address (e.g. 'stock_spcx') routed to a the data layer venue overview.", "title": "Token Address", "type": "string" } }, "required": [ "token_address" ], "title": "BasicMarketInfoInput", "type": "object" }, "name": "basic_market_info", "outputSchema": null, "requiresAuthUser": false }, "...truncated 53 more" ], "totalCount": 55 }, "failed": false, "message": null, "success": true } } }, "schema": { "allOf": [ { "$ref": "#/components/schemas/StandardResponse" }, { "properties": { "data": { "properties": { "tools": { "items": { "properties": { "description": { "type": "string" }, "inputSchema": { "properties": { "properties": { "properties": { "align": { "properties": { "default": { "type": "string" }, "description": { "type": "string" }, "enum": { "items": { "type": "string" }, "type": "array" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "as_of": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "default": { "type": "null" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "asset_class": { "properties": { "default": { "type": "string" }, "description": { "type": "string" }, "enum": { "items": { "type": "string" }, "type": "array" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "cursor": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "default": { "type": "null" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "end": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "default": { "type": "null" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "instrument_type": { "properties": { "default": { "type": "string" }, "description": { "type": "string" }, "enum": { "items": { "type": "string" }, "type": "array" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "instruments": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "limit": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "default": { "type": "null" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "start": { "properties": { "anyOf": { "items": { "properties": { "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "default": { "type": "null" }, "description": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "timeframe": { "properties": { "default": { "type": "string" }, "description": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "venue": { "properties": { "default": { "type": "string" }, "description": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" } }, "type": "object" }, "required": { "items": { "type": "string" }, "type": "array" }, "title": { "type": "string" }, "type": { "type": "string" } }, "type": "object" }, "name": { "type": "string" }, "outputSchema": { "type": "null" }, "requiresAuthUser": { "type": "boolean" } }, "type": "object" }, "type": "array" }, "totalCount": { "type": "integer" } }, "type": "object", "x-tn-inferred-from-live-example": true } }, "type": "object" } ] } } }, "description": "Success." } }, "security": [], "summary": "List all tools", "tags": [ "Utility" ] } }, "/api/agent-tools/batch": { "post": { "description": "Calls up to ten tools concurrently in one request.\n**What you get** \u2014 up to 10 tool calls run concurrently in one request, each returned in its own slot with the same shape `/api/agent-tools/call` uses.\n\n- `calls[].toolName` / `.arguments` \u2014 the request shape: a list of `{toolName, arguments}` pairs (`BATCH_MAX_SIZE = 10`).\n- `results[].toolName`, `.isError`, `.durationMs`, `.result` \u2014 one entry per call, in the order requested. The captured example batches a single `fear_greed` call and gets back `durationMs: 105`, `isError: false`, and the same 365-item Fear & Greed series `/api/agent-tools/call` returns alone.\n\n**When to use it** \u2014 fan out several independent tool calls (e.g. price + sentiment + funding for one dashboard render) in one round trip instead of N sequential POSTs.\n\n**Good to know** \u2014 per-tool errors land as `isError: true` inside a 200 response, same as the single-call route. Request-level violations \u2014 an empty batch, more than 10 calls, or a nested `parallel_tool_call` \u2014 fail the whole request with HTTP 422 before any tool runs, so a batch either fully dispatches or fully rejects.\n\n**Tier:** L1", "operationId": "post_api_agent_tools_batch", "requestBody": { "content": { "application/json": { "schema": { "properties": { "calls": { "items": { "properties": { "arguments": { "type": "object" }, "toolName": { "type": "string" } }, "type": "object" }, "maxItems": 10, "type": "array" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "examples": { "live": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "results": [ { "durationMs": 160, "isError": false, "result": { "items": [ { "btcPrice": 117364.0, "date": 1755475200000, "value": 61 }, { "btcPrice": 116252.6, "date": 1755561600000, "value": 57 }, "...truncated 363 more" ], "meta": { "count": 365, "dataFreshnessTs": 1786924800000, "latest": { "btcPrice": 62740.3, "date": 1786924800000, "value": 30 } }, "status": "success" }, "toolName": "fear_greed" } ] }, "failed": false, "message": null, "success": true } } }, "schema": { "allOf": [ { "$ref": "#/components/schemas/StandardResponse" }, { "properties": { "data": { "properties": { "results": { "items": { "properties": { "durationMs": { "type": "integer" }, "isError": { "type": "boolean" }, "result": { "properties": { "items": { "items": { "properties": { "btcPrice": { "type": "number" }, "date": { "type": "integer" }, "value": { "type": "integer" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "count": { "type": "integer" }, "dataFreshnessTs": { "type": "integer" }, "latest": { "properties": { "btcPrice": { "type": "number" }, "date": { "type": "integer" }, "value": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "status": { "type": "string" } }, "type": "object" }, "toolName": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object", "x-tn-inferred-from-live-example": true } }, "type": "object" } ] } } }, "description": "Success." } }, "security": [], "summary": "Batch-call tools", "tags": [ "Utility" ] } }, "/api/agent-tools/call": { "post": { "description": "Calls one tool by name \u2014 the transport underneath every tool: entry in this catalogue.\n**What you get** \u2014 the result of calling one named tool with arguments, unwrapped from tn-api's tool registry.\n\n- `toolName` \u2014 echoes the tool called, e.g. `fear_greed`.\n- `isError` \u2014 `false` on success; tool-level errors are returned this way in a 200 response rather than as an HTTP error.\n- `durationMs` \u2014 server-side execution time; 319ms in the captured `fear_greed` call.\n- `result` \u2014 the tool's own output, whatever shape that tool defines (in the example, `fear_greed`'s `{items[], meta, status}` envelope with 365 daily readings).\n\n**When to use it** \u2014 call any tool from `/api/agent-tools`'s list by name without writing a bespoke client for each one; this is the single dispatch point they all share.\n\n**Good to know** \u2014 an unknown `toolName` returns HTTP 400 before dispatch; everything else \u2014 including a tool erroring internally \u2014 comes back 200 with `isError: true`, so check that flag rather than the HTTP status to detect a failed call. `arguments` defaults to `{}` if the tool takes none.\n\n**Tier:** L1", "operationId": "post_api_agent_tools_call", "requestBody": { "content": { "application/json": { "examples": { "coinbase_premium": { "description": "Tracks the price gap between Coinbase and Binance BTC \u2014 a classic read on US institutional buying pressure. The same series behind the dashboard's Coinbase Premium widget. Arguments schema: `#/components/schemas/TnapiCoinbasePremiumInput`.", "summary": "L1 \u00b7 Sentiment / flows / on-chain cycle", "value": { "arguments": {}, "toolName": "coinbase_premium" } }, "derivatives_analysis": { "description": "Pulls funding rate, open interest, and liquidation evidence for a token's derivatives market. Arguments schema: `#/components/schemas/TnapiDerivativesAnalysisInput`.", "summary": "L1 \u00b7 Derivatives & positioning", "value": { "arguments": {}, "toolName": "derivatives_analysis" } }, "etf_flow": { "description": "Reports daily net flows into and out of the US spot BTC/ETH ETFs. The same series behind the dashboard's ETF Flow widget. Arguments schema: `#/components/schemas/TnapiEtfFlowInput`.", "summary": "L1 \u00b7 Sentiment / flows / on-chain cycle", "value": { "arguments": {}, "toolName": "etf_flow" } }, "event_v2": { "description": "Searches TrueNorth's own curated market story index for news and catalysts. Arguments schema: `#/components/schemas/TnapiEventV2Input`.", "summary": "L1 \u00b7 News & events", "value": { "arguments": { "token_address": "bitcoin" }, "toolName": "event_v2" } }, "fear_greed": { "description": "Returns the daily crypto Fear & Greed index, 0-100, with BTC price context alongside each reading. The same series behind the dashboard's Fear & Greed widget. Arguments schema: `#/components/schemas/TnapiFearGreedInput`.", "summary": "L1 \u00b7 Sentiment / flows / on-chain cycle", "value": { "arguments": {}, "toolName": "fear_greed" } }, "financial_analyst_estimates": { "description": "Returns Wall Street's EPS/revenue consensus, price targets, and buy/hold/sell ratings for a stock. Arguments schema: `#/components/schemas/TnapiFinancialAnalystEstimatesInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_analyst_estimates" } }, "financial_company_facts": { "description": "Merges a company profile with SEC EDGAR identity data for one stock. Arguments schema: `#/components/schemas/TnapiFinancialCompanyFactsInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_company_facts" } }, "financial_earnings_calendar": { "description": "Lists upcoming and recent earnings events in a date window. Arguments schema: `#/components/schemas/TnapiFinancialEarningsCalendarInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_earnings_calendar" } }, "financial_earnings_data": { "description": "Returns quarterly EPS and revenue, actual versus estimate. Arguments schema: `#/components/schemas/TnapiFinancialEarningsDataInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_earnings_data" } }, "financial_economic_calendar": { "description": "Lists upcoming and recent macro releases \u2014 CPI, non-farm payrolls, rate decisions \u2014 with consensus and actual values. Arguments schema: `#/components/schemas/TnapiFinancialEconomicCalendarInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_economic_calendar" } }, "financial_fundamental_graph": { "description": "Returns a stock's income, balance-sheet and cash-flow history already shaped as chart cards, each naming its own chart type. Arguments schema: `#/components/schemas/TnapiFinancialFundamentalGraphInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_fundamental_graph" } }, "financial_insider_trades": { "description": "Lists SEC Form 4 insider transactions for a US stock. Arguments schema: `#/components/schemas/TnapiFinancialInsiderTradesInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_insider_trades" } }, "financial_institutional_ownership": { "description": "Lists the top 13F institutional holders of a US stock, with shares held and percent of shares outstanding. Arguments schema: `#/components/schemas/TnapiFinancialInstitutionalOwnershipInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_institutional_ownership" } }, "financial_metrics": { "description": "Computes 40+ derived financial ratios \u2014 margins, ROE/ROA, leverage, liquidity, per-share, YoY growth \u2014 from a company's statements. Arguments schema: `#/components/schemas/TnapiFinancialMetricsInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_metrics" } }, "financial_resolve_stock_ticker": { "description": "Fuzzy-matches free text to a US stock ticker. Arguments schema: `#/components/schemas/TnapiFinancialResolveStockTickerInput`.", "summary": "L3 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": { "query": "AAPL" }, "toolName": "financial_resolve_stock_ticker" } }, "financial_segmented_revenue": { "description": "Returns SEC-derived segmented revenue (by product/geography) for a US issuer's reporting periods. Arguments schema: `#/components/schemas/TnapiFinancialSegmentedRevenueInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_segmented_revenue" } }, "financial_statements": { "description": "Returns income, balance sheet, cash-flow, and key-stats statements for a stock. Arguments schema: `#/components/schemas/TnapiFinancialStatementsInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_statements" } }, "financial_stock_dividends": { "description": "Lists a US stock's historical dividend events. Arguments schema: `#/components/schemas/TnapiFinancialStockDividendsInput`.", "summary": "L1 \u00b7 US equities / SEC / fundamentals", "value": { "arguments": {}, "toolName": "financial_stock_dividends" } }, "hyperliquid_smart_money": { "description": "Analyzes what large, historically profitable Hyperliquid wallets are positioned in for a given token. Arguments schema: `#/components/schemas/TnapiHyperliquidSmartMoneyInput`.", "summary": "L1 \u00b7 Derivatives & positioning", "value": { "arguments": {}, "toolName": "hyperliquid_smart_money" } }, "kline_analysis": { "description": "Reads a token's price chart (candles) and summarizes the pattern in plain language. Arguments schema: `#/components/schemas/TnapiKlineAnalysisInput`.", "summary": "L2 \u00b7 Crypto market data & TA", "value": { "arguments": {}, "toolName": "kline_analysis" } }, "liquidation_risk": { "description": "Calculates how close a position sits to its exchange-computed liquidation price. Arguments schema: `#/components/schemas/TnapiLiquidationRiskInput`.", "summary": "L2 \u00b7 Derivatives & positioning", "value": { "arguments": { "current_price": 64000, "direction": "long", "liquidation_price": 58000, "token_address": "bitcoin" }, "toolName": "liquidation_risk" } }, "market_session": { "description": "Tells you whether a venue's market is currently open, and what the local time is there for the user. Arguments schema: `#/components/schemas/TnapiMarketSessionInput`.", "summary": "L2 \u00b7 Crypto market data & TA", "value": { "arguments": { "venue": "hyperliquid_perp" }, "toolName": "market_session" } }, "market_whale_positions": { "description": "Lists the largest Hyperliquid positions currently held by large wallets ('whales'), sourced through TrueNorth's market-data gateway. Arguments schema: `#/components/schemas/TnapiMarketWhalePositionsInput`.", "summary": "L1 \u00b7 Derivatives & positioning", "value": { "arguments": {}, "toolName": "market_whale_positions" } }, "mvrv": { "description": "Returns Bitcoin's MVRV Z-Score, a daily on-chain cycle-timing indicator. The same series behind the dashboard's MVRV Z-Score widget. Arguments schema: `#/components/schemas/TnapiMvrvInput`.", "summary": "L1 \u00b7 Sentiment / flows / on-chain cycle", "value": { "arguments": {}, "toolName": "mvrv" } }, "options_report": { "description": "Builds a full options-market picture for a token: max pain, gamma exposure, implied volatility, skew, and notable block trades. Arguments schema: `#/components/schemas/TnapiOptionsReportInput`.", "summary": "L1 \u00b7 Derivatives & positioning", "value": { "arguments": {}, "toolName": "options_report" } }, "performance_scanner": { "description": "Ranks a universe of tokens by relative strength against a benchmark and flags standouts from STRONG_BUY to UNDERPERFORMING. Arguments schema: `#/components/schemas/TnapiPerformanceScannerInput`.", "summary": "L1 \u00b7 Crypto market data & TA", "value": { "arguments": {}, "toolName": "performance_scanner" } }, "polymarket_insight": { "description": "Looks up live odds from prediction markets. Arguments schema: `#/components/schemas/TnapiPolymarketInsightInput`.", "summary": "L3 \u00b7 Sentiment / flows / on-chain cycle", "value": { "arguments": { "limit": 10, "query_type": "crypto_price", "search_terms": "bitcoin" }, "toolName": "polymarket_insight" } }, "resolve_asset": { "description": "Turns a free-text ticker or name into the canonical token address and best exchange to trade it on, across crypto, stocks, and more. Arguments schema: `#/components/schemas/TnapiResolveAssetInput`.", "summary": "L3 \u00b7 Crypto market data & TA", "value": { "arguments": { "query": "BTC" }, "toolName": "resolve_asset" } }, "technical_analysis": { "description": "Runs standard technical indicators (RSI, MACD, support/resistance) on a token and explains what they mean. Arguments schema: `#/components/schemas/TnapiTechnicalAnalysisInput`.", "summary": "L1 \u00b7 Crypto market data & TA", "value": { "arguments": {}, "toolName": "technical_analysis" } }, "trending_discovery": { "description": "Surfaces trending crypto tokens, mapped to a tradable exchange. Arguments schema: `#/components/schemas/TnapiTrendingDiscoveryInput`.", "summary": "L1 \u00b7 Crypto market data & TA", "value": { "arguments": {}, "toolName": "trending_discovery" } }, "venue_costs": { "description": "Looks up the latest fee, slippage, and funding-cadence config for one instrument on one venue. Arguments schema: `#/components/schemas/TnapiVenueCostsInput`.", "summary": "L2 \u00b7 Crypto market data & TA", "value": { "arguments": { "instrument": "BTC" }, "toolName": "venue_costs" } } }, "schema": { "properties": { "arguments": { "description": "Shape depends on `toolName`. See the matching example below, or the referenced `components.schemas.*Input`.", "type": "object" }, "toolName": { "description": "Which tool to call \u2014 pick one of the examples below for a worked request.", "enum": [ "coinbase_premium", "derivatives_analysis", "etf_flow", "event_v2", "fear_greed", "financial_analyst_estimates", "financial_company_facts", "financial_earnings_calendar", "financial_earnings_data", "financial_economic_calendar", "financial_fundamental_graph", "financial_insider_trades", "financial_institutional_ownership", "financial_metrics", "financial_resolve_stock_ticker", "financial_segmented_revenue", "financial_statements", "financial_stock_dividends", "hyperliquid_smart_money", "kline_analysis", "liquidation_risk", "market_session", "market_whale_positions", "mvrv", "options_report", "performance_scanner", "polymarket_insight", "resolve_asset", "technical_analysis", "trending_discovery", "venue_costs" ], "type": "string" } }, "required": [ "toolName", "arguments" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "examples": { "coinbase_premium": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 233, "isError": false, "result": { "items": [ { "binancePrice": 63450.0, "closeTime": 1785239999999, "coinbasePrice": 63393.51, "openTime": 1785236400000, "premiumGap": -56.48999999999796, "premiumIndex": -0.08903073286051688 }, { "binancePrice": 63546.65, "closeTime": 1785243599999, "coinbasePrice": 63470.34, "openTime": 1785240000000, "premiumGap": -76.31000000000495, "premiumIndex": -0.12008500841508551 }, "...truncated 498 more" ], "meta": { "count": 500, "dataFreshnessTs": 1787036399999, "interval": "1h", "latest": { "binancePrice": 64204.18, "closeTime": 1787032979999, "coinbasePrice": 64141.5, "openTime": 1787032920000, "premiumGap": -62.68000000000029, "premiumIndex": -0.0976260424165534 }, "unmatchedBinanceBuckets": 0, "unmatchedCoinbaseBuckets": 0 }, "status": "success" }, "toolName": "coinbase_premium" }, "failed": false, "message": null, "success": true } }, "derivatives_analysis": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 246, "isError": false, "result": { "derivative_data": { "BTC": { "1h Aggregated OI weighted funding rate": { "24h_funding_cost_est_in_percentage": 0.0092, "annualized_funding_cost_est_in_percentage": 3.36, "current_funding_percentile_7d": 19.6, "current_funding_rate_in_percentage": 0.003083, "flip_4h": false, "funding_changes_in_percentage": { "funding_change_1d_abs": -0.005376, "funding_change_1h_abs": -0.000159, "funding_change_4h_abs": -0.001334 } }, "Aggregated open interest": { "current_open_interest": 6789942821.979, "oi_mcap_ratio_analysis": { "oi_mcap_change_1d_abs": -0.022, "oi_mcap_change_1h_abs": -0.001, "oi_mcap_change_4h_abs": -0.004, "oi_mcap_ratio_pct": 0.527 }, "percentile_analysis": { "current_oi_percentile_7d": 0.4 }, "rolling_changes": { "oi_change_1d_abs": -276953904.0, "oi_change_1h_abs": -11521243.0, "oi_change_4h_abs": -53035965.0 } } }, "_metadata": { "data_fetch_ms": 223.13, "exchange_id": "binance_futures", "market_pair": "BTCUSDT", "request_time_ms": 235.11, "requested_exchange_id": "binance_futures", "symbol": "BTC", "symbol_resolve_ms": 11.97, "token_address": "bitcoin" }, "title": "Coinglass BTC Derivatives", "url": "https://www.coinglass.com/tv/Binance_BTCUSDT" }, "effective_exchange_id": "binance_futures", "included_sections": [ "funding", "open_interest" ], "requested_exchange_id": null, "requested_sections": null, "snapshot": { "funding": { "annualized": { "display": "+3.36% APR", "source_field": "derivative_data.BTC.1h Aggregated OI weighted funding rate.annualized_funding_cost_est_in_percentage", "unit": "percent", "value": 3.36 }, "current": { "display": "+0.003083%", "source_field": "derivative_data.BTC.1h Aggregated OI weighted funding rate.current_funding_rate_in_percentage", "unit": "percent", "value": 0.003083 }, "estimated_24h": { "display": "+0.0092%", "source_field": "derivative_data.BTC.1h Aggregated OI weighted funding rate.24h_funding_cost_est_in_percentage", "unit": "percent", "value": 0.0092 }, "payment_direction": { "display": "Longs pay shorts", "payer": "longs", "receiver": "shorts" }, "percentile_7d": 19.6, "period_hours": 8.0, "settlement_source": "venue_table", "source_label": "Funding Rate (binance_futures, 8h settlement)", "source_venue": "binance_futures" }, "open_interest": { "current_usd": 6789942821.979, "is_snapshot_only": false, "percentile_7d": 0.4, "snapshot_at": null, "source_field": "derivative_data.BTC.Aggregated open interest.current_open_interest" }, "symbol": "BTC" }, "status": "success" }, "toolName": "derivatives_analysis" }, "failed": false, "message": null, "success": true } }, "etf_flow": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 94, "isError": false, "result": { "items": [ { "date": 1742774400000, "flows": [ { "flowCoin": 0.0, "flowUsd": 0.0, "ticker": "GBTC" }, { "flowCoin": 209.97, "flowUsd": 18067347.72, "ticker": "IBIT" }, "...truncated 9 more" ], "netFlowCoin": 978.24, "netFlowUsd": 84173567.21 }, { "date": 1742860800000, "flows": [ { "flowCoin": 0.0, "flowUsd": 0.0, "ticker": "GBTC" }, { "flowCoin": 480.57, "flowUsd": 42032708.76, "ticker": "IBIT" }, "...truncated 9 more" ], "netFlowCoin": 306.81, "netFlowUsd": 26834350.91 }, "...truncated 363 more" ], "meta": { "asset": "btc", "count": 365, "dataFreshnessTs": 1786924800000, "latest": { "date": 1786924800000, "flows": [ { "flowCoin": 0.0, "flowUsd": 0.0, "ticker": "GBTC" }, { "flowCoin": 0.0, "flowUsd": 0.0, "ticker": "IBIT" }, "...truncated 9 more" ], "netFlowCoin": 2005.24, "netFlowUsd": 126081851.05 }, "refreshedAtTs": 1787030400408 }, "status": "success" }, "toolName": "etf_flow" }, "failed": false, "message": null, "success": true } }, "event_v2": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 82, "isError": false, "result": { "query": "", "results": [ { "event_count": 1, "event_type": "sec_filing", "final_rank_score": 45, "first_event_at": 1786959202929, "last_event_at": 1786959202929, "lead_event_uuid": "evt_c315935c79c91efdf490fdcbaa896ca3", "lead_published_at": 1786959202929, "preview": "Harvard University's 13F filing shows it held its Bitcoin ETF position steady in Q2, with 3.04 million shares of IBIT worth $101.35 million, while not adding any Ethereum ETF stake after liquidating i...", "published_at": 1786959202929, "publisher": "benzinga", "source": "benzinga", "source_url": "https://www.benzinga.com/crypto/cryptocurrency/26/08/61239930/harvard-university-did-not-sell-its-bitcoin-etf-holdings-in-q2-discloses-no-new-ethereum-etf-stake", "story_id": "story_01a00f11-b57d-7a80-b17d-df8968149e55", "title": "Harvard Did Not Sell Its Bitcoin ETF Holdings in Q2, Discloses No New Ethereum ETF Stake", "token_addresses": [ "bitcoin", "stock_ibit", "...truncated 6 more" ] }, { "event_count": 1, "event_type": "crypto_etf_flow", "final_rank_score": 55, "first_event_at": 1786968672976, "last_event_at": 1786968672976, "lead_event_uuid": "evt_732cc1bdfa6e77754eb44e1295fbb51a", "lead_published_at": 1786968672976, "preview": "U.S. spot Bitcoin ETFs saw their largest weekly outflow since June, with $389.7 million drained in the week of Aug. 10, reversing the prior week's $853.5 million inflow. Goldman Sachs economists see a...", "published_at": 1786968672976, "publisher": "benzinga", "source": "benzinga", "source_url": "https://www.benzinga.com/crypto/cryptocurrency/26/08/61243545/bitcoin-etfs-see-largest-outflow-in-six-weeks-whats-going-on", "story_id": "story_01a00fa2-314f-7733-ab20-3ca68a2951e3", "title": "Bitcoin ETFs See Largest Outflow in Six Weeks: What's Going On?", "token_addresses": [ "bitcoin", "stock_gs" ] }, "...truncated 3 more" ], "status": "success", "total_results": 5 }, "toolName": "event_v2" }, "failed": false, "message": null, "success": true } }, "fear_greed": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 192, "isError": false, "result": { "items": [ { "btcPrice": 117364.0, "date": 1755475200000, "value": 61 }, { "btcPrice": 116252.6, "date": 1755561600000, "value": 57 }, "...truncated 363 more" ], "meta": { "count": 365, "dataFreshnessTs": 1786924800000, "latest": { "btcPrice": 62740.3, "date": 1786924800000, "value": 30 } }, "status": "success" }, "toolName": "fear_greed" }, "failed": false, "message": null, "success": true } }, "financial_analyst_estimates": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 67, "isError": false, "result": { "analyst_estimates": [ { "ebitda_avg": 239767887874.0, "eps_avg": 12.85, "eps_high": 14.15557, "eps_low": 12.10216, "net_income_avg": 192810356462.0, "num_analysts_eps": 9, "num_analysts_revenue": 11, "period": "annual", "report_period": "2030-09-27", "revenue_avg": 664296666667.0, "revenue_high": 716214517708.0, "revenue_low": 634557856538.0 }, { "ebitda_avg": 174364789560.0, "eps_avg": 11.69995, "eps_high": 12.88868, "eps_low": 11.01904, "net_income_avg": 175554204676.0, "num_analysts_eps": 9, "num_analysts_revenue": 18, "period": "annual", "report_period": "2029-09-27", "revenue_avg": 483092000000.0, "revenue_high": 520847869860.0, "revenue_low": 461465244992.0 }, "...truncated 2 more" ], "period": "annual", "price_targets": { "target_high": 400.0, "target_low": 245.0, "target_mean": 337.43, "target_median": 355.0 }, "recommendation_distribution": { "buy": 69, "consensus_label": "Buy", "hold": 32, "sell": 9, "strong_buy": 1, "strong_sell": 0 }, "status": "success", "ticker": "AAPL" }, "toolName": "financial_analyst_estimates" }, "failed": false, "message": null, "success": true } }, "financial_company_facts": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 65, "isError": false, "result": { "company_facts": { "ceo": "Timothy D. Cook", "cik": "0000320193", "city": "CUPERTINO", "country": "US", "industry": "Consumer Electronics", "is_active": true, "name": "Apple Inc.", "sector": "Technology", "sic_code": "3571", "sic_description": "Electronic Computers", "state": "CA", "ticker": "AAPL", "website": "https://www.apple.com" }, "status": "success" }, "toolName": "financial_company_facts" }, "failed": false, "message": null, "success": true } }, "financial_earnings_calendar": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 401, "isError": false, "result": { "as_of": "2026-08-18T05:59:14.124156+00:00", "availability": "ready", "count": 30, "end_date": "2026-09-01", "events": [ { "company_name": "Walmart Inc.", "eps_actual": null, "eps_estimate_avg": 0.741, "eps_estimate_high": null, "eps_estimate_low": null, "event_date_end": null, "event_date_start": "2026-08-20", "revenue_estimate_avg": 186619700000, "revenue_estimate_high": null, "revenue_estimate_low": null, "symbol": "WMT" }, { "company_name": "NVIDIA Corporation", "eps_actual": null, "eps_estimate_avg": 2.08, "eps_estimate_high": null, "eps_estimate_low": null, "event_date_end": null, "event_date_start": "2026-08-26", "revenue_estimate_avg": 91932130000, "revenue_estimate_high": null, "revenue_estimate_low": null, "symbol": "NVDA" }, "...truncated 28 more" ], "limit": 30, "requested_tickers": null, "start_date": "2026-08-18", "status": "success" }, "toolName": "financial_earnings_calendar" }, "failed": false, "message": null, "success": true } }, "financial_earnings_data": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 63, "isError": false, "result": { "as_of": "2026-08-18T04:30:01.622182+00:00", "availability": "ready", "count": 30, "earnings": [ { "eps_actual": null, "eps_estimate": 1.98, "eps_surprise": null, "eps_surprise_pct": null, "fiscal_period": null, "report_period": "2026-10-29", "revenue_actual": null, "revenue_estimate": 113340900000 }, { "eps_actual": 2.02, "eps_estimate": 1.89, "eps_surprise": 0.13000000000000012, "eps_surprise_pct": 6.878306878306885, "fiscal_period": null, "report_period": "2026-07-30", "revenue_actual": 109417000000, "revenue_estimate": 109038900000 }, "...truncated 28 more" ], "limit": 30, "period": "quarterly", "status": "success", "ticker": "AAPL" }, "toolName": "financial_earnings_data" }, "failed": false, "message": null, "success": true } }, "financial_economic_calendar": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 1497, "isError": false, "result": { "as_of": "2026-08-18T06:03:40.547431", "availability": "ready", "count": 1001, "country": null, "end_date": "2026-09-01", "events": [ { "actual": 88.9, "change": 5.0, "change_percent": 5.959, "country": "AU", "currency": "AUD", "estimate": 81.7, "event": "Westpac Consumer Confidence Index (Aug)", "event_time": "2026-08-18T00:30:00", "impact": "medium", "observation_date": "2026-08-18", "previous": 83.9, "unit": null }, { "actual": 6.0, "change": 1.9, "change_percent": 46.341, "country": "AU", "currency": "AUD", "estimate": -2.6, "event": "Westpac Consumer Confidence Change (Aug)", "event_time": "2026-08-18T00:30:00", "impact": "high", "observation_date": "2026-08-18", "previous": 4.1, "unit": "%" }, "...truncated 999 more" ], "start_date": "2026-08-18", "status": "success" }, "toolName": "financial_economic_calendar" }, "failed": false, "message": null, "success": true } }, "financial_fundamental_graph": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "durationMs": 281, "isError": false, "result": { "chartTypes": [ { "label": "Bar", "type": "bar", "use": "Absolute per-period values such as revenue or cash flow." }, "...truncated 5 more" ], "charts": [ { "availableChartTypes": [ "bar", "...truncated 1 more" ], "chartType": "bar", "facts": { "calculatedInsights": [ "...truncated (depth limit, 2 items)" ], "latest": 416161000000.0, "latestFormatted": "$416.2B", "latestPeriod": "FY2025", "periodChangeFormatted": "+6.4%", "periodChangePct": 0.0642551178283274, "previousPeriod": "FY2024", "qoqChangeFormatted": null, "qoqChangePct": null, "threeYearCagrFormatted": "+1.8%", "threeYearCagrPct": 0.01812535743479393, "trend": "up", "yoyChangeFormatted": "+6.4%", "yoyChangePct": 0.0642551178283274 }, "label": "Revenue", "metric": "revenue", "period": "annual", "points": [ { "...": "6 more field(s) omitted from this documentation example" }, "...truncated 7 more" ], "source": "income", "unit": "currency" }, "...truncated 22 more" ], "factsForChat": { "availableMetrics": [ "revenue", "...truncated 22 more" ], "metricFacts": [ { "...": "1 more field(s) omitted from this documentation example", "calculatedInsights": [ "...truncated (depth limit, 2 items)" ], "chartType": "bar", "label": "Revenue", "latest": 416161000000.0, "latestFormatted": "$416.2B", "latestPeriod": "FY2025", "metric": "revenue", "metricKey": "revenue", "metricLabel": "Revenue", "periodChangeFormatted": "+6.4%", "periodChangePct": 0.0642551178283274, "previousPeriod": "FY2024", "qoqChangeFormatted": null, "qoqChangePct": null, "source": "income", "threeYearCagrFormatted": "+1.8%", "threeYearCagrPct": 0.01812535743479393, "unit": "currency", "yoyChangeFormatted": "+6.4%", "yoyChangePct": 0.0642551178283274 }, "...truncated 22 more" ], "missingMetrics": [], "period": "annual", "rawStatus": { "analyst_estimates": "success", "balance": "success", "cashflow": "success", "earnings_data": "success", "income": "success", "metrics": "success", "segmented_revenue": "success" }, "ticker": "AAPL" }, "html": "
80).\n\n**Good to know** \u2014 `limit` caps at 3000 days and returns newest-N in ascending order. No auth required; this is the same underlying series `/api/agent-tools/call` hits when you call the `fear_greed` tool, just without the tool-call envelope.\n\n**Tier:** L1", "operationId": "get_api_fear_greed", "parameters": [ { "description": "Max days returned (newest N, served ascending).", "in": "query", "name": "limit", "required": false, "schema": { "default": 365, "maximum": 3000, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "live": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "items": [ { "btcPrice": 117364.0, "date": 1755475200000, "value": 61 }, { "btcPrice": 116252.6, "date": 1755561600000, "value": 57 }, "...truncated 363 more" ], "meta": { "count": 365, "dataFreshnessTs": 1786924800000, "latest": { "btcPrice": 62740.3, "date": 1786924800000, "value": 30 } } }, "failed": false, "message": null, "success": true } } }, "schema": { "allOf": [ { "$ref": "#/components/schemas/StandardResponse" }, { "properties": { "data": { "properties": { "items": { "items": { "properties": { "btcPrice": { "type": "number" }, "date": { "type": "integer" }, "value": { "type": "integer" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "count": { "type": "integer" }, "dataFreshnessTs": { "type": "integer" }, "latest": { "properties": { "btcPrice": { "type": "number" }, "date": { "type": "integer" }, "value": { "type": "integer" } }, "type": "object" } }, "type": "object" } }, "type": "object", "x-tn-inferred-from-live-example": true } }, "type": "object" } ] } } }, "description": "Success." } }, "security": [], "summary": "Fear & Greed (plain REST)", "tags": [ "Sentiment / flows / on-chain cycle" ] } }, "/api/mvrv": { "get": { "description": "The plain-REST twin of the mvrv tool \u2014 same Bitcoin MVRV Z-Score series, no tool-call wrapper needed.\n**What you get** \u2014 the plain-REST twin of the `mvrv` tool: Bitcoin's daily MVRV Z-Score archive back to 2010.\n\n- `items[].mvrvRatio` \u2014 market cap \u00f7 realized cap (1.18 at the latest date in the captured example \u2014 market cap only slightly above realized/cost basis).\n- `items[].zScore` \u2014 the standardized MVRV Z-Score used to call cycle tops/bottoms; `null` on early dates where the rolling-stats window isn't full yet (seen on the very first archive row).\n- `items[].marketCap` / `.realizedCap` \u2014 the two raw series MVRV is derived from, in USD.\n- `meta.count` \u2014 5,835 days in the captured full-archive pull.\n\n**When to use it** \u2014 cycle-positioning context (Z-Score extremes have historically marked BTC tops/bottoms), or as a feature in a longer-horizon model.\n\n**Good to know** \u2014 `limit` defaults to and caps at the full archive (10000); no auth required. Anonymous callers are safe because the service holds one bounded cache entry behind a coalescing lock, regardless of the `limit` requested.\n\n**Tier:** L1", "operationId": "get_api_mvrv", "parameters": [ { "description": "Max days returned (newest N, served ascending). Default equals the max \u2014 the route returns the full archive unless limited.", "in": "query", "name": "limit", "required": false, "schema": { "default": 10000, "maximum": 10000, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "live": { "summary": "Captured 2026-08-18 from production", "value": { "code": null, "data": { "items": [ { "date": 1282089600000, "marketCap": 262209.5, "mvrvRatio": 1.333140370569158, "realizedCap": 196685.5897463032, "zScore": null }, { "date": 1282176000000, "marketCap": 255170.00000000003, "mvrvRatio": 1.2937318479487294, "realizedCap": 197235.61756988795, "zScore": 11.638836474234612 }, "...truncated 5833 more" ], "meta": { "count": 5835, "dataFreshnessTs": 1787024400307, "latest": { "date": 1786406400000, "marketCap": 1282608330751.338, "mvrvRatio": 1.183387043351774, "realizedCap": 1083845169639.9633, "zScore": 0.32633974213865347 } } }, "failed": false, "message": null, "success": true } } }, "schema": { "allOf": [ { "$ref": "#/components/schemas/StandardResponse" }, { "properties": { "data": { "properties": { "items": { "items": { "properties": { "date": { "type": "integer" }, "marketCap": { "type": "number" }, "mvrvRatio": { "type": "number" }, "realizedCap": { "type": "number" }, "zScore": { "type": "null" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "count": { "type": "integer" }, "dataFreshnessTs": { "type": "integer" }, "latest": { "properties": { "date": { "type": "integer" }, "marketCap": { "type": "number" }, "mvrvRatio": { "type": "number" }, "realizedCap": { "type": "number" }, "zScore": { "type": "number" } }, "type": "object" } }, "type": "object" } }, "type": "object", "x-tn-inferred-from-live-example": true } }, "type": "object" } ] } } }, "description": "Success." } }, "security": [], "summary": "MVRV (plain REST)", "tags": [ "Sentiment / flows / on-chain cycle" ] } } }, "servers": [ { "description": "Production.", "url": "https://tn-api.truenorth.xyz" } ], "tags": [ { "description": "Candles, technical indicators, and price/volume analysis across crypto markets.", "name": "Crypto market data & TA" }, { "description": "Funding rates, open interest, liquidations, order flow, and positioning across derivatives venues.", "name": "Derivatives & positioning" }, { "description": "News, curated content, and calendar/event data (economic, earnings, key events).", "name": "News & events" }, { "description": "Market-wide sentiment, exchange flows, and on-chain cycle indicators (fear & greed, MVRV, ETF flow, coinbase premium, and related).", "name": "Sentiment / flows / on-chain cycle" }, { "description": "US stock fundamentals, analyst estimates, SEC filings, earnings, and related company data.", "name": "US equities / SEC / fundamentals" }, { "description": "Transport and connection endpoints: the tool-RPC call/batch routes, and the MCP connection recipe.", "name": "Utility" } ] }