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.

01 / Public data

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

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\"}}" }
    ]
  }
}
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, open interest, liquidations, and regime signal. Includes source, as_of, and citation fields.

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

A 0–100 market-regime score based on derivatives, on-chain data, and sentiment, with a label and timestamp.

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

Long and short liquidations 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.