Crypto Spot-price
Return one current Coinbase spot-product snapshot for an exact BASE-QUOTE product id, including venue price, 24-hour price change and provider-reported 24-hour product volume. Forest reads only Coinbase Advanced Trade public market data; it does not infer tickers, infer the provider volume denomination, aggregate venues, read an account or wallet, place orders, provide an executable quote, forecast returns or recommend a trade.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- get the current BTC USD spot price from Coinbase
- check current ETH USD spot price
- get a current Coinbase crypto spot market price
- check the current SOL USD price before another action
- read the current named venue spot price for a crypto pair
What Forest guarantees
- exact normalized Coinbase BASE-QUOTE product id only; Forest performs no fuzzy symbol mapping and the caller cannot choose another provider or URL
- one Coinbase public product GET per cold exact-product refresh with a process-shared 3000 ms same-product cache and single-flight refresh
- provider-wide process-local pacing of at least 500 ms between cold refreshes with at most 16 queued refresh slots before fail-fast busy
- Coinbase must return the exact requested product, matching base/quote metadata, SPOT product type, online status and no disabled/trading-disabled state
- price, normalized 24-hour percent change and provider-reported 24-hour product volume remain validated decimal strings so provider decimal precision is not silently round-tripped through binary floating point; Forest does not infer the volume denomination
- fixed Coinbase Advanced Trade public market-data source with no credentials, cookies, caller headers, redirects, account state, wallet state, signing, order placement or mutation
Boundaries
- best bid/ask, executable quote, order-book depth, candles, historical prices, consolidated index/reference price or cross-exchange fallback
- automatic BTC-to-BTC-USD inference, token-contract lookup, fiat/FX conversion or arbitrary provider routing
- trade direction, expected return, arbitrage opportunity, portfolio action or investment advice
- the unit/denomination of Coinbase volume_24h beyond the provider field itself
- global cross-replica rate limiting; cache, single-flight and provider pacing are process-local
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
Canonical paid endpoint
Related capabilities
- Crypto Fear-greed — Return the current Bitcoin-focused Crypto Fear & Greed reading and an optional bounded recent daily history from Alternative.me. Forest preserves the provider classification and prominent source attribution; it does not synthesize an asset-specific altcoin score, forecast price, create a trading signal, recommend a trade or access any account or wallet.
- Perp Funding — Return one current Hyperliquid native perpetual snapshot with hourly funding, 8-hour equivalent, simple nominal annualization of the current hourly rate, mark/oracle basis, Hyperliquid funding premium index, open interest, daily notional volume and max leverage. Forest reads only the fixed public Hyperliquid info endpoint; the annualized field is not compounded, forecast or realized return, and Forest does not trade, sign, read a wallet or recommend a position.
- Perp Funding-history — Return a bounded recent history of realized hourly funding-rate observations for one exact Hyperliquid native perpetual. Forest makes one fixed public fundingHistory request, returns at most 168 newest normalized observations, and reuses the existing shared Hyperliquid pacing boundary. This is historical market data only, not a prediction, arbitrage signal, trader funding ledger or trading recommendation.
- Sec Company-resolve — Resolve one exact U.S. public-company ticker to the SEC canonical CIK and EDGAR-conformed company name using the official SEC company_tickers.json mapping. Forest performs no fuzzy company-name search, filing download, market-data inference or mutation.
- Sec Recent-filings — Return newest-first metadata for recent official SEC EDGAR submissions for one exact ticker or CIK, optionally filtered to an exact form such as 10-K, 10-Q, 8-K or S-1. Forest returns bounded filing metadata and canonical SEC archive links only; it does not download filing bodies, crawl exhibits, parse XBRL or perform investment analysis.
- Treasury Yield-curve — Return the latest published U.S. Treasury Daily Treasury Par Yield Curve Rates snapshot across standard maturities from 1 month through 30 years. Forest normalizes one coherent official daily observation, reports missing Treasury tenors as null, and performs no forecast, interpolation, trading signal or secondary-market inference.