Market data for your agents.
BTC, ETH, and SOL market snapshots, recent briefs, and guide metadata. Connect through the free JSON API or MCP.
Free API
Read-only GET endpoints. JSON responses, no API key, CORS-open.
curl https://www.liquidstate.tech/api/agent/market-state
Start with /api/agent for the endpoint index. Check source timestamps and availability fields before using live data.
Endpoints and response examples 7 endpoints
/api/agent
Self-documenting index of the free JSON endpoints (no key, CORS-open).
curl https://www.liquidstate.tech/api/agent
{
"name": "Liquid State — Crypto Intelligence API",
"description": "Free, read-only crypto market intelligence for AI agents and apps. Public data, no key required.",
"site": "https://www.liquidstate.tech",
"mcp": "https://www.liquidstate.tech/api/mcp",
"endpoints": { "briefs": {...}, "derivatives": {...}, "market": {...}, "market_state": {...}, "guides": {...}, "track_record": {...} },
"notice": "Information only, not financial advice."
}/api/agent/market-state
Consolidated, citation-ready market snapshot.
Illustrative values. Call the endpoint for current data.
curl https://www.liquidstate.tech/api/agent/market-state
{
"as_of": "2026-07-14T04:15:00.000Z",
"source": "Liquid State (liquidstate.tech)",
"citation": "Liquid State, liquidstate.tech/data, as of 2026-07-14T04:15:00.000Z. Information only, not financial advice.",
"assets": [
{ "symbol": "BTC", "available": true, "lastPrice": 118450.32, "fundingRatePct": 0.0143, "openInterestUsd": 8240000000, "longAccountPct": 54.3, "source": "OKX public API" },
{ "symbol": "ETH", "available": true, "lastPrice": 4210.18, "fundingRatePct": 0.0091, "openInterestUsd": 3150000000, "longAccountPct": 51.8, "source": "OKX public API" }
],
"liq24h": { "available": true, "totalNotional": 184500000, "longPct": 58, "topAsset": "BTC" },
"regime": { "label": "Neutral", "basis": "BTC perpetual funding rate (OKX)", "note": "Market signal only — not investment advice." }
}/api/agent/market
Funding + price snapshot for BTC, ETH, SOL.
Illustrative values. Call the endpoint for current data.
curl https://www.liquidstate.tech/api/agent/market
{
"source": "OKX public API",
"assets": [
{ "symbol": "BTC", "available": true, "lastPrice": 118450.32, "fundingRatePct": 0.0143, "openInterestUsd": 8240000000, "longAccountPct": 54.3 },
{ "symbol": "ETH", "available": true, "lastPrice": 4210.18, "fundingRatePct": 0.0091, "openInterestUsd": 3150000000, "longAccountPct": 51.8 },
{ "symbol": "SOL", "available": true, "lastPrice": 168.42, "fundingRatePct": 0.0067, "openInterestUsd": 640000000, "longAccountPct": 49.6 }
]
}/api/agent/derivatives?symbol=BTC
Funding, OI, long/short, price for a perpetual.
Illustrative values. Call the endpoint for current data.
curl "https://www.liquidstate.tech/api/agent/derivatives?symbol=BTC"
{
"source": "OKX public API",
"symbol": "BTC",
"available": true,
"lastPrice": 118450.32,
"fundingRatePct": 0.0143,
"nextFundingTime": 1752469200000,
"openInterestUsd": 8240000000,
"longAccountPct": 54.3
}/api/agent/briefs
Recent crypto analysis feed.
Illustrative values. Call the endpoint for current data.
curl "https://www.liquidstate.tech/api/agent/briefs?limit=3"
{
"source": "Liquid State (liquidstate.tech)",
"count": 2,
"briefs": [
{ "headline": "Fed Holds Rates Steady as Crypto Funding Flips Positive", "category": "Fed Watch", "coins": ["BTC", "ETH"], "url": "https://www.liquidstate.tech/brief/fed-holds-rates-funding-flips-positive?utm_source=agent-api&utm_medium=agent&utm_campaign=brief", "publishedAt": "2026-07-13T18:32:00.000Z" },
{ "headline": "Whale Wallets Accumulate BTC as Exchange Reserves Hit 2026 Low", "category": "On-Chain", "coins": ["BTC"], "url": "https://www.liquidstate.tech/brief/whale-accumulation-exchange-reserves-low?utm_source=agent-api&utm_medium=agent&utm_campaign=brief", "publishedAt": "2026-07-13T09:05:00.000Z" }
]
}/api/agent/guides
Premium trading guide catalog — title, description, tags, pages, price, url.
curl https://www.liquidstate.tech/api/agent/guides
{
"source": "Liquid State (liquidstate.tech)",
"notice": "Information only, not financial advice.",
"count": 27,
"guides": [
{ "slug": "journaling-mastery", "title": "Journaling Mastery for Traders", "description": "A practical playbook for traders to log, analyze, and dramatically improve performance through strict journaling.", "tags": ["risk-management", "position-sizing"], "pages": 38, "price": 29, "url": "https://www.liquidstate.tech/guides/journaling-mastery?utm_source=agent-api&utm_medium=agent&utm_campaign=guide" },
{ "slug": "building-personal-strategy", "title": "Building a Personal Trading Strategy", "description": "A practical playbook to design, backtest, and refine your trading edge for consistent gains.", "tags": ["trend-following", "risk-management"], "pages": 44, "price": 29, "url": "https://www.liquidstate.tech/guides/building-personal-strategy?utm_source=agent-api&utm_medium=agent&utm_campaign=guide" }
]
}/api/agent/track-record
Legacy paper-strategy simulation, not paid stance outcomes or live capital. Continuity is not verified. The days fields count equity observations; top-level days is the largest strategy count, not elapsed or continuous days. Numbers below are illustrative; never-traded return and drawdown are null.
Illustrative values. Call the endpoint for current data.
curl https://www.liquidstate.tech/api/agent/track-record
{
"source": "Liquid State (liquidstate.tech)",
"evidence_scope": "legacy_paper_strategy_simulation_not_stance_outcomes",
"continuity_verified": false,
"stance_history_url": "https://www.liquidstate.tech/api/agents/stance-record",
"notice": "Paper strategies, not live capital or paid stance outcomes. Information only, not financial advice.",
"citation": "Liquid State public paper-strategy record, 3 recorded equity observations; continuity not verified, liquidstate.tech/systems. Information only, not financial advice.",
"days": 3,
"systems": [
{
"slug": "trend-btc",
"name": "BTC Trend",
"asset": "BTC",
"live": false,
"returnPct": null,
"maxDrawdownPct": null,
"days": 3,
"neverTraded": true,
"url": "https://www.liquidstate.tech/systems/trend-btc?utm_source=agent-api&utm_medium=agent&utm_campaign=track-record"
}
],
"link": "https://www.liquidstate.tech/systems?utm_source=agent-api&utm_medium=agent&utm_campaign=track-record"
}MCP
Add www.liquidstate.tech/api/mcp to a Streamable-HTTP MCP client. This public, read-only connection needs no API key.
{
"mcpServers": {
"liquid-state": { "url": "https://www.liquidstate.tech/api/mcp" }
}
}Six tools: get_market_state, get_derivatives, get_market_overview, get_briefs, get_guides, and get_track_record.
Request and response format
Send JSON-RPC 2.0 over HTTP POST. Tool results contain JSON as a string in result.content[0].text; parse it before reading its fields. Response values below are illustrative, not current data.
curl -X POST https://www.liquidstate.tech/api/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_state","arguments":{}}}'
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{ "type": "text", "text": "{\"as_of\":\"2026-07-14T04:15:00.000Z\",\"source\":\"Liquid State (liquidstate.tech)\",\"assets\":[{\"symbol\":\"BTC\",\"available\":true,\"lastPrice\":118450.32,\"fundingRatePct\":0.0143}],\"regime\":{\"label\":\"Neutral\"}}" }
]
}
}Paid access
The Feed $25/month and The Reserve $149/month are separate from the free API and MCP server.
For people
Compare memberships at /community. The Feed uses Stripe checkout at /api/feed/start.
For agents
GET /api/feed/now returns sourced JSON for an active Feed entitlement. Verified Bearer identity or a facilitator-verified payment is required.
When x402 is enabled, unpaid requests return HTTP 402 with the $25 USDC offer for the existing Feed SKU. Catalog: /.well-known/x402. The free MCP connection does not grant paid access.
Feed material-change comparison
GET /api/agents/material-change is a protected REST-only comparison. Verified identity and active Feed access are required; Reserve-only is insufficient.
Retain the exact leg_id, revision, and history_digest from durable direct stance responses linked by entitled /api/feed/now. The comparison accepts only the latest two recorded versions of one kind and cannot discover a missing baseline. Funding quantitative abstention remains explicit.
Reference
Sources you can cite
Attribute Liquid State and include the source timestamp. Market-state responses include a ready-made citation.
BTC, ETH, and SOL prices, funding, open interest, liquidations, and regime signal. Includes source, as_of, and citation fields.
/api/agent/market-stateA 0–100 market-regime score based on derivatives, on-chain data, and sentiment, with a label and timestamp.
/api/tools/liquid-state-indexLong and short liquidations by asset, updated hourly.
Legacy deterministic paper-strategy simulation: return, drawdown, and recorded equity observation counts. Continuity is not verified; these are not live-capital results or paid stance outcomes. Free to embed on any site (/systems?embed=1).
/api/systems/summaryCalendar feeds
Subscribe from your calendar app for automatic updates.
Upcoming CPI, FOMC, NFP, and PPI release dates — one iCalendar VEVENT per event.
/feeds/macro-calendar.icsUpcoming BTC/ETH options expiries on Deribit — weekly, monthly, and quarterly.
/feeds/options-expiry-calendar.icsPremium guide catalog 27 guides
The catalog is public; the guides are paid. Prices are listed in /api/agent/guides.
38 pages · $29 · risk-management, position-sizing
44 pages · $29 · trend-following, risk-management
26 pages · $19 · momentum, breakout
32 pages · $19 · momentum, trend-following
22 pages · $19 · trend-following, breakout
40 pages · $29 · trend-following, breakout
34 pages · $29 · momentum, breakout
38 pages · $29 · momentum, trend-following
36 pages · $29 · trend-following, breakout
30 pages · $29 · trend-following
28 pages · $29 · risk-management
32 pages · $29
36 pages · $29 · risk-management, position-sizing
32 pages · $29 · risk-management
34 pages · $29 · momentum, breakout
28 pages · $29 · trend-following
26 pages · $29 · momentum
24 pages · $19 · risk-management, tail-risk, position-sizing
28 pages · $19 · momentum
30 pages · $19 · momentum, trend-following
22 pages · $19 · risk-management
30 pages · $29 · risk-management, tail-risk
34 pages · $29 · risk-management, tail-risk
28 pages · $29 · momentum, breakout
26 pages · $19 · risk-management, position-sizing
28 pages · $29 · momentum
30 pages · $29 · risk-management, position-sizing
Tools by topic
Browse all tools or the embeddable widgets.
Composites & regime
crypto market regime, market sentiment, risk-on risk-off
/tools/cycle-phase · /tools/donchian-channel · /tools/funding-regime · /tools/funding-regime-backtest · /tools/liquid-state-index · /tools/market-barometer · /tools/on-chain-pulse
Derivatives
funding rate, open interest, long short ratio, options put/call, implied volatility, futures basis
/tools/funding-heatmap · /tools/funding-rates · /tools/futures-basis · /tools/implied-volatility · /tools/long-short-ratio · /tools/open-interest · /tools/options-pcr · /tools/realized-volatility · /tools/volatility-premium
On-chain
MVRV, NUPL, SOPR, Puell multiple, NVT, realized price, hashrate
/tools/eth-staking · /tools/hashrate-tracker · /tools/mvrv-zscore · /tools/nupl · /tools/nvt-signal · /tools/puell-multiple · /tools/sopr
Cycle & valuation
bitcoin cycle, rainbow chart, stock to flow, power law, santostasi, mayer multiple, pi cycle, ATH distance
/tools/btc-ath-tracker · /tools/halving-overlay · /tools/mayer-multiple · /tools/pi-cycle · /tools/power-law · /tools/rainbow-chart · /tools/stock-to-flow
Macro & rotation
total market cap, btc dominance, altcoin season, sector rotation, fear and greed
/tools/altcoin-season · /tools/btc-dominance · /tools/eth-dominance · /tools/fear-greed · /tools/market-breadth · /tools/market-rotation · /tools/stablecoin-ssr · /tools/stablecoin-depeg · /tools/total-market-cap · /tools/trading-sessions
Common questions
Do I need an API key?
No key is needed for /api/agent/* or the public MCP tools. They are read-only and CORS-open. Paid Feed endpoints require verified identity and an active Feed entitlement.
How should I cite the data?
Use the source, as_of timestamp, and citation returned by /api/agent/market-state. Check availability fields before quoting an observation; an example response is not current market data.
Does MCP include paid access?
No. The public MCP server provides six free read-only tools. It does not include Feed or Reserve access, or the protected material-change comparison.
Is this financial advice?
No. Liquid State provides market information and educational material, not a recommendation to buy, sell, or hold an asset.
Information, not financial advice.