Nownodes Documentation

https://nownodes.gitbook.io/documentation-1
Admin
Nownodes provides a fast, reliable, and affordable API service for accessing various blockchain...
Tokens:5,055
Snippets:25
Trust Score:10
Update:1 year ago
Show doc for...
Tokens:
Raw
### Getting Started with NOWNodes API Key

Source: https://nownodes.gitbook.io/documentation-1/welcome-to-nownodes-docs/how-to-get-started-with-nownodes-api-key

To use the NOWNodes API, you need to sign up, choose a plan, and create an API key. The key can be included in your request URL or header.

```APIDOC
## Getting Started with NOWNodes API Key

### Description
Steps to get started with the NOWNodes API, including signing up, selecting a plan, and generating an API key. Instructions on how to incorporate the API key into your requests are also provided.

### Method
POST (for signup/plan selection, implicit)
GET (for API key retrieval, implicit)

### Endpoint
Not directly applicable for the initial setup process, but API requests will use specific blockchain endpoints.

### Parameters
(No direct parameters for this documentation section as it describes a process)

### Request Example
**Example of an API request using the API key in the URL:**
```curl
curl --location 'https://eth.nownodes.io/your_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 83
}'
```

### Response
(Response details depend on the specific API call made after obtaining the key)

**Contact:** For assistance, contact sales@nownodes.io.
```

--------------------------------

### Get Fiat Rates (Python)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/rates

Python code example to fetch fiat currency exchange rates from the /v1/rates endpoint. It uses the 'requests' library to make a GET request with the necessary API key in the headers.

```python
import requests

url = "https://fiat-rates.nownodes.io/v1/rates"
headers = {
    "api-key": "YOUR_API_KEY",
    "Accept": "*/*"
}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")

```

--------------------------------

### Get Price Data (cURL)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/price

Example of how to fetch price data using cURL. Requires specifying the 'from' and 'to' currencies and your API key.

```shell
GET /api/v1/price HTTP/1.1
Host: market-data.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
```

--------------------------------

### Monitoring API Example Response (JSON)

Source: https://nownodes.gitbook.io/documentation-1/monitoring

An example of a successful response from the Monitoring API, detailing the status, height, and height deviation for different node interfaces.

```json
{
    "vc": [
        {
            "interface": "vinu",
            "height": 8343518,
            "heightDeviation": 1,
            "status": "ok"
        }
    ],
    "dot": [
        {
            "interface": "dot-playbook",
            "height": 27621669,
            "heightDeviation": 0,
            "status": "ok"
        },
        {
            "interface": "dot",
            "height": 27621671,
            "heightDeviation": 0,
            "status": "ok"
        }
    ]
}
```

--------------------------------

### Fetch Market Data (JavaScript)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/market-data

Demonstrates how to make a GET request to the Market Data API using JavaScript. This example assumes the use of a library like `axios` or the built-in `fetch` API to handle the HTTP request. It requires setting the 'api-key' header.

```javascript
// Example using fetch (requires YOUR_API_KEY and parameters like 'from', 'to')
fetch('https://market-data.nownodes.io/api/v1/market-data?from=btc&to=eth', {
  method: 'GET',
  headers: {
    'api-key': 'YOUR_API_KEY'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

```

--------------------------------

### Get Currencies List (cURL)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/currencies

Example of how to retrieve a list of supported fiat and crypto currencies using cURL. It requires an API key for authorization.

```shell
GET /v1/currencies HTTP/1.1
Host: fiat-rates.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
```

--------------------------------

### Get Currencies List (Python)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/currencies

Example of how to retrieve a list of supported fiat and crypto currencies using Python. It requires an API key for authorization.

```python
# Python example would typically involve the requests library.
# Placeholder for actual Python code.
```

--------------------------------

### Get Fiat Rates (cURL)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/rates

Example cURL command to fetch fiat currency rates using the /v1/rates endpoint. Requires an API key for authentication. It demonstrates the GET request structure and headers.

```curl
GET /v1/rates HTTP/1.1
Host: fiat-rates.nownodes.io
api-key: YOUR_API_KEY
Accept: */*


```

--------------------------------

### Get NOWNodes API Key using cURL

Source: https://nownodes.gitbook.io/documentation-1/welcome-to-nownodes-docs/how-to-get-started-with-nownodes-api-key

This snippet demonstrates how to make a request to the NOWNodes API using cURL to get the block number. It requires a valid API key and specifies the request body format.

```curl
curl --location 'https://eth.nownodes.io/your_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 83
}'
```

--------------------------------

### Get Price Data (Python)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/price

Example of how to fetch price data using Python's requests library. Ensure you replace 'YOUR_API_KEY' with your actual API key and provide the 'from' and 'to' currency parameters.

```python
import requests

url = "https://market-data.nownodes.io/api/v1/price"
api_key = "YOUR_API_KEY"

headers = {
    "api-key": api_key
}

params = {
    "from": "YOUR_CURRENCY",
    "to": "YOUR_CURRENCY"
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
```

--------------------------------

### Get Currencies List (JavaScript)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/currencies

Example of how to retrieve a list of supported fiat and crypto currencies using JavaScript. It requires an API key for authorization.

```javascript
// JavaScript example would typically involve a fetch or axios request.
// Placeholder for actual JavaScript code.
```

--------------------------------

### Get Price Data (JavaScript)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/price

Example of how to fetch price data using JavaScript's fetch API. You'll need to replace 'YOUR_API_KEY' with your actual API key and specify the 'from' and 'to' parameters.

```javascript
fetch('https://market-data.nownodes.io/api/v1/price?from=YOUR_CURRENCY&to=YOUR_CURRENCY', {
    method: 'GET',
    headers: {
        'api-key': 'YOUR_API_KEY'
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```

--------------------------------

### Fetch Market Data (cURL)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/market-data

Example of how to fetch market data using cURL. Requires specifying 'from' and 'to' currencies or contract addresses, and optionally date ranges. An API key is necessary for authorization.

```shell
GET /api/v1/market-data HTTP/1.1
Host: market-data.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

```

--------------------------------

### Using Dedicated Node Credentials with cURL

Source: https://nownodes.gitbook.io/documentation-1/welcome-to-nownodes-docs/dedicated-nodes-aka-custom-nodes

This example demonstrates how to connect to a dedicated node using cURL, including authentication with login and password, and sending a JSON-RPC request to get the block number. It highlights the importance of including credentials before the domain name.

```shell
curl --location 'https://{login}:{password}@{domain_name}' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 83
}'
```

--------------------------------

### Price API Response Structure

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/price

Example of a successful JSON response from the Price API. It includes the exchange rate and currency details.

```json
{
  "code": "text",
  "result": [
    {
      "quotes": {
        "rate": 1,
        "to_currency": "text"
      },
      "from_currency": "text"
    }
  ],
  "error": "text"
}
```

--------------------------------

### GET /v1/currencies

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/currencies

Fetches a list of supported fiat and crypto currencies. Supports filtering by currency type and pagination.

```APIDOC
## GET /v1/currencies

### Description
Retrieves a list of supported crypto and fiat currencies.

### Method
GET

### Endpoint
https://fiat-rates.nownodes.io/v1/currencies

### Parameters
#### Query Parameters
- **type** (string) - Optional - Type of currencies (fiat or crypto). Possible values: `fiat`, `crypto`, `all`
- **page** (number) - Optional - Pagination number
- **pageSize** (number) - Optional - Limit number of rows per page

### Request Example
```http
GET /v1/currencies HTTP/1.1
Host: fiat-rates.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
```

### Response
#### Success Response (200)
- **pagination** (object) - Pagination details.
  - **page** (text)
  - **pageCount** (text)
  - **pageSize** (text)
- **data** (array) - List of currencies.
  - **id** (text)
  - **code** (text)
  - **name** (text)
  - **usdRate** (number)
  - **isFiat** (boolean)

#### Response Example
```json
{
  "pagination": {
    "page": "text",
    "pageCount": "text",
    "pageSize": "text"
  },
  "data": [
    {
      "id": "text",
      "code": "text",
      "name": "text",
      "usdRate": 1,
      "isFiat": true
    }
  ]
}
```

#### Error Response
- **401** - Authorization error
- **500** - Internal server error
```

--------------------------------

### GET /api/v1/price

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/price

Fetches the latest prices for specified 'from' and 'to' currencies or token contract addresses.

```APIDOC
## GET /api/v1/price

### Description
Get latest prices for passed parameters.

### Method
GET

### Endpoint
https://market-data.nownodes.io/api/v1/price

### Parameters
#### Query Parameters
- **from** (string) - Required - Tickers 'from' or token contract address separated by comma.
- **to** (string) - Required - Tickers 'to' or token contract address separated by comma.

### Request Example
```
GET /api/v1/price?from=btc&to=usd HTTP/1.1
Host: market-data.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
```

### Response
#### Success Response (200)
- **code** (text) - Result code.
- **result** (array) - Array of price results.
  - **quotes** (object) - Price quote details.
    - **rate** (number) - The exchange rate.
    - **to_currency** (text) - The target currency ticker.
  - **from_currency** (text) - The source currency ticker.
- **error** (text) - Error message if any.

#### Response Example
```json
{
  "code": "200",
  "result": [
    {
      "quotes": {
        "rate": 30000.50,
        "to_currency": "USD"
      },
      "from_currency": "BTC"
    }
  ],
  "error": null
}
```

#### Error Responses
- **400**: Wrong input data.
- **401**: Authorization error.
- **500**: Internal server error.
```

--------------------------------

### GET /api/v1.0/networks/status

Source: https://nownodes.gitbook.io/documentation-1/monitoring

Retrieves the status of available blockchain nodes. Supports filtering by ticker.

```APIDOC
## GET /api/v1.0/networks/status

### Description
Retrieves the status of various blockchain nodes. You can filter the results by providing a comma-separated list of node tickers.

### Method
GET

### Endpoint
https://watcher.nownodes.io/api/v1.0/networks/status

### Parameters
#### Query Parameters
- **tickers** (string) - Optional - Node tickers separated by commas. Example: `akt,algorand,apt`

### Request Example
```
GET https://watcher.nownodes.io/api/v1.0/networks/status?tickers=eth,btc
```

### Response
#### Success Response (200)
- **vc** (array) - Array of objects, each representing a node status.
  - **interface** (string) - The interface name of the node.
  - **height** (integer) - The current block height of the node.
  - **heightDeviation** (integer) - The deviation in block height.
  - **status** (string) - The status of the node (e.g., "ok").
- **dot** (array) - Array of objects, each representing a node status.
  - **interface** (string) - The interface name of the node.
  - **height** (integer) - The current block height of the node.
  - **heightDeviation** (integer) - The deviation in block height.
  - **status** (string) - The status of the node (e.g., "ok").

#### Response Example
```json
{
    "vc": [
        {
            "interface": "vinu",
            "height": 8343518,
            "heightDeviation": 1,
            "status": "ok"
        }
    ],
    "dot": [
        {
            "interface": "dot-playbook",
            "height": 27621669,
            "heightDeviation": 0,
            "status": "ok"
        },
        {
            "interface": "dot",
            "height": 27621671,
            "heightDeviation": 0,
            "status": "ok"
        }
    ]
}
```
```

--------------------------------

### Market Data API Response Structure

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/market-data

Example JSON structure for a successful response from the Market Data API. It includes fields for currency details, rate changes over time, and potential error messages.

```json
{
  "code": "text",
  "result": [
    {
      "to_currency": "text",
      "from_currency": "text",
      "rate_change": [
        {
          "d": "2022-07-13T02:41:59.559Z",
          "r": 1
        }
      ]
    }
  ],
  "error": "text"
}

```

--------------------------------

### GET /v1/rates

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/rates

Retrieves the latest currency exchange rates. You can filter by currency, specify pagination, and choose the output format.

```APIDOC
## GET /v1/rates

### Description
Retrieves the latest currency exchange rates. Allows filtering by base currencies, quote currencies, and specifying pagination.

### Method
GET

### Endpoint
https://fiat-rates.nownodes.io/v1/rates

### Parameters
#### Query Parameters
- **mode** (enum) - Optional - Type of result view (raw or aggregated). Possible values: `agg`, `raw`
- **base** (string[]) - Optional - List of base currencies codes or CoinMarketCap IDs. Example: `["1027","btc","bnb"]`
- **quote** (string[]) - Optional - List of quote currencies. Example: `["usd","2806","eur"]`
- **pageNumber** (number) - Optional - Pagination number.
- **pageSize** (number) - Optional - Limit number of rows per page.

### Request Example
```json
{
  "example": "GET /v1/rates?base=[\"1027,btc,bnb\"]&quote=[\"usd,eur\"] HTTP/1.1\nHost: fiat-rates.nownodes.io\napi-key: YOUR_API_KEY\nAccept: */*"
}
```

### Response
#### Success Response (200)
- **pagination** (object) - Information about the pagination.
  - **page** (text) - Current page number.
  - **pageCount** (text) - Total number of pages.
  - **pageSize** (text) - Number of items per page.
- **data** (array) - List of currency rates.
  - **id** (text) - Unique identifier for the currency.
  - **code** (text) - Currency code (e.g., BTC, USD).
  - **name** (text) - Name of the currency.
  - **rates** (object) - Object containing exchange rates against other currencies.
    - **USD** (number) - Exchange rate against USD.
    - **AUD** (number) - Exchange rate against AUD.

#### Response Example
```json
{
  "pagination": {
    "page": "text",
    "pageCount": "text",
    "pageSize": "text"
  },
  "data": [
    {
      "id": "text",
      "code": "text",
      "name": "text",
      "rates": {
        "USD": 22966.879836294986,
        "AUD": 32370.071646390224
      }
    }
  ]
}
```

#### Error Response (401)
- Description: Authorization error.

#### Error Response (500)
- Description: Internal server error.
```

--------------------------------

### Get Market Historical Prices

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/market-data

Retrieves historical market data for specified currency pairs based on provided time parameters.

```APIDOC
## GET /api/v1/market-data

### Description
Fetches historical prices for markets (symbols) that match the provided parameters.

### Method
GET

### Endpoint
https://market-data.nownodes.io/api/v1/market-data

### Parameters
#### Query Parameters
- **from** (string) - Required - The 'from' currency or token contract address, separated by commas.
  Example: `btc,eth,usdt,0xdAC17F958D2ee523a2206206994597C13D831ec7`
- **to** (string) - Required - The 'to' currency or token contract address, separated by commas.
  Example: `btc,eth,usdt,0x2170Ed0880ac9A755fd29B2688956BD959F933F8`
- **period_from** (string) - ISO 8601 - Optional - The start time for market data.
  Example: `2022-07-13T02:41:59.559Z`
- **period_to** (string) - ISO 8601 - Optional - The end time for market data.
  Example: `2022-07-13T02:41:59.559Z`

### Request Example
```
GET /api/v1/market-data?from=btc&to=eth&period_from=2022-07-13T02:41:59.559Z HTTP/1.1
Host: market-data.nownodes.io
api-key: YOUR_API_KEY
Accept: */*
```

### Response
#### Success Response (200)
- **code** (string) - Status code or message.
- **result** (array) - An array of market data objects.
  - **to_currency** (string) - The target currency.
  - **from_currency** (string) - The source currency.
  - **rate_change** (array) - An array of rate change objects.
    - **d** (string) - Date in ISO 8601 format.
    - **r** (number) - The rate.
- **error** (string) - Error message if any.

#### Response Example
```json
{
  "code": "text",
  "result": [
    {
      "to_currency": "text",
      "from_currency": "text",
      "rate_change": [
        {
          "d": "2022-07-13T02:41:59.559Z",
          "r": 1
        }
      ]
    }
  ],
  "error": "text"
}
```
```

--------------------------------

### Get Fiat Rates (JavaScript)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/rates

JavaScript code snippet to retrieve fiat currency rates via the /v1/rates API endpoint. It utilizes the fetch API and requires an 'api-key' in the headers. The response is expected in JSON format.

```javascript
fetch('https://fiat-rates.nownodes.io/v1/rates', {
  method: 'GET',
  headers: {
    'api-key': 'YOUR_API_KEY',
    'Accept': '*/*'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

```

--------------------------------

### Get Node Statuses via Monitoring API

Source: https://nownodes.gitbook.io/documentation-1/monitoring

This snippet shows how to query the NowNodes Monitoring API to retrieve the status of various cryptocurrency nodes. The 'tickers' query parameter allows specifying a comma-separated list of nodes to check.

```http
https://watcher.nownodes.io/api/v1.0/networks/status?tickers=akt,algorand,apt
```

--------------------------------

### Fetch Market Data (Python)

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/market-data-api-reference/market-data

Illustrates fetching market data using Python's `requests` library. The code shows how to construct the URL with parameters and include the necessary API key in the request headers for authentication.

```python
import requests

url = "https://market-data.nownodes.io/api/v1/market-data"
params = {
    "from": "btc",
    "to": "eth"
    # Add other parameters like "period_from", "period_to" if needed
}
headers = {
    "api-key": "YOUR_API_KEY"
}

response = requests.get(url, params=params, headers=headers)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")

```

--------------------------------

### API Response Structure

Source: https://nownodes.gitbook.io/documentation-1/marketdata-api/fiat-rates-api-reference/currencies

The structure of a successful response (HTTP 200) from the /v1/currencies endpoint, including pagination details and a list of currency data.

```json
{
  "pagination": {
    "page": "text",
    "pageCount": "text",
    "pageSize": "text"
  },
  "data": [
    {
      "id": "text",
      "code": "text",
      "name": "text",
      "usdRate": 1,
      "isFiat": true
    }
  ]
}
```
Tokens:
Raw