LIQUID STATE / DEVELOPERS

Market data for your agents.

BTC, ETH, and SOL market snapshots, recent briefs, and guide metadata. Connect through the free JSON API or MCP.

Sources
InputsA plain GET request, or an MCP tool call.
OutputsJSON with the source, an as_of timestamp, and a ready-made citation.
CoverageBTC, ETH, and SOL market snapshots, recent briefs, and guide details.
API keyNone for the free API and the public MCP tools.
LimitsRead-only. Paid Feed and Reserve data is separate. Example responses on this page are illustrative, not current data.
01 / Public data

Free API

Read-only. Every endpoint returns JSON. No API key is needed, and requests work straight from a web page.

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.

In plain words
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"
}
02 / Tool connection

MCP

Add www.liquidstate.tech/api/mcp to an MCP client that connects over HTTP. 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\"}}" }
    ]
  }
}
04 / Documentation

Reference

Sources you can cite

Attribute Liquid State and include the source timestamp. Market-state responses include a ready-made citation.

Live market state

BTC, ETH, and SOL prices, funding rates, open futures bets, forced closes, and the market state signal. Includes source, as_of, and citation fields.

/api/agent/market-state
The Liquid State Index

A 0–100 market state score based on futures activity, blockchain activity, and market mood, with a label and timestamp.

/api/tools/liquid-state-index
Weekly liquidation report

Forced closes of long and short positions by asset, updated hourly.

Recent briefs

Recent headlines, categories, assets, summaries, and source links.

/api/agent/briefs
The Systems Desk — public paper-strategy record

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/summary
Calendar feeds

Subscribe from your calendar app for automatic updates.

Macro calendar

Upcoming CPI, FOMC, NFP, and PPI release dates — one iCalendar VEVENT per event.

/feeds/macro-calendar.ics
Options-expiry calendar

Upcoming BTC/ETH options expiries on Deribit — weekly, monthly, and quarterly.

/feeds/options-expiry-calendar.ics
Premium guide catalog 27 guides

The catalog is public; the guides are paid. Prices are listed in /api/agent/guides.

Journaling Mastery for Traders

38 pages · $29 · risk-management, position-sizing

Building a Personal Trading Strategy

44 pages · $29 · trend-following, risk-management

Mastering Market Heatmaps

26 pages · $19 · momentum, breakout

Trading with the Trend

32 pages · $19 · momentum, trend-following

Automate Your Trade Alerts

22 pages · $19 · trend-following, breakout

Reading Market Structure

40 pages · $29 · trend-following, breakout

Order Flow & Tape Reading

34 pages · $29 · momentum, breakout

On-Chain Analysis for Crypto Traders

38 pages · $29 · momentum, trend-following

Institutional & Smart Money Concepts

36 pages · $29 · trend-following, breakout

Backtesting & Strategy Validation

30 pages · $29 · trend-following

Short Selling Mechanics & Strategy

28 pages · $29 · risk-management

The Mathematics of Ruin

36 pages · $29 · risk-management, position-sizing

Operator Psychology

32 pages · $29 · risk-management

Mastering Volume Profiles

34 pages · $29 · momentum, breakout

Macro Overlay Systems

28 pages · $29 · trend-following

Exploiting Funding Rates

26 pages · $29 · momentum

Black Swans & Tail Risk Management

24 pages · $19 · risk-management, tail-risk, position-sizing

Altcoin Season Playbook

28 pages · $19 · momentum

Crypto Market Cycles & Halving

30 pages · $19 · momentum, trend-following

Managing Winning & Losing Streaks

22 pages · $19 · risk-management

Liquidation Cascades & Leverage Flushes

30 pages · $29 · risk-management, tail-risk

Crypto Options & Volatility Trading

34 pages · $29 · risk-management, tail-risk

Narrative & Catalyst Trading

28 pages · $29 · momentum, breakout

The Art of the Exit

26 pages · $19 · risk-management, position-sizing

Stablecoin Flows & Liquidity Tracking

28 pages · $29 · momentum

Correlation & Portfolio Construction

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.