{"family":"markets","title":"Token prices, wallet balances, FX rates and company financials","free":true,"note":"Fixed sample: real example input and output of each paid route in this family, no payment. The paid routes answer HTTP 402; each paid answer carries next.","services":[{"service":"token-price","title":"Token price on Base","tool":"blackwood_token_price","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price","price":{"scheme":"exact","amountUsdc":"0.003"},"useWhen":"you need a crypto token price or market data for a Base token, quoted from on-chain liquidity","avoidWhen":"tokens that only trade off Base or on other DEXs (Aerodrome is not read), price history or OHLC","input":{"token":"WETH"},"output":{"token":"0x4200000000000000000000000000000000000006","symbol":"WETH","decimals":18,"priceUsd":2421.2474,"quote":"USDC","pool":"0x6c561B446416E1A00E8E93E221854d6eA4171372","feeTier":3000,"depthUsd":56610101,"blockNumber":52713897,"source":"Uniswap v3 on Base (on-chain)"},"next":{"service":"wallet-balances","tool":"blackwood_wallet_balances","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balances","useWhen":"you need the ERC20 token balance or wallet balance of an address on Base for onchain data checks","sample":"https://x402-gateway.blackwoodstate8.workers.dev/markets/sample"}},{"service":"wallet-balances","title":"Wallet balances on Base","tool":"blackwood_wallet_balances","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/wallet-balances","price":{"scheme":"exact","amountUsdc":"0.004"},"useWhen":"you need the ERC20 token balance or wallet balance of an address on Base for onchain data checks","avoidWhen":"Ethereum mainnet or other chains, NFTs, transaction history or USD values","input":{"address":"0x5A6c77758820182484EA8DE614FC65423E80749a"},"output":{"address":"0x5A6c77758820182484EA8DE614FC65423E80749a","network":"eip155:8453","blockNumber":52713897,"native":{"symbol":"ETH","balance":"0","raw":"0"},"tokens":[{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","decimals":6,"balance":"0.01","raw":"10000"}],"notTokens":[],"checkedTokens":21},"next":{"service":"token-price","tool":"blackwood_token_price","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price","useWhen":"you need a crypto token price or market data for a Base token, quoted from on-chain liquidity","sample":"https://x402-gateway.blackwoodstate8.workers.dev/markets/sample"}},{"service":"fx-rates","title":"FX rates","tool":"blackwood_fx_rates","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-rates","price":{"scheme":"exact","amountUsdc":"0.005"},"useWhen":"you need currency exchange rates, forex conversion of an amount or a reference rate between two currencies","avoidWhen":"live trading quotes, intraday or crypto rates (ECB rates update once per business day)","input":{"base":"USD","symbols":["EUR","BRL","JPY","GBP"],"amount":100},"output":{"date":"2026-10-16","base":"USD","rates":{"EUR":0.888652,"BRL":5.08282,"JPY":158.02,"GBP":0.749889},"amount":100,"converted":{"EUR":88.87,"BRL":508.28,"JPY":15802,"GBP":74.99},"attribution":"Source: European Central Bank (ECB) euro foreign exchange reference rates, available free of charge at ecb.europa.eu","note":"ECB reference rates are for information purposes only, published once per business day; they are not trading rates. Rates against a base other than EUR and converted amounts are calculated by Blackwood State from the ECB euro rates."},"next":{"service":"token-price","tool":"blackwood_token_price","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/token-price","useWhen":"you need a crypto token price or market data for a Base token, quoted from on-chain liquidity","sample":"https://x402-gateway.blackwoodstate8.workers.dev/markets/sample"}},{"service":"sec-facts","title":"SEC company financials","tool":"blackwood_sec_facts","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts","price":{"scheme":"exact","amountUsdc":"0.02"},"useWhen":"you need sec filings company financials, earnings or fundamentals for a stock ticker for the last two fiscal years","avoidWhen":"quarterly numbers, real-time prices, non-US companies or filings older than two years","input":{"ticker":"AAPL"},"output":{"ticker":"AAPL","cik":320193,"name":"Apple Inc.","exchange":"Nasdaq","currency":"USD","fiscalYears":[{"calendarYear":2025,"start":"2024-09-29","end":"2025-09-27","revenue":416161000000,"netIncome":112010000000,"operatingIncome":133050000000,"epsDiluted":7.46,"operatingCashFlow":111482000000,"accn":"0000320193-25-000079"},{"calendarYear":2024,"start":"2023-10-01","end":"2024-09-28","revenue":391035000000,"netIncome":93736000000,"operatingIncome":123216000000,"epsDiluted":6.08,"operatingCashFlow":118254000000,"accn":"0000320193-25-000079"}],"balanceSheets":[{"calendarYear":2025,"asOf":"2025-12-27","assets":379297000000,"liabilities":291107000000,"equity":88190000000,"cash":45317000000},{"calendarYear":2024,"asOf":"2024-12-28","assets":344085000000,"liabilities":277327000000,"equity":66758000000,"cash":30299000000}],"source":"SEC EDGAR XBRL frames (data.sec.gov)","dataUpdatedAt":"2026-10-16T15:00:00.000Z"},"next":{"service":"fx-rates","tool":"blackwood_fx_rates","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-rates","useWhen":"you need currency exchange rates, forex conversion of an amount or a reference rate between two currencies","sample":"https://x402-gateway.blackwoodstate8.workers.dev/markets/sample"}},{"service":"fx-history","title":"FX rate history","tool":"blackwood_fx_history","method":"POST","url":"https://x402-gateway.blackwoodstate8.workers.dev/v1/fx-history","price":{"scheme":"exact","amountUsdc":"0.005"},"useWhen":"you need historical exchange rates, forex history or the recent trend of a currency","avoidWhen":"rates older than 90 days, live quotes or crypto (one ECB rate per business day)","input":{"symbols":["USD","BRL"],"days":7},"output":{"base":"EUR","startDate":"2026-10-12","endDate":"2026-10-16","days":5,"truncated":false,"series":[{"date":"2026-10-12","rates":{"USD":1.1181,"BRL":5.5819}},{"date":"2026-10-13","rates":{"USD":1.1188,"BRL":5.6125}},{"date":"2026-10-14","rates":{"USD":1.1195,"BRL":5.6246}},{"date":"2026-10-15","rates":{"USD":1.1208,"BRL":5.6679}},{"date":"2026-10-16","rates":{"USD":1.1253,"BRL":5.7197}}],"stats":{"USD":{"first":1.1181,"last":1.1253,"min":1.1181,"max":1.1253,"changePct":0.64},"BRL":{"first":5.5819,"last":5.7197,"min":5.5819,"max":5.7197,"changePct":2.47}},"attribution":"Source: European Central Bank (ECB) euro foreign exchange reference rates, available free of charge at ecb.europa.eu","note":"ECB reference rates are for information purposes only, published once per business day; they are not trading rates. Rates against a base other than EUR and the statistics are calculated by Blackwood State from the ECB euro rates."}}],"try":"https://x402-gateway.blackwoodstate8.workers.dev/try"}