API Documentation

The AsherCore API is a plain HTTPS + JSON interface to our market-data platform and to Asher Wire, our news feed. Every endpoint is a GET, every response is JSON, and the base URL is https://ashercore.com. No SDK required.

Introduction

AsherCore serves normalized market data — OHLCV candles, live prices, funding rates, order books and a full instrument catalog — across crypto, equities and forex, all from our own store. Bundled with it on every plan is Asher Wire: a news feed where each story carries a machine-readable market signal. One key spans every asset class and the news about them.

Copy# The canonical "hello world" — 3 hourly BTC candles
curl "https://ashercore.com/api/market/candles?coin=BTC&interval=1h&limit=3" \
  -H "Authorization: Bearer YOUR_ASHERCORE_KEY"

Authentication

Authenticate every request with your API key, available in your dashboard. Pass it either as a bearer token in the Authorization header (recommended) or as a key query parameter.

Copy# Header (preferred)
-H "Authorization: Bearer core_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# …or query param
?key=core_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate limits & quotas

Each plan sets a monthly call quota and a per-second burst limit. Every response carries the limit headers, whether it succeeded or not:

Exceeding either limit returns 429; an unrecognised key returns 401.

Errors

AsherCore uses standard HTTP status codes. Error bodies carry an error string.

Candles

OHLCV candles for any instrument, at the native base interval resampled to your requested timeframe.

Copy// Response
{
  "coin": "BTC",
  "interval": "1h",
  "exchange": "Binance",
  "source": "Binance Spot",
  "candles": [
    { "time": 1723420800, "open": 61240.1, "high": 61510.0,
      "low": 61180.4, "close": 61432.7, "volume": 812.44 }
  ]
}

Catalog

The full instrument universe — every symbol we ingest, pre-tagged with venue and asset class. No parameters. Cached ~5 minutes.

Copy{ "updated": 1723420800000, "count": 2506,
  "coins": [ { "symbol": "BTC", "venue": "binance", "class": "crypto" } ] }

Coins

The fast, cached snapshot of priced majors — last price and change for the top instruments. Ideal for a default watchlist view.

Quote

Latest quote for a single instrument.

Mids

Live mid prices — the low-latency map of ticker → price for building tickers and dashboards.

Funding

Perpetual funding rates by instrument. Pair with /api/market/funding-radar for a ranked, cross-venue view of the richest funding.

Order book

Order-book depth snapshot for an instrument (bids/asks). Growth plan and above.

Screener

A ranked, filterable slice of the universe — perfect for discovery UIs and dynamic watchlists.

Venues

The venues we ingest and their coverage metadata — use the returned ids as the venue parameter on /api/market/candles.

Asher Wire

Asher Wire is our own newsroom feed, included on every AsherCore plan — no separate news subscription, no separate key, and it draws from the same monthly quota as the market-data endpoints.

The pipeline runs continuously: we ingest markets, economy, crypto and tech sources, write an original brief for each story in English and Spanish, and attach a structured market signal — a bias, the assets the story moves, and the reasoning behind it. That last part is why Wire sits inside a market-data API rather than beside one: the signal is machine-readable, so you can join it to the same symbol you pull candles for.

Copy# The whole product in one call — what's moving, and which way
curl "https://ashercore.com/api/wire/signals?limit=5" \
  -H "Authorization: Bearer YOUR_ASHERCORE_KEY"

Wire · Filters & streams

You should not have to take the firehose. Every filter below applies to the same normalized record, and both /api/wire/headlines and /api/wire/signals accept the full set — so a filtered feed and its signal board always agree.

Filtered responses report scanned and matched alongside count, so you can always see how much of the wire your filter actually kept.

Streams — configure once, call one URL

A stream is a saved filter set encoded into a token. Mint one from /api/wire/stream (GET with filters, or POST a JSON body), then pass ?stream= to any Wire endpoint instead of re-sending a dozen params. Explicit params still win, so you can reuse a stream and tweak one knob.

Copy# 1. configure
curl "https://ashercore.com/api/wire/stream?category=crypto&assets=BTC,ETH&bias=bullish&exclude_duplicates=1"

# → { "stream": "st_eyJjYXRlZ29yeSI6…",
#     "describes": "Wire stories: crypto; mentioning BTC, ETH; bullish only.",
#     "urls": { "headlines": "…", "signals": "…" } }

# 2. use it — forever
curl "https://ashercore.com/api/wire/headlines?stream=st_eyJjYXRlZ29yeSI6…" \
  -H "Authorization: Bearer YOUR_ASHERCORE_KEY"

# 3. inspect one you were handed
curl "https://ashercore.com/api/wire/stream?stream=st_eyJjYXRlZ29yeSI6…"

Wire · Live push (SSE)

Polling is the wrong shape for news — you either hammer the endpoint or you're late. /api/wire/live is the same wire, pushed, over Server-Sent Events. It takes the identical filter surface, ?stream= included, so a configured stream can be consumed live without re-stating a single filter.

Copy# watch it in a terminal
curl -N "https://ashercore.com/api/wire/live?category=crypto&bias=bullish&backfill=5" \
  -H "Authorization: Bearer YOUR_ASHERCORE_KEY"

Copy// browser — reconnection and resume are handled for you
const es = new EventSource("https://ashercore.com/api/wire/live?stream=st_…");
es.addEventListener("story", (e) => {
  const a = JSON.parse(e.data);
  console.log(a.headline, a.signal?.bias, a.signal?.assets);
});

Copy# python
import httpx, json
with httpx.stream("GET", "https://ashercore.com/api/wire/live?assets=BTC",
                  headers={"Authorization": "Bearer YOUR_ASHERCORE_KEY"}, timeout=None) as r:
    for line in r.iter_lines():
        if line.startswith("data: "):
            print(json.loads(line[6:]).get("headline"))

Wire · Headlines

The live wire, newest first. Passing q or page switches the query to the rolling archive instead of the current feed.

Copy# Response
{
  "source": "wire", "updated": "2026-08-17T02:01:48.763Z", "count": 20,
  "articles": [{
    "id": "1sn2dq9",
    "headline": "Oil Flat Amid Stalled Iran Talks, Hormuz Shipping Strain",
    "summary": "…", "category": "markets", "source": "NDTV Profit",
    "url": "https://…", "image": "", "published": "…", "lead": true, "lang": "en",
    "signal": { "bias": "neutral", "assets": ["Oil", "Brent Crude"], "rationale": "…" }
  }]
}

Wire · Signals

Per-asset rollup of the wire's signals. Each row is an asset with a net score from −1 (uniformly bearish coverage) to +1 (uniformly bullish), the breakdown of story biases behind it, and the stories themselves.

Copy{
  "updated": "…", "articles": 20, "signalled": 17, "count": 5,
  "assets": [{
    "asset": "Oil", "mentions": 4, "score": -0.25, "bias": "bearish",
    "breakdown": { "bullish": 1, "bearish": 2, "neutral": 1, "mixed": 0 },
    "articles": [{ "id": "…", "headline": "…", "bias": "bearish", "rationale": "…" }]
  }]
}

Wire · Article

Fetch a story by id — one, or up to 25 comma-separated. Returns article (the first match) and articles (all matches). Responds 404 when nothing matches.

Wire · Calendar

The economic calendar — upcoming and just-released events with impact rating and forecast / previous / actual, so you can line a print up against the candle that reacted to it.