← Back to Tools

Developers.

The free Public Signal API. Market-state JSON, no key.

Quickstart

TimeAbout 2 minutes
  1. Call the endpoint

    No account and no key. Pick a language and run it.

    curl https://www.liquidstate.tech/api/v1/signals
  2. Read the reply

    Each item in signals has a name, a label (the current reading), a value and a url to the full tool. The full example is under Signals endpoint.

  3. Check back every few minutes

    The data is cached for 10 minutes, so asking more often returns the same reply.

GET /api/v1/signals

Endpoint
GET https://www.liquidstate.tech/api/v1/signals
Example response
{
  "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"
}

Limits and terms

  • 10-minute server-side cache. Poll no more than once every few minutes; the underlying data does not refresh faster than that.
  • 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.

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

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.

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

Feed and agents

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

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.