The Nomics API is a lightning fast REST and WebSocket JSON API.
Our API aspires to be the data backbone for developers and professional cryptoinvestors. Our product roadmap revolves around a “Triple A” feature set: our core product archives, aggregates, and analyzes both on- and off-blockchain cryptoasset data relevant to investors and traders.
The Nomics API provides:
- All trades and orders* on 30+ cryptocurrency exchanges (including historical trade data) behind one API
- Candlestick data for any time period
- Real-time and historical trade and order data*
- Price, market cap, supply, and all-time high data
- World class API documentation
- Service level agreements (SLAs) with uptime and response time guarantees
- Zapier and IFTTT integrations
- OpenAPI Specification and SDKs in many languages, such as JavaScript, Java, Go, Ruby, R, and C#.
- Rapid support turnaround times
If you’d like to be notified when our API is in private beta, please complete this form.
* Where available.
Proposed API Spec
The Nomics API is an HTTP+JSON API. There are a variety of endpoints for different types of data, with their own parameters and response types. All requests will require an authorization header with a valid API key.
The following parameters are used in the API:
- timestamp: unix epoch timestamp in seconds
- symbol: nomics currency symbol
- exchange: nomics exchange id
- market: exchange’s market id
Aggregated Candles
/candles/:currency/:interval?start=<timestamp>&end=<timestamp> [{open, high, low, close, volume, timestamp}, …]
Candles for the given currency starting from the given timestamp and ending at the given timestamp. :interval is part of the url and is one of [1m, 5m, 30m, 1h, 1d]. There will be a maximum limit to the number of candles returned at a time TBD.
open and close are Volume Weighted Average Prices (VWAP). high and low are the maximum and minimum prices across all exchanges for the given time period.
All fields are in USD (except timestamp, which is unix epoch seconds). To convert to other currencies see the fiat exchange rate API endpoint.
Exchange Candles
/exchange_candles/:exchange/:market/:interval?start=<timestamp>&end=<timestamp> [{open, high, low, close, volume, timestamp}, …]
Candles for the given exchange and market. For valid exchange and market IDs see the relevant API end points. Maximum limit TBD.
open is the first trade price for the period, close is the last trade price, high is the highest trade price, low is the lowest trade price. All prices are in the market’s quote currency. volume is in the market’s base currency. timestamp is unix epoch seconds.
Trades
/trades/:exchange/:market?start=<timestamp>&end=<timestamp>&from=<id>&to=<id>
[{id, timestamp, price, volume}, …]
Individual trades for the given exchange and market. start and end can be provided as a unix timestamp. This will most likely be in microseconds. from and to are trade ids for more convenient paging if desired. Maximum limit TBD.
Price is in the market’s quote currency, volume is in the market’s base currency.
Exchange Rates
/exchange_rates?start=<timestamp&end=<timestamp> [{currency, rate}, …]
Exchange rates for the given time period. One rate is returned per day within the time period. Currencies are top fiat currencies as well as BTC (using a VWAP closing price for the day).
rate is the amount of USD equivalent to one unit of the currency.
This endpoint is intended to be used to convert candles from USD to other fiat currencies and BTC, as well as convert many exchange candles and trades into other fiat currencies and from BTC.
Markets
/markets
[{exchange, market, base_currency, quote_currency}, …]
A list of Nomics exchange and market IDs to be used in other API endpoints. The market ID is the native ID used by the exchange’s own API, and can also be used in Nomics API calls. The base_currency and quote_currency are Nomics currency identifiers to be used in Nomics API calls (and also as identifiers for exchange rates).
Get Notified When Our API Becomes Available
If you’d like to be alerted when we open up our API beta program, please complete this form.