terminalfeed 0.1.0

Python client for the TerminalFeed real-time data API: live markets, crypto, macro, and world data for humans and AI agents

terminalfeed

Python client for the TerminalFeed real-time data API: live markets, crypto, macro, and world data, built for humans on a second monitor and for AI agents that pay their own way.

pip install terminalfeed

Single module, one dependency (requests). You can also vendor it: copy terminalfeed.py straight into your codebase.

Free tier (no token, no signup)

from terminalfeed import TerminalFeed

tf = TerminalFeed()

print(tf.free_btc_price())        # live BTC price
print(tf.free_briefing())         # one-call world snapshot
print(tf.free_feed_reliability()) # ranked reliability of every feed
print(tf.regime_preview())        # free taste of the market-regime verdict
print(tf.pro_catalog())           # machine-readable premium catalog with prices

There are 30+ free endpoints in total (stocks, earthquakes, prediction markets, space launches, gas prices, and more). The full list lives at terminalfeed.io/for-devs/api and in llms.txt.

Premium tier (USDC on Base, no KYC)

1 credit = $0.02, and $1 USDC buys 50 credits. The entire payment loop is agent-completable: no signup form, no credit card, no human in the loop.

from terminalfeed import TerminalFeed

tf = TerminalFeed()
quote = tf.buy_credits(amount_usd=1.00)
# Send USDC on Base mainnet to quote["wallet"] with memo quote["memo"]
tf.confirm_payment(tx_hash="0x...", nonce=quote["memo"])

print(tf.balance())
print(tf.macro(history="30d"))                      # 2 credits
print(tf.crypto_deep(coins=["btc", "eth", "sol"]))  # 2 credits
print(tf.briefing(include=["btc", "predictions"]))  # 1 credit
print(tf.regime())                                  # 2 credits, signed receipt
print("remaining:", tf.credits_remaining)

Token sharing with TensorFeed

Bearer tokens (tf_live_<64-char-hex>) are cross-redeemable with TensorFeed (pip install tensorfeed). A token minted on either site authenticates on both, against a shared credit pool. One purchase, two data sources.

Error handling

from terminalfeed import TerminalFeed, PaymentRequiredError, TerminalFeedError

try:
    tf.macro()
except PaymentRequiredError as e:
    # e.reason is one of: missing_token, invalid_token,
    # insufficient_credits, expired, billing_unavailable
    print("need credits:", e.reason, e.signup_url)
except TerminalFeedError as e:
    print("API error:", e)

Links

• Docs: https://terminalfeed.io/developers/agent-payments
• Developer hub: https://terminalfeed.io/for-devs
• OpenAPI spec: https://terminalfeed.io/openapi.json
• MCP server config: https://terminalfeed.io/for-devs/mcp

MIT licensed.