Retrieve an Order Book

GET

https://xlm.nownodes.io/order_books{selling_asset_type}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

The order book endpoint provides an order book’s bids and asks and can be used in streaming mode. When filtering for a specific order book, you must use use all six of these arguments: base_asset_type, base_asset_issuer, base_asset_code, counter_asset_type, counter_asset_issuer, and counter_asset_code. If the base or counter asset is XLM, you only need to indicate the asset type as native and do not need to designate the code or the issuer.

Parameters

selling_asset_typestringnativecredit_alphanum4credit_alphanum12requiredpath

The type for the selling asset. Either native, credit_alphanum4, or credit_alphanum12.

selling_asset_issuerstringquery

The Stellar address of the selling asset’s issuer.

selling_asset_codestringquery

The code for the selling asset.

buying_asset_typestringnativecredit_alphanum4credit_alphanum12query

The type for the buying asset. Either native, credit_alphanum4, or credit_alphanum12.

buying_asset_issuerstringquery

The Stellar address of the buying asset’s issuer.

buying_asset_codestringquery

The code for the buying asset.

limitintegerquery

The maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10.

Response

200OK

Success

Retrieve an Order Book

curl -X GET 'https://xlm.nownodes.io/order_books{selling_asset_type}'

const response = await fetch('https://xlm.nownodes.io/order_books{selling_asset_type}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xlm.nownodes.io/order_books{selling_asset_type}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://xlm.nownodes.io/order_books{selling_asset_type}')
data = response.json()

const response = await fetch('https://xlm.nownodes.io/order_books{selling_asset_type}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xlm.nownodes.io/order_books{selling_asset_type}";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://xlm.nownodes.io/order_books{selling_asset_type}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xlm.nownodes.io/order_books{selling_asset_type}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xlm.nownodes.io/order_books{selling_asset_type}')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

200

{
  "bids": [
    {
      "price_r": {
        "n": 10000000,
        "d": 139999999
      },
      "price": "0.0714286",
      "amount": "24.9999990"
    },
    {
      "price_r": {
        "n": 1,
        "d": 14
      },
      "price": "0.0714286",
      "amount": "188.0000000"
    },
    {
      "price_r": {
        "n": 1,
        "d": 15
      },
      "price": "0.0666667",
      "amount": "230.3200000"
    },
    {
      "price_r": {
        "n": 1,
        "d": 16
      },
      "price": "0.0625000",
      "amount": "50.0000000"
    }
  ],
  "asks": [
    {
      "price_r": {
        "n": 5000000,
        "d": 62500001
      },
      "price": "0.0800000",
      "amount": "4.9400001"
    },
    {
      "price_r": {
        "n": 10000000,
        "d": 125000001
      },
      "price": "0.0800000",
      "amount": "2516.5154327"
    },
    {
      "price_r": {
        "n": 2,
        "d": 25
      },
      "price": "0.0800000",
      "amount": "3125.0000000"
    },
    {
      "price_r": {
        "n": 4,
        "d": 49
      },
      "price": "0.0816327",
      "amount": "4593.7500000"
    }
  ],
  "base": {
    "asset_type": "native"
  },
  "counter": {
    "asset_type": "credit_alphanum4",
    "asset_code": "BB1",
    "asset_issuer": "GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN"
  }
}