Nomics Cryptocurrency & Bitcoin API (1.0.0)

Download OpenAPI specification:Download

Introduction

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.

API Server URL

The Nomics API runs at https://api.nomics.com/v1. All requests should be prefixed by the server URL.

Rate Limits

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.

Authentication

Key

You must include your API Key as a query parameter in every request you make.

For example:

https://api.nomics.com/v1/markets?key=your-key-here

Get your Nomics API key here

Security Scheme Type	API Key
Query parameter name:	key

Global

Global Ticker

Only available to paid API plans. Learn more.

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

Authorizations:

Key

query Parameters

convert

string

Example: convert=EUR

Currency to quote ticker price, market cap, and volume values. May be a Fiat Currency or Cryptocurrency. Default is USD.

Responses

Request samples

Shell
JavaScript
NodeJS
Ruby
Python

curl "https://api.nomics.com/v1/global-ticker?key=your-key-here"

Response samples

Content type

application/json

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

Global Volume History

Only available to paid API plans. Learn more.

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

Authorizations:

Key

query Parameters

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 `USD`.
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 `false`. This option is only available to customers of our paid API plans.

Responses

Request samples

Shell
JavaScript
NodeJS
Ruby
Python

curl "https://api.nomics.com/v1/volume/history?key=your-key-here&start=2018-04-14T00%3A00%3A00Z&end=2018-05-14T00%3A00%3A00Z&convert=EUR"

Response samples

Content type

[{"timestamp": "2018-04-14T00:00:00Z",
"volume": "10177952765",
"spot_volume": "7706914494",
"derivative_volume": "2471038271",
"transparent_volume": "6608950947",
"transparent_spot_volume": "4137912676",
"transparent_derivative_volume": "2471038271"
}
]

Global Market Cap History

Only available to paid API plans. Learn more.

MarketCap History is the total market cap for all cryptoassets at intervals between the requested time period.

Update Frequency: 1 hour

Authorizations:

Key

query Parameters

start required	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 ticker price, market cap, and volume values. May be a Fiat Currency or Cryptocurrency. Default is `USD`.
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 `false`. This option is only available to customers of our paid API plans.

Responses

Request samples

Shell
JavaScript
NodeJS
Ruby
Python

curl "https://api.nomics.com/v1/market-cap/history?key=your-key-here&start=2018-04-14T00%3A00%3A00Z&end=2018-05-14T00%3A00%3A00Z"

Response samples

Content type

[{"timestamp": "2018-07-05T15:00:00Z",
"market_cap": "269222501959",
"transparent_market_cap": "270122591259"
}
]

Currencies

Currency Metadata

Only available to paid API plans. Learn more.

The currencies endpoint returns all the currencies and their metadata that Nomics supports.

Update Frequency: 1 minute

Authorizations:

Key

query Parameters

ids	string Example: ids=BTC,ETH,XRP Comma separated list of Nomics Currency IDs to filter result rows
attributes	string Example: attributes=id,name,logo_url Comma separated list of currency attributes to filter result columns
format	string Value: "csv" Format of the response. Defaults to JSON when blank.
platform-currency	string Example: platform-currency=ETH Filter the results by parent platform.
platform-contract	string Filter the results by platform contract address.

Responses

Request samples

Shell
JavaScript
NodeJS
Ruby
Python

curl "https://api.nomics.com/v1/currencies?key=your-key-here&ids=BTC,ETH,XRP&attributes=id,name,logo_url&platform-currency=ETH"

Response samples

Content type