Download OpenAPI specification:Download
Welcome to the Nomics Cryptocurrency & Bitcoin API. To sign up for an API key please go here.
nomics.com is built entirely with the Nomics API. Everything we've done on nomics.com you can do with our API. There are no internal API endpoints.
If you need support, reach out to us at our forums.
The Nomics API runs at https://api.nomics.com/v1
. All requests should be prefixed
by the server URL.
By default free keys have a rate limit of one request per second (1rps). Commercial keys have their rate limits determined by their plan and/or contract. Rate limits are computed on one second intervals.
If you exceed your rate limit during the interval you will receive an HTTP 429 error and your API key will be timed out for a short period of time.
You must include your API Key as a query parameter in every request you make.
For example:
Security Scheme Type | API Key |
---|---|
Query parameter name: | key |
Price, volume, market cap, rank, and more for all currencies across 1 hour, 1 day, 7 day, 30 day, 365 day, and year to date intervals.
Usage on this endpoint is counted towards commercial plan API requests.
Update Frequency: 30 seconds
ids | string Example: ids=BTC,ETH,XRP Comma separated list of Nomics Currency IDs to filter result rows |
interval | string Enum: "1h" "1d" "7d" "30d" "365d" "ytd" Example: interval=1d,30d Comma separated time interval of the ticker(s). Default is |
quote-currency | string Deprecated Example: quote-currency=EUR Currency to quote ticker price, market cap, and volume values. Must be a valid currency from Fiat Exchange Rates. Default is |
convert | string Example: convert=EUR Currency to quote ticker price, market cap, and volume values. May be a Fiat Currency or Cryptocurrency. Default is |
status | string Enum: "active" "inactive" "dead" Status by which to filter currencies. If not provided, all currencies are shown. |
filter | string Enum: "any" "new" Further filter the set of currencies. The |
platform-currency | string Example: platform-currency=ETH Filter the results by parent platform. |
sort | string Enum: "rank" "first_priced_at" How to sort the returned currencies. |
include-transparency | boolean Whether to include Transparent Volume and transparent market cap information in the response. Default is |
per-page | integer Default: 100 Example: per-page=100 The maximum number of items to return per paginated response.
Paginated responses include an additional response header,
|
page | integer Example: page=1 Which page of items to get. |
curl "https://api.nomics.com/v1/currencies/ticker?key=your-key-here&ids=BTC,ETH,XRP&interval=1d,30d&convert=EUR&platform-currency=ETH&per-page=100&page=1"
[- {
- "currency": "BTC",
- "id": "BTC",
- "status": "active",
- "price": "8451.36516421",
- "price_date": "2019-06-14T00:00:00Z",
- "price_timestamp": "2019-06-14T12:35:00Z",
- "symbol": "BTC",
- "circulating_supply": "17758462",
- "max_supply": "21000000",
- "name": "Bitcoin",
- "market_cap": "150083247116.70",
- "market_cap_dominance": "0.4080",
- "transparent_market_cap": "150003247116.70",
- "num_exchanges": "357",
- "num_pairs": "42118",
- "num_pairs_unmapped": "4591",
- "first_candle": "2011-08-18T00:00:00Z",
- "first_trade": "2011-08-18T00:00:00Z",
- "first_order_book": "2017-01-06T00:00:00Z",
- "first_priced_at": "2017-08-18T18:22:19Z",
- "rank": "1",
- "rank_delta": "0",
- "high": "19404.81116899",
- "high_timestamp": "2017-12-16",
- "1d": {
- "price_change": "269.75208019",
- "price_change_pct": "0.03297053",
- "volume": "1110989572.04",
- "volume_change": "-24130098.49",
- "volume_change_pct": "-0.02",
- "market_cap_change": "4805518049.63",
- "market_cap_change_pct": "0.03",
- "transparent_market_cap_change": "4800518049.00",
- "transparent_market_cap_change_pct": "0.0430",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "2144455081.37",
- "volume_change": "-235524941.08",
- "volume_change_pct": "-0.10"
}, - {
- "grade": "B",
- "volume": "15856762.85",
- "volume_change": "-6854329.88",
- "volume_change_pct": "-0.30"
}
]
}
}
]
Globally-aggregated market cap and volume data over various intervals across all currencies.
The total volume
fields are computed by summing the
spot_volume
and derivative_volume
fields at each interval.
Update Frequency: 5 minutes
convert | string Example: convert=EUR Currency to quote ticker price, market cap, and volume values. May be a Fiat Currency or Cryptocurrency. Default is |
curl "https://api.nomics.com/v1/global-ticker?key=your-key-here"
{- "num_currencies": "12801",
- "num_currencies_active": "5277",
- "num_currencies_inative": "6337",
- "num_currencies_dead": "1187",
- "num_currencies_new": "312",
- "market_cap": "1799044056712",
- "transparent_market_cap": "1759092897670",
- "1d": {
- "market_cap_change": "12684321666",
- "market_cap_change_pct": "0.0071",
- "transparent_market_cap_change": "9913761626",
- "transparent_market_cap_change_pct": "0.0057",
- "volume": "261184503290.13",
- "volume_change": "-36297038690.90",
- "volume_change_pct": "-0.1220",
- "spot_volume": "183847018626.59",
- "spot_volume_change": "-21057431830.52",
- "spot_volume_change_pct": "-0.1028",
- "derivative_volume": "77337484663.54",
- "derivative_volume_change": "-15239606860.37",
- "derivative_volume_change_pct": "-0.1646",
- "transparent_volume": "83650606519.52",
- "transparent_volume_change": "-13318816933.73",
- "transparent_volume_change_pct": "-0.1374",
- "transparent_spot_volume": "35168278207.40",
- "transparent_spot_volume_change": "-4606944979.20",
- "transparent_spot_volume_change_pct": "-0.1158",
- "transparent_derivative_volume": "48482328312.12",
- "transparent_derivative_volume_change": "-8711871954.54",
- "transparent_derivative_volume_change_pct": "-0.1523",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "83650606519.52",
- "volume_change": "-13318816933.73",
- "volume_change_pct": "-0.1374"
}, - {
- "grade": "B",
- "volume": "466859661.78",
- "volume_change": "-104098455.53",
- "volume_change_pct": "-0.1823"
}
]
}, - "7d": {
- "market_cap_change": "12684321666",
- "market_cap_change_pct": "0.0071",
- "transparent_market_cap_change": "9913761626",
- "transparent_market_cap_change_pct": "0.0057",
- "volume": "261184503290.13",
- "volume_change": "-36297038690.90",
- "volume_change_pct": "-0.1220",
- "spot_volume": "183847018626.59",
- "spot_volume_change": "-21057431830.52",
- "spot_volume_change_pct": "-0.1028",
- "derivative_volume": "77337484663.54",
- "derivative_volume_change": "-15239606860.37",
- "derivative_volume_change_pct": "-0.1646",
- "transparent_volume": "83650606519.52",
- "transparent_volume_change": "-13318816933.73",
- "transparent_volume_change_pct": "-0.1374",
- "transparent_spot_volume": "35168278207.40",
- "transparent_spot_volume_change": "-4606944979.20",
- "transparent_spot_volume_change_pct": "-0.1158",
- "transparent_derivative_volume": "48482328312.12",
- "transparent_derivative_volume_change": "-8711871954.54",
- "transparent_derivative_volume_change_pct": "-0.1523",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "83650606519.52",
- "volume_change": "-13318816933.73",
- "volume_change_pct": "-0.1374"
}, - {
- "grade": "B",
- "volume": "466859661.78",
- "volume_change": "-104098455.53",
- "volume_change_pct": "-0.1823"
}
]
}, - "30d": {
- "market_cap_change": "12684321666",
- "market_cap_change_pct": "0.0071",
- "transparent_market_cap_change": "9913761626",
- "transparent_market_cap_change_pct": "0.0057",
- "volume": "261184503290.13",
- "volume_change": "-36297038690.90",
- "volume_change_pct": "-0.1220",
- "spot_volume": "183847018626.59",
- "spot_volume_change": "-21057431830.52",
- "spot_volume_change_pct": "-0.1028",
- "derivative_volume": "77337484663.54",
- "derivative_volume_change": "-15239606860.37",
- "derivative_volume_change_pct": "-0.1646",
- "transparent_volume": "83650606519.52",
- "transparent_volume_change": "-13318816933.73",
- "transparent_volume_change_pct": "-0.1374",
- "transparent_spot_volume": "35168278207.40",
- "transparent_spot_volume_change": "-4606944979.20",
- "transparent_spot_volume_change_pct": "-0.1158",
- "transparent_derivative_volume": "48482328312.12",
- "transparent_derivative_volume_change": "-8711871954.54",
- "transparent_derivative_volume_change_pct": "-0.1523",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "83650606519.52",
- "volume_change": "-13318816933.73",
- "volume_change_pct": "-0.1374"
}, - {
- "grade": "B",
- "volume": "466859661.78",
- "volume_change": "-104098455.53",
- "volume_change_pct": "-0.1823"
}
]
}, - "365d": {
- "market_cap_change": "12684321666",
- "market_cap_change_pct": "0.0071",
- "transparent_market_cap_change": "9913761626",
- "transparent_market_cap_change_pct": "0.0057",
- "volume": "261184503290.13",
- "volume_change": "-36297038690.90",
- "volume_change_pct": "-0.1220",
- "spot_volume": "183847018626.59",
- "spot_volume_change": "-21057431830.52",
- "spot_volume_change_pct": "-0.1028",
- "derivative_volume": "77337484663.54",
- "derivative_volume_change": "-15239606860.37",
- "derivative_volume_change_pct": "-0.1646",
- "transparent_volume": "83650606519.52",
- "transparent_volume_change": "-13318816933.73",
- "transparent_volume_change_pct": "-0.1374",
- "transparent_spot_volume": "35168278207.40",
- "transparent_spot_volume_change": "-4606944979.20",
- "transparent_spot_volume_change_pct": "-0.1158",
- "transparent_derivative_volume": "48482328312.12",
- "transparent_derivative_volume_change": "-8711871954.54",
- "transparent_derivative_volume_change_pct": "-0.1523",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "83650606519.52",
- "volume_change": "-13318816933.73",
- "volume_change_pct": "-0.1374"
}, - {
- "grade": "B",
- "volume": "466859661.78",
- "volume_change": "-104098455.53",
- "volume_change_pct": "-0.1823"
}
]
}, - "ytd": {
- "market_cap_change": "12684321666",
- "market_cap_change_pct": "0.0071",
- "transparent_market_cap_change": "9913761626",
- "transparent_market_cap_change_pct": "0.0057",
- "volume": "261184503290.13",
- "volume_change": "-36297038690.90",
- "volume_change_pct": "-0.1220",
- "spot_volume": "183847018626.59",
- "spot_volume_change": "-21057431830.52",
- "spot_volume_change_pct": "-0.1028",
- "derivative_volume": "77337484663.54",
- "derivative_volume_change": "-15239606860.37",
- "derivative_volume_change_pct": "-0.1646",
- "transparent_volume": "83650606519.52",
- "transparent_volume_change": "-13318816933.73",
- "transparent_volume_change_pct": "-0.1374",
- "transparent_spot_volume": "35168278207.40",
- "transparent_spot_volume_change": "-4606944979.20",
- "transparent_spot_volume_change_pct": "-0.1158",
- "transparent_derivative_volume": "48482328312.12",
- "transparent_derivative_volume_change": "-8711871954.54",
- "transparent_derivative_volume_change_pct": "-0.1523",
- "volume_transparency": [
- {
- "grade": "A",
- "volume": "83650606519.52",
- "volume_change": "-13318816933.73",
- "volume_change_pct": "-0.1374"
}, - {
- "grade": "B",
- "volume": "466859661.78",
- "volume_change": "-104098455.53",
- "volume_change_pct": "-0.1823"
}
]
}
}
Volume History is the total volume for all cryptoassets in USD
at intervals between the requested time period. For each
entry, the volume
field represents the sum of the
spot_volume
and derivative_volume
fields.
Update Frequency: 1 hour
start | string Example: start=2018-04-14T00%3A00%3A00Z Start time of the interval in RFC3339 (URI escaped) |
end | string Example: end=2018-05-14T00%3A00%3A00Z End time of the interval in RFC3339 (URI escaped). If not provided, the current time is used. |
convert | string Example: convert=EUR Currency to quote volume values. May be a Fiat Currency or Cryptocurrency. Default is |
format | string Value: "csv" Format of the response. Defaults to JSON when blank. |
include-transparency | boolean Whether to include Transparent Volume and transparent market cap information in the response. Default is |