← Back to Tools

Public Signal API

Free, public, no-key JSON endpoint for Liquid State’s aggregated crypto market regime signals. Pull the same data shown on the Signal Scorecard straight into your bot, dashboard, or newsletter.

Building something your own users pay for? Commercial access adds a licence, scoped keys and a rate limit set to your load. The free tier stays free.

FreeNo API key120 req/hr per IP

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"
}

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 for a GitHub README, forum post, or anywhere an <img> is allowed but JavaScript isn’t. No API key, no iframe — just an image URL.

crypto regime badgehttps://www.liquidstate.tech/badge/regime.svg
btc cycle badgehttps://www.liquidstate.tech/badge/cycle-phase.svg
funding regime badgehttps://www.liquidstate.tech/badge/funding.svg
stablecoin ssr badgehttps://www.liquidstate.tech/badge/ssr.svg
btc volatility badgehttps://www.liquidstate.tech/badge/dvol.svg

10-minute cache, updates automatically. Free for any use, attribution appreciated.

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) for any of five signals — no API key, no JavaScript, works anywhere images are allowed, including GitHub READMEs and forum posts.