Developers

Obsavia market data API

A small public interface for the Obsavia markets. Read the live price, the twenty four hour range and the traded volume for any market over plain HTTPS, or stream the same figures live over a websocket. Every response is Obsavia data in the Obsavia format. No key is needed to read the market.

HTTPS basehttps://obsavia.com/md/
Streamwss://obsavia.com/ws/feed

Endpoints

Two read only endpoints cover the public market data. The symbol is the lower case base asset, for example btc. Responses are JSON and refresh every second or two.

GET/md/markets

Every Obsavia market in one call, each with its live figures.

// GET https://obsavia.com/md/markets
{ "exchange": "Obsavia", "quote": "USDT", "count": 174,
  "markets": [
    { "market": "BTC/USDT", "last": 84120.5, "open": 83980.1,
      "high": 84990.0, "low": 83110.0, "changePercent": 0.17,
      "baseVolume": 311.4, "quoteVolume": 26140880.0, "trades": 0 } ] }
GET/md/market?symbol=btc

One market on its own, the same fields as a row above.

// GET https://obsavia.com/md/market?symbol=btc
{ "exchange": "Obsavia", "market": "BTC/USDT", "last": 84120.5,
  "open": 83980.1, "high": 84990.0, "low": 83110.0,
  "changePercent": 0.17, "baseVolume": 311.4,
  "quoteVolume": 26140880.0, "trades": 0 }
marketThe pair, base over quote, for example BTC/USDT.
lastThe latest traded price.
open / high / lowThe twenty four hour open, high and low.
changePercentThe move over the last twenty four hours as a percent.
baseVolumeVolume in the base asset over twenty four hours.
quoteVolumeVolume in the quote asset over twenty four hours.
tradesTrade count over the window.

Streaming

Open the websocket, subscribe, then receive a message per update in milliseconds. Each message names its stream and carries the market figures.

ws = new WebSocket("wss://obsavia.com/ws/feed");
ws.onopen = () => ws.send(JSON.stringify({ "sub": ["all@ticker"] }));
ws.onmessage = (e) => { const m = JSON.parse(e.data); // { stream, data } };

Subscribe to one market

Send {"sub":["btc@ticker"]} for a single market, or all@ticker for the whole board in one stream.

Depth and trades

Order book and trade streams are available per market as btc@depth and btc@trades for partners building a live book.

Access

Public and free

The market data endpoints are open and read only. No key, no sign in, quoted in USDT, every listed Obsavia market included.

Partners and market makers

Dedicated market maker streams and APIs for a listed token are set up privately with that project. They are not published here.

Need more than the public data

For higher limits, a commercial data plan, market maker access for a listing, or programmatic trading, talk to us and we will set up a plan that fits.

Contact support