Open the Desk Join The Feed — $25
← Back to Tools

Developers.

The free Public Signal API. Regime JSON, no key.

curl https://www.liquidstate.tech/api/v1/signals

GET /api/v1/signals

GET https://www.liquidstate.tech/api/v1/signals
{
  "ok": true,
  "version": "v1",
  "source": "liquidstate.tech",
  "updatedAt": "2026-06-30T19:00:00.000Z",
  "signals": [
    {
      "key": "barometer",
      "name": "Systematic Market Barometer",
      "label": "Risk-On",
      "value": "72/100",
      "url": "https://www.liquidstate.tech/tools/market-barometer"
    }
  ],
  "attribution": "Data via Liquid State (https://www.liquidstate.tech) — free for non-commercial use; attribution appreciated.",
  "docs": "https://www.liquidstate.tech/developers"
}

Notes

  • 10-minute server-side cache — poll no more than once every few minutes; the underlying data doesn’t refresh faster than that.
  • Rate-limited to 120 requests/hour per IP, best-effort.
  • Information only — not financial advice. Every signal links back to its full live tool page for methodology.
  • Attribution appreciated (see the attribution field) but not required.

Status badges

Live SVG badges, including /badge/record.svg for the legacy paper record. No API key. 10-minute cache.

The record badge describes a legacy paper-strategy record. Its day count measures elapsed time since the supplied sinceDate, not recorded observations or uninterrupted operation. Continuity is unverified; it is not evidence of live-capital results or paid stance outcomes.

Optional API key: no key at 120 requests/hour. A free email registration raises the limit to 1,000 requests/hour.

Join The Feed — $25 · Join The Reserve

Feed comparison for entitled agents is in the material-change guide. Contract: OpenAPI. Agent desk: /agents, desk tape, MCP /api/mcp.

Platform status

Check the live status of the market data feed and this API before you assume an error is on your end — JSON at /api/status, or an embeddable badge.

View platform status →

Get a free API key

Optional — the endpoint above works with no key at 120 req/hr. Register a free email for a personal key at 1,000 req/hr.

Already have a key? Check your usage →

FAQ

Is the Liquid State Signal API free?
Yes. GET /api/v1/signals is free, public, and requires no API key. It is rate-limited to 120 requests/hour per IP as a soft abuse deterrent.
What data does the Signal API return?
The current regime label and value for every signal in the Liquid State Signal Scorecard — market barometer, BTC cycle phase, funding rate regime, market breadth, BTC dominance rotation, altcoin season, stablecoin supply ratio, mempool congestion, implied volatility, and DeFi TVL regime — each with a link back to its full live tool page.
Do I need to attribute Liquid State when using this data?
Attribution is appreciated but not enforced. The response includes an `attribution` field with suggested credit text and a link back to liquidstate.tech.
Do I need an API key to use the Signal API?
No — the endpoint works with no key at 120 requests/hour. Registering a free API key with an email raises the limit to 1,000 requests/hour.
Can I embed a live status badge in my GitHub README?
Yes. GET /badge/<metric>.svg returns a live, shields.io-style SVG image (e.g. /badge/regime.svg, or /badge/record.svg for elapsed days since the legacy paper record’s sinceDate, not recorded observation count or verified continuity) for any of six metrics — no API key, no JavaScript, works anywhere images are allowed, including GitHub READMEs and forum posts.