# Crypto & Macro Market Data (Tanod)

> Market data for agents: token prices, DeFi TVL and DEX volume, perp funding, FX, yields, SEC data. A focused part of Tanod (https://tanod.dev/llms.txt covers every family), over HTTP and MCP.
>
> Pay per call in USDC on Base or Polygon or Solana or BNB Chain or Arbitrum with x402, or on Tempo with MPP; no account or API key. Free tier: a small daily per-IP
> pool per family; over HTTP add the header `X-Tanod-Free: 1` to an unpaid call (without it every unpaid call gets the 402); over MCP
> the free tier is automatic.
> Every result is automated and heuristic, not an audit: findings can be false positives, and a clean result is not proof that code or a package is free of risk.
> Tanod is operated by an autonomous AI agent on behalf of its owner. Scans run automatically; no person reviews individual results.

## API

- [OpenAPI spec](https://finance.tanod.dev/openapi.json): machine-readable description of this family's 32 routes.
- [x402 resources](https://finance.tanod.dev/.well-known/x402)
- MCP: `https://tanod.dev/mcp/finance` (server `tanod-finance`); also at `https://finance.tanod.dev/mcp` on this host

## Routes

- `GET https://finance.tanod.dev/v1/markets/macro` (get_macro_snapshot_no_params): Use when an agent needs the rates backdrop before a market decision: Treasury yields, SOFR/EFFR, FX, oil and gas in one call.
- `POST https://finance.tanod.dev/v1/markets/macro` (macro_snapshot_treasury_ecb_dollar_proxy): Use when an agent needs the rates backdrop before a market decision: Treasury yields, SOFR/EFFR, FX, oil and gas in one call.
- `POST https://finance.tanod.dev/v1/fx/live` (get_live_fx_rates): Use when an agent needs on-chain EUR/GBP/MXN/BRL/CAD/SGD/ZAR/IDR vs USD or exchange quotes for 8 pairs, not ECB.
- `POST https://finance.tanod.dev/v1/chain/exchange-reserves` (get_cex_exchange_reserves_inflow_outflow): Use when an agent must judge selling pressure or check reserves before depositing: a coin's exchange inflow or outflow.
- `POST https://finance.tanod.dev/v1/defi/yields` (get_defi_lending_yields_snapshot): Use when an agent must choose where to lend or borrow: supply and borrow APY on Aave, Compound and Morpho.
- `POST https://finance.tanod.dev/v1/markets/local-premium` (local_crypto_premium_kimchi_usdt): Use when an agent needs to gauge local demand for crypto: the kimchi or USDT premium on local exchanges vs the global price.
- `POST https://finance.tanod.dev/v1/chain/price` (get_token_price): Use when an agent needs an on-chain Chainlink price for ETH, BTC or a stablecoin, with its update time.
- `POST https://finance.tanod.dev/v1/sanctions` (screen_crypto_address_ofac_sanctions): Use when an agent must screen one crypto address against the US OFAC SDN list before transacting.
- `POST https://finance.tanod.dev/v1/fx` (convert_currency_exchange_rates): Use when an agent must convert an amount between currencies at ECB reference rates, latest or from the last 90 days.
- `POST https://finance.tanod.dev/v1/holidays` (get_public_holidays): Use when an agent must know the public holidays of a country and year before scheduling dates.
- `POST https://finance.tanod.dev/v1/validate` (validate_iban): Use when an agent must check the format and check digits of an IBAN, VAT, ISBN, LEI or similar ID.
- `POST https://finance.tanod.dev/v1/fx/stablecoin-peg` (check_stablecoin_peg): Use when an agent must check whether USDC, USDT, DAI, USDe or PYUSD still trades at one dollar, from on-chain pools.
- `POST https://finance.tanod.dev/v1/chain/token-trades` (get_large_token_trades): Use when an agent needs the recent large buys and sells of an ERC-20 token: side, USD size, sender.
- `POST https://finance.tanod.dev/v1/defi/tvl` (get_protocol_tvl): Use when an agent must size or compare a DeFi protocol or chain: its TVL and the 1-day and 7-day change.
- `POST https://finance.tanod.dev/v1/defi/stablecoins` (get_stablecoin_supply): Use when an agent must see where stablecoin supply sits and moves: a coin's or chain's circulating supply.
- `POST https://finance.tanod.dev/v1/defi/dex-volume` (get_dex_volume): Use when an agent must gauge DEX activity: trading volume of a DEX or chain over 24 hours, 7 and 30 days.
- `POST https://finance.tanod.dev/v1/defi/fees` (get_protocol_fees): Use when an agent must judge what a protocol earns: its fees and revenue over 24 hours, 7 days, 30 days and a year.
- `POST https://finance.tanod.dev/v1/solana/token-trades` (get_solana_token_trades_recent_buys_sells_buying): Use when an agent needs the recent large buys and sells of a Solana token: side, USD size, wallet.
- `POST https://finance.tanod.dev/v1/solana/reward-yield` (check_solana_holder_reward_token_yield_payouts): Use when an agent must know if a Solana reward token still pays its holders: last payout, 7d and 30d yield.
- `POST https://finance.tanod.dev/v1/date/business-days` (count_business_days): Use when an agent must count working days between dates or find the date N working days ahead.
- `POST https://finance.tanod.dev/v1/finance/sec/company` (sec_company_filings): Use when an agent needs a US-listed company's SEC profile and recent filings from a ticker or CIK.
- `POST https://finance.tanod.dev/v1/finance/sec/financials` (sec_edgar_financials): Use when an agent needs a US-listed company's reported revenue, income, cash flow or debt by period.
- `POST https://finance.tanod.dev/v1/finance/treasury/yields` (us_treasury_yield_curve): Use when an agent needs the US Treasury par yield curve for a given date.
- `POST https://finance.tanod.dev/v1/markets/fear-greed` (get_crypto_fear_greed_index): Use when an agent needs the crypto Fear & Greed Index: today's value, label and the last 7 days.
- `POST https://finance.tanod.dev/v1/chain/candles` (get_crypto_ohlcv_price_candles): Use when an agent needs ETH or BTC price history as OHLCV candles for charting or backtesting.
- `POST https://finance.tanod.dev/v1/chain/transfer-fees` (compare_stablecoin_transfer_fees): Use when an agent must pick the cheapest chain to send USDC or USDT: ranks Base, Polygon, Ethereum, BNB, Arbitrum, Solana.
- `POST https://finance.tanod.dev/v1/chain/pre-trade-check` (pre_trade_check): Use when an agent is about to swap and needs the price impact at several sizes before choosing one.
- `POST https://finance.tanod.dev/v1/chain/transfer-preflight` (transfer_preflight): Use when an agent is about to send USDC or USDT and needs one pass, warn or fail with reasons first.
- `POST https://finance.tanod.dev/v1/solana/token-price` (get_solana_token_price_usd_mint_pool_liquidity): Use when an agent needs a Solana token's USD price and pool liquidity before it trades or values a holding.
- `POST https://finance.tanod.dev/v1/gov/federal-register` (search_federal_register): Use when an agent tracks US rulemaking: new rules, open comment periods, docket IDs and CFR parts.
- `POST https://finance.tanod.dev/v1/defi/funding-spread` (compare_perp_funding_hyperliquid_dydx): Use when an agent needs perpetual funding on Hyperliquid versus dYdX, with the annualised spread.
- `POST https://finance.tanod.dev/v1/defi/funding-carry` (funding_rate_arbitrage_opportunities): Use when an agent needs the best cross-venue perp funding arbitrage pairs across Binance, Bybit, OKX, Hyperliquid and dYdX.
- `POST https://finance.tanod.dev/v1/near/account` (get_near_account_balance_keys_contract): Use when an agent needs a NEAR account's balance, staked NEAR, access keys or whether it runs a contract.