API Key
Documentation Powered by Redocly

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

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.

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

Currencies Ticker

Currencies Ticker

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

Authorizations:
Key
    query Parameters
    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 1d,7d,30d,365d,ytd.

    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 USD.

    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.

    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 new filter returns currencies that have recently been priced by Nomics and any returns currencies regardless of their state. The any filer may be used to retrieve new-but-stale currencies that are listed under new, but are no longer active.

    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. rank sorts by rank ascending and first_priced_at sorts by when each currency was first priced by Nomics descending. Only currencies priced after 2020-10-08 have a first_priced_at value so all other currencies have the same weight within the sort.

    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.

    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, X-Pagination-Total-Items, which represents the total number of items available after all the request filters have been applied. Must be between 1 and 100 (inclusive).

    page
    integer
    Example: page=1

    Which page of items to get.

    Responses

    Request samples 

    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"

    Response samples

    Content type
    application/json
    [
    • {
      }
    ]

    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 

      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": {
        },
      • "7d": {
        },
      • "30d": {
        },
      • "365d": {
        },
      • "ytd": {
        }
      }

      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