{"source":"terminalfeed","generated_at":"2026-05-01T08:58:55.008Z","docs":"https://terminalfeed.io/developers/agent-payments","contract":"https://terminalfeed.io/openapi.json","note":"Pre-baked function-calling tool definitions for AI agents. Paste the openai or anthropic block directly into your tool-use scaffold. Cross-redeemable on tensorfeed.ai.","cost":"free (this endpoint costs no credits; the tools listed have their own pricing)","bearer_format":"tf_live_<64-char-hex>","auth_flow":"POST /api/payment/buy-credits -> send USDC on Base -> POST /api/payment/confirm -> use returned bearer token on /api/pro/*","openai":[{"type":"function","function":{"name":"tf_briefing","description":"Fetches a real-time world-state snapshot composed from BTC ticker, Fear and Greed Index, recent earthquakes (USGS), top Hacker News story count, and ISS crew. Returns JSON. No auth required. Cache TTL 60s. Use when the agent needs a quick global pulse before deciding what to investigate.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_btc_price","description":"Fetches the current Bitcoin price in USD with 24h change, high, low, and volume. Source: Binance with CoinCap fallback. Cache TTL 15s. No auth required. Use for crypto trading decisions or when the agent needs a fresh BTC quote.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_fear_greed","description":"Fetches the current Crypto Fear and Greed Index value (0-100) with classification label (Extreme Fear, Fear, Neutral, Greed, Extreme Greed). Source: Alternative.me. Cache TTL 5min. Use as a sentiment signal for crypto trading decisions.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_crypto_movers","description":"Fetches the top 15 cryptocurrencies sorted by 24h price change. Includes price, market cap, and percentage move. Source: CoinGecko/CoinLore. Cache TTL 30s. Use when the agent needs to surface notable crypto market moves.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_predictions","description":"Fetches active Polymarket prediction markets sorted by 24h volume. Each market includes question, outcomes, and volume. Cache TTL 60s. Use when the agent needs market-implied probabilities on world events (elections, sports, macro).","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_earthquakes","description":"Fetches recent earthquakes magnitude 2.5 or greater from USGS. Returns count and most recent quake details (magnitude, place, time). Cache TTL 2min. Use for disaster monitoring or when the agent needs current seismic activity.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_service_status","description":"Fetches operational status of major dev infrastructure (GitHub, Cloudflare, Discord, OpenAI, Vercel, npm, Reddit, Atlassian, Anthropic). Cache TTL 60s. Use when the agent needs to know if a dependency is up or to explain a recent outage.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_economic_data","description":"Fetches latest FRED economic indicators: Fed funds rate, CPI, unemployment rate, GDP growth. Cache TTL 1h. Use when the agent needs current US macro indicators. For deeper macro (treasury yields, forex, commodities, indices) use tf_premium_macro.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_forex","description":"Fetches current foreign exchange rates with USD as base for 16 major currencies (EUR, GBP, JPY, CAD, AUD, CHF, CNY, INR, MXN, BRL, KRW, SGD, HKD, SEK, NOK, NZD). Source: Frankfurter (ECB-based). Cache TTL 5min. Use for currency conversion or FX-aware decisions.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_hf_trending","description":"Fetches the top 15 trending HuggingFace models sorted by likes in the last 7 days. Each item includes id (author/name), likes, downloads, pipeline tag, and url. Source: huggingface.co/api/models. Cache TTL 10min. Use when the agent needs to surface what the open-source AI community is paying attention to right now.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_harnesses","description":"Returns a snapshot of public agentic-coding benchmark scores across SWE-bench Verified, Terminal-Bench, Aider Polyglot, and METR HCAST. Each row pairs a harness with a model. Same model can score very differently on different harnesses; that gap is the value-add. Pass ?view=summary for top 10 combined leaderboard plus biggest harness gaps; ?view=gaps for full per-model harness deltas; ?view=combined for normalized cross-benchmark ranking; ?view=raw (default) for the full benchmark/result graph. Source: hand-curated from upstream leaderboards (swebench.com, terminal-bench.org, aider.chat, metr.org). Cache TTL 12h. Use when the agent needs to recommend a harness/model combo or explain why two agents using the same model perform differently.","parameters":{"type":"object","properties":{"view":{"type":"string","enum":["raw","summary","gaps","combined"],"description":"Output shape; default raw"}},"required":[]}}},{"type":"function","function":{"name":"tf_solana_network","description":"Fetches live Solana mainnet network metrics: current transactions-per-second (most recent 60s sample), 3-sample average TPS, current slot, average slot time in ms, and epoch progress percentage. Source: solana-rpc.publicnode.com (getRecentPerformanceSamples + getSlot + getEpochInfo). Cache TTL 30s. Use when the agent needs to assess Solana network throughput or congestion.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_briefing","description":"Premium version of tf_briefing. Adds Polymarket prediction markets to the standard briefing payload, supports section filtering via ?include=, and supports ?history=24h for hourly BTC chart. Costs 1 credit ($0.02 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Use when the agent needs prediction-market context or recent BTC trajectory in addition to the basic snapshot.","parameters":{"type":"object","properties":{"include":{"type":"string","description":"Comma-separated subset of sections: btc, fear-greed, earthquakes, hackernews, humans-in-space, predictions. Omit for all sections."},"history":{"type":"string","enum":["24h"],"description":"When set to 24h, response includes a series.btc_24h hourly array (24 data points)."}},"required":[]}}},{"type":"function","function":{"name":"tf_premium_macro","description":"Premium composed macroeconomic snapshot in one HTTP call. Includes 7 FRED economic series (Fed rate, CPI, unemployment, GDP growth, 10-year treasury), 4 USD-base forex pairs (EUR, JPY, GBP, CHF), gold via PAXG/Kraken, US market context (SPY, DIA, QQQ, VIX), and oil/natural gas via FRED. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?history=30d adds 30-day historical series. Use this instead of calling 14 different upstream APIs separately.","parameters":{"type":"object","properties":{"history":{"type":"string","enum":["30d"],"description":"When set to 30d, FRED entries include a series array of 30 daily observations and forex.series is populated."}},"required":[]}}},{"type":"function","function":{"name":"tf_premium_crypto_deep","description":"Premium deep crypto snapshot. Includes top 50 coins by market cap with 1h/24h/7d change, Binance live ticker for top 20 USDT pairs by volume, Bitcoin network statistics from mempool.space (block height, fee tiers, hashrate, mempool size), and Ethereum gas oracle from Etherscan. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?coins= filter and ?history=30d for daily BTC OHLCV. Use this instead of calling CoinGecko + Binance + mempool.space + Etherscan separately.","parameters":{"type":"object","properties":{"coins":{"type":"string","description":"Comma-separated symbol filter, e.g. btc,eth,sol. Omit to get all top 50."},"history":{"type":"string","enum":["30d"],"description":"When set to 30d, response includes series.btc_30d with daily OHLCV candles."}},"required":[]}}},{"type":"function","function":{"name":"tf_premium_github_velocity","description":"Composed GitHub developer-attention snapshot. Returns top 30 repos created in the last 7 days sorted by stars (with stars-per-day, language, topics, license, owner type, AI/ML focus flag), top 15 AI/ML-focused active repos (topic:llm with commits in the last 30 days), language and topic aggregates, and the AI/ML share of trending. Source: GitHub Search API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_stablecoin_flows","description":"Composed stablecoin flow snapshot for crypto traders. Returns top 20 stablecoins by circulating supply, each with 24h/7d/30d net change in USD and percent, top chains breakdown, peg type, and current price. Aggregate includes total circulating, net inflow/outflow over 24h and 7d, growing-vs-shrinking count, and a bias label (growing / shrinking / balanced). Source: DefiLlama stablecoins API. Trading agents use stablecoin growth as a leading indicator for crypto buying power. Costs 2 credits ($0.04 USDC). 1-hour cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_defi_tvl","description":"Composed DeFi total-value-locked snapshot for crypto research and trading agents. Returns top 50 protocols by TVL (each with 1h/24h/7d change, category, chain, market cap, FDV), top 15 chains by TVL, by-category aggregate, and biggest gainers/losers over 24h and 7d windows. Source: DefiLlama free public API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_exchange_flows","description":"Tracks ETH transfers in/out of major centralized exchange hot wallets (Binance, Coinbase, OKX, Kraken, Bybit, Crypto.com, KuCoin) in the last 3 blocks. Each transfer tagged as inflow (user -> exchange, often precedes selling), outflow (exchange -> user, often HODL withdrawal), or inter_exchange. Aggregated per-exchange and globally with net_eth, net_usd, and bias label (inflow_dominant / outflow_dominant / balanced). Threshold 5 ETH minimum (~$11K at $2300/ETH) to filter retail noise. Useful for trading bots detecting regime shifts: sustained large net inflow signals selling pressure ahead, sustained outflow signals accumulation. Pair with tf_premium_whales for context. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required. v1 covers ETH only; BTC requires a labeled-address dataset.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_whales","description":"Tracks whale-sized on-chain transactions on Bitcoin and Ethereum. BTC: scans the last 30 unconfirmed mempool transactions via mempool.space and surfaces any with output >=50 BTC; tagged with USD-equivalent at current BTC spot. ETH: scans the latest confirmed block via Etherscan eth_getBlockByNumber and surfaces transfers >=100 ETH; tagged with USD-equivalent at current ETH spot. Each whale entry includes tx_hash, value in native and USD units, from/to addresses (ETH only), and explorer URL. Useful for trading bots watching for institutional flow signals (large exchange in/outflows, treasury moves, OTC settlements). Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_correlation_matrix","description":"Pre-computed cross-asset correlation matrix for AI trading and portfolio agents. Returns 30-day Pearson correlations on daily simple returns for 6 assets: BTC, ETH, SOL (Coinbase candles), and SPY, QQQ, GLD (Stooq.com CSVs). Output includes both a pairs array (sorted by absolute r descending) and an NxN matrix object for easy lookup. Each pair tagged with relationship strength (negligible / weak / moderate / strong) and direction (positive / negative). Saves the agent from fetching 6 historical price series and running the covariance math. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_agent_context","description":"The \"always start here\" premium call for autonomous agents. Composes 13 upstream sources into a curated world-state snapshot: BTC ticker, Fear and Greed, VIX, Fed funds rate, USD-base forex (EUR/JPY/GBP/CHF), HN front page top 5, significant earthquakes 24h, upcoming space launches, top Polymarket markets, and infrastructure status (GitHub, Cloudflare, OpenAI, Anthropic). Returns BOTH a structured JSON `context` object for parsers AND a pre-formatted `system_prompt` string (~350 tokens) the agent pastes verbatim into its LLM context. Saves the agent from making 13 separate calls and writing a formatter. Curation choice (which signals matter, how to compress them) is the moat. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_premium_world_deltas","description":"Premium event-stream endpoint for monitor agents. Aggregates time-stamped events from 4 sources into one time-sorted feed: USGS earthquakes M4.0+, Hacker News new stories via Algolia, recently updated Polymarket markets, and space launches in [-1h, +12h] window. Accepts ?since=<ISO timestamp> (defaults 1h ago, clamped to 1h cache horizon). Each event has type, timestamp, severity, and structured data. Saves an agent from polling 5 separate upstream feeds and merging client-side. Costs 2 credits ($0.04 USDC). Bearer auth required. 1-hour rolling cache; sub-second when warm.","parameters":{"type":"object","properties":{"since":{"type":"string","description":"ISO 8601 timestamp. Returns events newer than this. Defaults to 1 hour ago. Clamped to 1 hour ago if older."}},"required":[]}}},{"type":"function","function":{"name":"tf_premium_sentiment","description":"Premium composite sentiment snapshot. Aggregates Crypto Fear and Greed Index (alternative.me), VIX volatility index (Finnhub), trending ticker mentions across Hacker News top 30 + Reddit r/CryptoCurrency / r/wallstreetbets / r/stocks hot posts with per-headline keyword-based sentiment scoring, and top Polymarket prediction-market signals. Output includes per-ticker mention_count_24h, sentiment_score (-1 to +1), sentiment_label, and sample headlines. Use to gauge market mood before a trading or research decision. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. The notes field documents that scoring is keyword-based (crude but signal-bearing), not LLM-derived; treat as one input to a broader analysis.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_payment_buy_credits","description":"POST endpoint that returns the published USDC wallet address (0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1 on Base mainnet), a unique memo, and a quote tying the dollar amount to credits at $1 USDC = 50 credits. Use as the first step when the agent needs to buy credits to access /api/pro/* endpoints.","parameters":{"type":"object","properties":{"amount_usd":{"type":"number","description":"USDC amount to convert. Minimum $1 = 50 credits."}},"required":[]}}},{"type":"function","function":{"name":"tf_payment_confirm","description":"POST endpoint that verifies an on-chain Base mainnet USDC transfer to the published wallet and returns a bearer token (tf_live_<64-char-hex>) plus credit count. Use after the agent has sent USDC, with the tx hash and the memo from tf_payment_buy_credits. The returned token is cross-redeemable on tensorfeed.ai.","parameters":{"type":"object","properties":{"tx_hash":{"type":"string","description":"On-chain Base mainnet USDC transaction hash."},"nonce":{"type":"string","description":"The memo string returned from tf_payment_buy_credits (optional but recommended)."}},"required":[]}}},{"type":"function","function":{"name":"tf_payment_balance","description":"GET endpoint that returns remaining credits for the bearer token in the Authorization header. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Use to monitor agent budget.","parameters":{"type":"object","properties":{},"required":[]}}},{"type":"function","function":{"name":"tf_payment_history","description":"GET endpoint that returns confirmed USDC purchases (tx_hash, amount_usd, credits_added, block_number, confirmed_at) plus current balance and totals for the bearer token. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Tokens minted before the ledger existed return current_balance with purchases: [].","parameters":{"type":"object","properties":{},"required":[]}}}],"anthropic":[{"name":"tf_briefing","description":"Fetches a real-time world-state snapshot composed from BTC ticker, Fear and Greed Index, recent earthquakes (USGS), top Hacker News story count, and ISS crew. Returns JSON. No auth required. Cache TTL 60s. Use when the agent needs a quick global pulse before deciding what to investigate.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_btc_price","description":"Fetches the current Bitcoin price in USD with 24h change, high, low, and volume. Source: Binance with CoinCap fallback. Cache TTL 15s. No auth required. Use for crypto trading decisions or when the agent needs a fresh BTC quote.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_fear_greed","description":"Fetches the current Crypto Fear and Greed Index value (0-100) with classification label (Extreme Fear, Fear, Neutral, Greed, Extreme Greed). Source: Alternative.me. Cache TTL 5min. Use as a sentiment signal for crypto trading decisions.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_crypto_movers","description":"Fetches the top 15 cryptocurrencies sorted by 24h price change. Includes price, market cap, and percentage move. Source: CoinGecko/CoinLore. Cache TTL 30s. Use when the agent needs to surface notable crypto market moves.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_predictions","description":"Fetches active Polymarket prediction markets sorted by 24h volume. Each market includes question, outcomes, and volume. Cache TTL 60s. Use when the agent needs market-implied probabilities on world events (elections, sports, macro).","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_earthquakes","description":"Fetches recent earthquakes magnitude 2.5 or greater from USGS. Returns count and most recent quake details (magnitude, place, time). Cache TTL 2min. Use for disaster monitoring or when the agent needs current seismic activity.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_service_status","description":"Fetches operational status of major dev infrastructure (GitHub, Cloudflare, Discord, OpenAI, Vercel, npm, Reddit, Atlassian, Anthropic). Cache TTL 60s. Use when the agent needs to know if a dependency is up or to explain a recent outage.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_economic_data","description":"Fetches latest FRED economic indicators: Fed funds rate, CPI, unemployment rate, GDP growth. Cache TTL 1h. Use when the agent needs current US macro indicators. For deeper macro (treasury yields, forex, commodities, indices) use tf_premium_macro.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_forex","description":"Fetches current foreign exchange rates with USD as base for 16 major currencies (EUR, GBP, JPY, CAD, AUD, CHF, CNY, INR, MXN, BRL, KRW, SGD, HKD, SEK, NOK, NZD). Source: Frankfurter (ECB-based). Cache TTL 5min. Use for currency conversion or FX-aware decisions.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_hf_trending","description":"Fetches the top 15 trending HuggingFace models sorted by likes in the last 7 days. Each item includes id (author/name), likes, downloads, pipeline tag, and url. Source: huggingface.co/api/models. Cache TTL 10min. Use when the agent needs to surface what the open-source AI community is paying attention to right now.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_harnesses","description":"Returns a snapshot of public agentic-coding benchmark scores across SWE-bench Verified, Terminal-Bench, Aider Polyglot, and METR HCAST. Each row pairs a harness with a model. Same model can score very differently on different harnesses; that gap is the value-add. Pass ?view=summary for top 10 combined leaderboard plus biggest harness gaps; ?view=gaps for full per-model harness deltas; ?view=combined for normalized cross-benchmark ranking; ?view=raw (default) for the full benchmark/result graph. Source: hand-curated from upstream leaderboards (swebench.com, terminal-bench.org, aider.chat, metr.org). Cache TTL 12h. Use when the agent needs to recommend a harness/model combo or explain why two agents using the same model perform differently.","input_schema":{"type":"object","properties":{"view":{"type":"string","enum":["raw","summary","gaps","combined"],"description":"Output shape; default raw"}},"required":[]}},{"name":"tf_solana_network","description":"Fetches live Solana mainnet network metrics: current transactions-per-second (most recent 60s sample), 3-sample average TPS, current slot, average slot time in ms, and epoch progress percentage. Source: solana-rpc.publicnode.com (getRecentPerformanceSamples + getSlot + getEpochInfo). Cache TTL 30s. Use when the agent needs to assess Solana network throughput or congestion.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_briefing","description":"Premium version of tf_briefing. Adds Polymarket prediction markets to the standard briefing payload, supports section filtering via ?include=, and supports ?history=24h for hourly BTC chart. Costs 1 credit ($0.02 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Use when the agent needs prediction-market context or recent BTC trajectory in addition to the basic snapshot.","input_schema":{"type":"object","properties":{"include":{"type":"string","description":"Comma-separated subset of sections: btc, fear-greed, earthquakes, hackernews, humans-in-space, predictions. Omit for all sections."},"history":{"type":"string","enum":["24h"],"description":"When set to 24h, response includes a series.btc_24h hourly array (24 data points)."}},"required":[]}},{"name":"tf_premium_macro","description":"Premium composed macroeconomic snapshot in one HTTP call. Includes 7 FRED economic series (Fed rate, CPI, unemployment, GDP growth, 10-year treasury), 4 USD-base forex pairs (EUR, JPY, GBP, CHF), gold via PAXG/Kraken, US market context (SPY, DIA, QQQ, VIX), and oil/natural gas via FRED. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?history=30d adds 30-day historical series. Use this instead of calling 14 different upstream APIs separately.","input_schema":{"type":"object","properties":{"history":{"type":"string","enum":["30d"],"description":"When set to 30d, FRED entries include a series array of 30 daily observations and forex.series is populated."}},"required":[]}},{"name":"tf_premium_crypto_deep","description":"Premium deep crypto snapshot. Includes top 50 coins by market cap with 1h/24h/7d change, Binance live ticker for top 20 USDT pairs by volume, Bitcoin network statistics from mempool.space (block height, fee tiers, hashrate, mempool size), and Ethereum gas oracle from Etherscan. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?coins= filter and ?history=30d for daily BTC OHLCV. Use this instead of calling CoinGecko + Binance + mempool.space + Etherscan separately.","input_schema":{"type":"object","properties":{"coins":{"type":"string","description":"Comma-separated symbol filter, e.g. btc,eth,sol. Omit to get all top 50."},"history":{"type":"string","enum":["30d"],"description":"When set to 30d, response includes series.btc_30d with daily OHLCV candles."}},"required":[]}},{"name":"tf_premium_github_velocity","description":"Composed GitHub developer-attention snapshot. Returns top 30 repos created in the last 7 days sorted by stars (with stars-per-day, language, topics, license, owner type, AI/ML focus flag), top 15 AI/ML-focused active repos (topic:llm with commits in the last 30 days), language and topic aggregates, and the AI/ML share of trending. Source: GitHub Search API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_stablecoin_flows","description":"Composed stablecoin flow snapshot for crypto traders. Returns top 20 stablecoins by circulating supply, each with 24h/7d/30d net change in USD and percent, top chains breakdown, peg type, and current price. Aggregate includes total circulating, net inflow/outflow over 24h and 7d, growing-vs-shrinking count, and a bias label (growing / shrinking / balanced). Source: DefiLlama stablecoins API. Trading agents use stablecoin growth as a leading indicator for crypto buying power. Costs 2 credits ($0.04 USDC). 1-hour cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_defi_tvl","description":"Composed DeFi total-value-locked snapshot for crypto research and trading agents. Returns top 50 protocols by TVL (each with 1h/24h/7d change, category, chain, market cap, FDV), top 15 chains by TVL, by-category aggregate, and biggest gainers/losers over 24h and 7d windows. Source: DefiLlama free public API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_exchange_flows","description":"Tracks ETH transfers in/out of major centralized exchange hot wallets (Binance, Coinbase, OKX, Kraken, Bybit, Crypto.com, KuCoin) in the last 3 blocks. Each transfer tagged as inflow (user -> exchange, often precedes selling), outflow (exchange -> user, often HODL withdrawal), or inter_exchange. Aggregated per-exchange and globally with net_eth, net_usd, and bias label (inflow_dominant / outflow_dominant / balanced). Threshold 5 ETH minimum (~$11K at $2300/ETH) to filter retail noise. Useful for trading bots detecting regime shifts: sustained large net inflow signals selling pressure ahead, sustained outflow signals accumulation. Pair with tf_premium_whales for context. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required. v1 covers ETH only; BTC requires a labeled-address dataset.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_whales","description":"Tracks whale-sized on-chain transactions on Bitcoin and Ethereum. BTC: scans the last 30 unconfirmed mempool transactions via mempool.space and surfaces any with output >=50 BTC; tagged with USD-equivalent at current BTC spot. ETH: scans the latest confirmed block via Etherscan eth_getBlockByNumber and surfaces transfers >=100 ETH; tagged with USD-equivalent at current ETH spot. Each whale entry includes tx_hash, value in native and USD units, from/to addresses (ETH only), and explorer URL. Useful for trading bots watching for institutional flow signals (large exchange in/outflows, treasury moves, OTC settlements). Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_correlation_matrix","description":"Pre-computed cross-asset correlation matrix for AI trading and portfolio agents. Returns 30-day Pearson correlations on daily simple returns for 6 assets: BTC, ETH, SOL (Coinbase candles), and SPY, QQQ, GLD (Stooq.com CSVs). Output includes both a pairs array (sorted by absolute r descending) and an NxN matrix object for easy lookup. Each pair tagged with relationship strength (negligible / weak / moderate / strong) and direction (positive / negative). Saves the agent from fetching 6 historical price series and running the covariance math. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_agent_context","description":"The \"always start here\" premium call for autonomous agents. Composes 13 upstream sources into a curated world-state snapshot: BTC ticker, Fear and Greed, VIX, Fed funds rate, USD-base forex (EUR/JPY/GBP/CHF), HN front page top 5, significant earthquakes 24h, upcoming space launches, top Polymarket markets, and infrastructure status (GitHub, Cloudflare, OpenAI, Anthropic). Returns BOTH a structured JSON `context` object for parsers AND a pre-formatted `system_prompt` string (~350 tokens) the agent pastes verbatim into its LLM context. Saves the agent from making 13 separate calls and writing a formatter. Curation choice (which signals matter, how to compress them) is the moat. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_premium_world_deltas","description":"Premium event-stream endpoint for monitor agents. Aggregates time-stamped events from 4 sources into one time-sorted feed: USGS earthquakes M4.0+, Hacker News new stories via Algolia, recently updated Polymarket markets, and space launches in [-1h, +12h] window. Accepts ?since=<ISO timestamp> (defaults 1h ago, clamped to 1h cache horizon). Each event has type, timestamp, severity, and structured data. Saves an agent from polling 5 separate upstream feeds and merging client-side. Costs 2 credits ($0.04 USDC). Bearer auth required. 1-hour rolling cache; sub-second when warm.","input_schema":{"type":"object","properties":{"since":{"type":"string","description":"ISO 8601 timestamp. Returns events newer than this. Defaults to 1 hour ago. Clamped to 1 hour ago if older."}},"required":[]}},{"name":"tf_premium_sentiment","description":"Premium composite sentiment snapshot. Aggregates Crypto Fear and Greed Index (alternative.me), VIX volatility index (Finnhub), trending ticker mentions across Hacker News top 30 + Reddit r/CryptoCurrency / r/wallstreetbets / r/stocks hot posts with per-headline keyword-based sentiment scoring, and top Polymarket prediction-market signals. Output includes per-ticker mention_count_24h, sentiment_score (-1 to +1), sentiment_label, and sample headlines. Use to gauge market mood before a trading or research decision. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. The notes field documents that scoring is keyword-based (crude but signal-bearing), not LLM-derived; treat as one input to a broader analysis.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_payment_buy_credits","description":"POST endpoint that returns the published USDC wallet address (0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1 on Base mainnet), a unique memo, and a quote tying the dollar amount to credits at $1 USDC = 50 credits. Use as the first step when the agent needs to buy credits to access /api/pro/* endpoints.","input_schema":{"type":"object","properties":{"amount_usd":{"type":"number","description":"USDC amount to convert. Minimum $1 = 50 credits."}},"required":[]}},{"name":"tf_payment_confirm","description":"POST endpoint that verifies an on-chain Base mainnet USDC transfer to the published wallet and returns a bearer token (tf_live_<64-char-hex>) plus credit count. Use after the agent has sent USDC, with the tx hash and the memo from tf_payment_buy_credits. The returned token is cross-redeemable on tensorfeed.ai.","input_schema":{"type":"object","properties":{"tx_hash":{"type":"string","description":"On-chain Base mainnet USDC transaction hash."},"nonce":{"type":"string","description":"The memo string returned from tf_payment_buy_credits (optional but recommended)."}},"required":[]}},{"name":"tf_payment_balance","description":"GET endpoint that returns remaining credits for the bearer token in the Authorization header. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Use to monitor agent budget.","input_schema":{"type":"object","properties":{},"required":[]}},{"name":"tf_payment_history","description":"GET endpoint that returns confirmed USDC purchases (tx_hash, amount_usd, credits_added, block_number, confirmed_at) plus current balance and totals for the bearer token. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Tokens minted before the ledger existed return current_balance with purchases: [].","input_schema":{"type":"object","properties":{},"required":[]}}],"raw":[{"name":"tf_briefing","short_description":"One-call world snapshot from TerminalFeed.","description":"Fetches a real-time world-state snapshot composed from BTC ticker, Fear and Greed Index, recent earthquakes (USGS), top Hacker News story count, and ISS crew. Returns JSON. No auth required. Cache TTL 60s. Use when the agent needs a quick global pulse before deciding what to investigate.","url":"https://terminalfeed.io/api/briefing","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_btc_price","short_description":"Live Bitcoin price ticker.","description":"Fetches the current Bitcoin price in USD with 24h change, high, low, and volume. Source: Binance with CoinCap fallback. Cache TTL 15s. No auth required. Use for crypto trading decisions or when the agent needs a fresh BTC quote.","url":"https://terminalfeed.io/api/btc-price","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_fear_greed","short_description":"Crypto Fear and Greed Index 0-100.","description":"Fetches the current Crypto Fear and Greed Index value (0-100) with classification label (Extreme Fear, Fear, Neutral, Greed, Extreme Greed). Source: Alternative.me. Cache TTL 5min. Use as a sentiment signal for crypto trading decisions.","url":"https://terminalfeed.io/api/fear-greed","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_crypto_movers","short_description":"Top 15 crypto by 24h change.","description":"Fetches the top 15 cryptocurrencies sorted by 24h price change. Includes price, market cap, and percentage move. Source: CoinGecko/CoinLore. Cache TTL 30s. Use when the agent needs to surface notable crypto market moves.","url":"https://terminalfeed.io/api/crypto-movers","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_predictions","short_description":"Active Polymarket prediction markets.","description":"Fetches active Polymarket prediction markets sorted by 24h volume. Each market includes question, outcomes, and volume. Cache TTL 60s. Use when the agent needs market-implied probabilities on world events (elections, sports, macro).","url":"https://terminalfeed.io/api/predictions","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_earthquakes","short_description":"Recent global earthquakes M2.5+.","description":"Fetches recent earthquakes magnitude 2.5 or greater from USGS. Returns count and most recent quake details (magnitude, place, time). Cache TTL 2min. Use for disaster monitoring or when the agent needs current seismic activity.","url":"https://terminalfeed.io/api/earthquake","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_service_status","short_description":"Status of GitHub, Cloudflare, OpenAI, Anthropic, etc.","description":"Fetches operational status of major dev infrastructure (GitHub, Cloudflare, Discord, OpenAI, Vercel, npm, Reddit, Atlassian, Anthropic). Cache TTL 60s. Use when the agent needs to know if a dependency is up or to explain a recent outage.","url":"https://terminalfeed.io/api/service-status","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_economic_data","short_description":"Free FRED indicators (Fed rate, CPI, unemployment, GDP).","description":"Fetches latest FRED economic indicators: Fed funds rate, CPI, unemployment rate, GDP growth. Cache TTL 1h. Use when the agent needs current US macro indicators. For deeper macro (treasury yields, forex, commodities, indices) use tf_premium_macro.","url":"https://terminalfeed.io/api/economic-data","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_forex","short_description":"USD-base currency exchange rates.","description":"Fetches current foreign exchange rates with USD as base for 16 major currencies (EUR, GBP, JPY, CAD, AUD, CHF, CNY, INR, MXN, BRL, KRW, SGD, HKD, SEK, NOK, NZD). Source: Frankfurter (ECB-based). Cache TTL 5min. Use for currency conversion or FX-aware decisions.","url":"https://terminalfeed.io/api/forex","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_hf_trending","short_description":"Trending HuggingFace models (top 15 by 7-day likes).","description":"Fetches the top 15 trending HuggingFace models sorted by likes in the last 7 days. Each item includes id (author/name), likes, downloads, pipeline tag, and url. Source: huggingface.co/api/models. Cache TTL 10min. Use when the agent needs to surface what the open-source AI community is paying attention to right now.","url":"https://terminalfeed.io/api/hf-trending","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_harnesses","short_description":"Agentic-coding harness leaderboards (Claude Code, Cursor, Codex, Aider, OpenHands, Devin, SWE-Agent).","description":"Returns a snapshot of public agentic-coding benchmark scores across SWE-bench Verified, Terminal-Bench, Aider Polyglot, and METR HCAST. Each row pairs a harness with a model. Same model can score very differently on different harnesses; that gap is the value-add. Pass ?view=summary for top 10 combined leaderboard plus biggest harness gaps; ?view=gaps for full per-model harness deltas; ?view=combined for normalized cross-benchmark ranking; ?view=raw (default) for the full benchmark/result graph. Source: hand-curated from upstream leaderboards (swebench.com, terminal-bench.org, aider.chat, metr.org). Cache TTL 12h. Use when the agent needs to recommend a harness/model combo or explain why two agents using the same model perform differently.","url":"https://terminalfeed.io/api/harnesses","method":"GET","auth":"none","tier":"free","parameters":{"view":{"type":"string","enum":["raw","summary","gaps","combined"],"description":"Output shape; default raw"}}},{"name":"tf_solana_network","short_description":"Live Solana network health (TPS, slot, epoch).","description":"Fetches live Solana mainnet network metrics: current transactions-per-second (most recent 60s sample), 3-sample average TPS, current slot, average slot time in ms, and epoch progress percentage. Source: solana-rpc.publicnode.com (getRecentPerformanceSamples + getSlot + getEpochInfo). Cache TTL 30s. Use when the agent needs to assess Solana network throughput or congestion.","url":"https://terminalfeed.io/api/solana-network","method":"GET","auth":"none","tier":"free","parameters":{}},{"name":"tf_premium_briefing","short_description":"Composed world briefing including prediction markets (1 credit).","description":"Premium version of tf_briefing. Adds Polymarket prediction markets to the standard briefing payload, supports section filtering via ?include=, and supports ?history=24h for hourly BTC chart. Costs 1 credit ($0.02 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Use when the agent needs prediction-market context or recent BTC trajectory in addition to the basic snapshot.","url":"https://terminalfeed.io/api/pro/briefing","method":"GET","auth":"bearer","tier":"premium","cost_credits":1,"parameters":{"include":{"type":"string","description":"Comma-separated subset of sections: btc, fear-greed, earthquakes, hackernews, humans-in-space, predictions. Omit for all sections."},"history":{"type":"string","enum":["24h"],"description":"When set to 24h, response includes a series.btc_24h hourly array (24 data points)."}}},{"name":"tf_premium_macro","short_description":"Composed macro snapshot: FRED + forex + commodities + indices (2 credits).","description":"Premium composed macroeconomic snapshot in one HTTP call. Includes 7 FRED economic series (Fed rate, CPI, unemployment, GDP growth, 10-year treasury), 4 USD-base forex pairs (EUR, JPY, GBP, CHF), gold via PAXG/Kraken, US market context (SPY, DIA, QQQ, VIX), and oil/natural gas via FRED. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?history=30d adds 30-day historical series. Use this instead of calling 14 different upstream APIs separately.","url":"https://terminalfeed.io/api/pro/macro","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{"history":{"type":"string","enum":["30d"],"description":"When set to 30d, FRED entries include a series array of 30 daily observations and forex.series is populated."}}},{"name":"tf_premium_crypto_deep","short_description":"Top 50 coins + Binance + on-chain BTC + ETH gas (2 credits).","description":"Premium deep crypto snapshot. Includes top 50 coins by market cap with 1h/24h/7d change, Binance live ticker for top 20 USDT pairs by volume, Bitcoin network statistics from mempool.space (block height, fee tiers, hashrate, mempool size), and Ethereum gas oracle from Etherscan. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. Optional ?coins= filter and ?history=30d for daily BTC OHLCV. Use this instead of calling CoinGecko + Binance + mempool.space + Etherscan separately.","url":"https://terminalfeed.io/api/pro/crypto-deep","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{"coins":{"type":"string","description":"Comma-separated symbol filter, e.g. btc,eth,sol. Omit to get all top 50."},"history":{"type":"string","enum":["30d"],"description":"When set to 30d, response includes series.btc_30d with daily OHLCV candles."}}},{"name":"tf_premium_github_velocity","short_description":"Trending GitHub repos by 7d stars + AI/ML focus + language mix (2 credits).","description":"Composed GitHub developer-attention snapshot. Returns top 30 repos created in the last 7 days sorted by stars (with stars-per-day, language, topics, license, owner type, AI/ML focus flag), top 15 AI/ML-focused active repos (topic:llm with commits in the last 30 days), language and topic aggregates, and the AI/ML share of trending. Source: GitHub Search API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/github-velocity","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_stablecoin_flows","short_description":"Net circulation changes for top stablecoins (USDT, USDC, DAI, etc.) over 24h/7d/30d (2 credits).","description":"Composed stablecoin flow snapshot for crypto traders. Returns top 20 stablecoins by circulating supply, each with 24h/7d/30d net change in USD and percent, top chains breakdown, peg type, and current price. Aggregate includes total circulating, net inflow/outflow over 24h and 7d, growing-vs-shrinking count, and a bias label (growing / shrinking / balanced). Source: DefiLlama stablecoins API. Trading agents use stablecoin growth as a leading indicator for crypto buying power. Costs 2 credits ($0.04 USDC). 1-hour cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/stablecoin-flows","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_defi_tvl","short_description":"Top 50 DeFi protocols by TVL with movers and category breakdown (2 credits).","description":"Composed DeFi total-value-locked snapshot for crypto research and trading agents. Returns top 50 protocols by TVL (each with 1h/24h/7d change, category, chain, market cap, FDV), top 15 chains by TVL, by-category aggregate, and biggest gainers/losers over 24h and 7d windows. Source: DefiLlama free public API. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/defi-tvl","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_exchange_flows","short_description":"ETH net inflow/outflow to major CEX hot wallets, last 3 blocks (2 credits).","description":"Tracks ETH transfers in/out of major centralized exchange hot wallets (Binance, Coinbase, OKX, Kraken, Bybit, Crypto.com, KuCoin) in the last 3 blocks. Each transfer tagged as inflow (user -> exchange, often precedes selling), outflow (exchange -> user, often HODL withdrawal), or inter_exchange. Aggregated per-exchange and globally with net_eth, net_usd, and bias label (inflow_dominant / outflow_dominant / balanced). Threshold 5 ETH minimum (~$11K at $2300/ETH) to filter retail noise. Useful for trading bots detecting regime shifts: sustained large net inflow signals selling pressure ahead, sustained outflow signals accumulation. Pair with tf_premium_whales for context. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required. v1 covers ETH only; BTC requires a labeled-address dataset.","url":"https://terminalfeed.io/api/pro/exchange-flows","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_whales","short_description":"Large on-chain BTC and ETH transactions in real time (2 credits).","description":"Tracks whale-sized on-chain transactions on Bitcoin and Ethereum. BTC: scans the last 30 unconfirmed mempool transactions via mempool.space and surfaces any with output >=50 BTC; tagged with USD-equivalent at current BTC spot. ETH: scans the latest confirmed block via Etherscan eth_getBlockByNumber and surfaces transfers >=100 ETH; tagged with USD-equivalent at current ETH spot. Each whale entry includes tx_hash, value in native and USD units, from/to addresses (ETH only), and explorer URL. Useful for trading bots watching for institutional flow signals (large exchange in/outflows, treasury moves, OTC settlements). Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/whales","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_correlation_matrix","short_description":"30-day Pearson correlation matrix across BTC, ETH, SOL, SPY, QQQ, GLD (2 credits).","description":"Pre-computed cross-asset correlation matrix for AI trading and portfolio agents. Returns 30-day Pearson correlations on daily simple returns for 6 assets: BTC, ETH, SOL (Coinbase candles), and SPY, QQQ, GLD (Stooq.com CSVs). Output includes both a pairs array (sorted by absolute r descending) and an NxN matrix object for easy lookup. Each pair tagged with relationship strength (negligible / weak / moderate / strong) and direction (positive / negative). Saves the agent from fetching 6 historical price series and running the covariance math. Costs 2 credits ($0.04 USDC). 30-min cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/correlation-matrix","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_agent_context","short_description":"Curated \"everything an LLM should know right now\" with paste-ready system_prompt (2 credits).","description":"The \"always start here\" premium call for autonomous agents. Composes 13 upstream sources into a curated world-state snapshot: BTC ticker, Fear and Greed, VIX, Fed funds rate, USD-base forex (EUR/JPY/GBP/CHF), HN front page top 5, significant earthquakes 24h, upcoming space launches, top Polymarket markets, and infrastructure status (GitHub, Cloudflare, OpenAI, Anthropic). Returns BOTH a structured JSON `context` object for parsers AND a pre-formatted `system_prompt` string (~350 tokens) the agent pastes verbatim into its LLM context. Saves the agent from making 13 separate calls and writing a formatter. Curation choice (which signals matter, how to compress them) is the moat. Costs 2 credits ($0.04 USDC). 5-min cache. Bearer auth required.","url":"https://terminalfeed.io/api/pro/agent-context","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_premium_world_deltas","short_description":"Time-sorted event stream: earthquakes + HN + Polymarket + launches (2 credits).","description":"Premium event-stream endpoint for monitor agents. Aggregates time-stamped events from 4 sources into one time-sorted feed: USGS earthquakes M4.0+, Hacker News new stories via Algolia, recently updated Polymarket markets, and space launches in [-1h, +12h] window. Accepts ?since=<ISO timestamp> (defaults 1h ago, clamped to 1h cache horizon). Each event has type, timestamp, severity, and structured data. Saves an agent from polling 5 separate upstream feeds and merging client-side. Costs 2 credits ($0.04 USDC). Bearer auth required. 1-hour rolling cache; sub-second when warm.","url":"https://terminalfeed.io/api/pro/world-deltas","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{"since":{"type":"string","description":"ISO 8601 timestamp. Returns events newer than this. Defaults to 1 hour ago. Clamped to 1 hour ago if older."}}},{"name":"tf_premium_sentiment","short_description":"Composite market sentiment: Fear & Greed + VIX + trending tickers (2 credits).","description":"Premium composite sentiment snapshot. Aggregates Crypto Fear and Greed Index (alternative.me), VIX volatility index (Finnhub), trending ticker mentions across Hacker News top 30 + Reddit r/CryptoCurrency / r/wallstreetbets / r/stocks hot posts with per-headline keyword-based sentiment scoring, and top Polymarket prediction-market signals. Output includes per-ticker mention_count_24h, sentiment_score (-1 to +1), sentiment_label, and sample headlines. Use to gauge market mood before a trading or research decision. Costs 2 credits ($0.04 USDC). Requires Authorization: Bearer tf_live_<64-char-hex>. The notes field documents that scoring is keyword-based (crude but signal-bearing), not LLM-derived; treat as one input to a broader analysis.","url":"https://terminalfeed.io/api/pro/sentiment","method":"GET","auth":"bearer","tier":"premium","cost_credits":2,"parameters":{}},{"name":"tf_payment_buy_credits","short_description":"Quote a USDC credit purchase.","description":"POST endpoint that returns the published USDC wallet address (0x549c82e6bfc54bdae9a2073744cbc2af5d1fc6d1 on Base mainnet), a unique memo, and a quote tying the dollar amount to credits at $1 USDC = 50 credits. Use as the first step when the agent needs to buy credits to access /api/pro/* endpoints.","url":"https://terminalfeed.io/api/payment/buy-credits","method":"POST","auth":"none","tier":"free","parameters":{"amount_usd":{"type":"number","description":"USDC amount to convert. Minimum $1 = 50 credits."}}},{"name":"tf_payment_confirm","short_description":"Confirm USDC payment, mint bearer token.","description":"POST endpoint that verifies an on-chain Base mainnet USDC transfer to the published wallet and returns a bearer token (tf_live_<64-char-hex>) plus credit count. Use after the agent has sent USDC, with the tx hash and the memo from tf_payment_buy_credits. The returned token is cross-redeemable on tensorfeed.ai.","url":"https://terminalfeed.io/api/payment/confirm","method":"POST","auth":"none","tier":"free","parameters":{"tx_hash":{"type":"string","description":"On-chain Base mainnet USDC transaction hash."},"nonce":{"type":"string","description":"The memo string returned from tf_payment_buy_credits (optional but recommended)."}}},{"name":"tf_payment_balance","short_description":"Check remaining credits for a bearer token.","description":"GET endpoint that returns remaining credits for the bearer token in the Authorization header. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Use to monitor agent budget.","url":"https://terminalfeed.io/api/payment/balance","method":"GET","auth":"bearer","tier":"free","parameters":{}},{"name":"tf_payment_history","short_description":"List confirmed USDC purchases for a bearer token.","description":"GET endpoint that returns confirmed USDC purchases (tx_hash, amount_usd, credits_added, block_number, confirmed_at) plus current balance and totals for the bearer token. Requires Authorization: Bearer tf_live_<64-char-hex>. Costs 0 credits. Tokens minted before the ledger existed return current_balance with purchases: [].","url":"https://terminalfeed.io/api/payment/history","method":"GET","auth":"bearer","tier":"free","parameters":{}}]}