Please note that this method can be used in streaming mode. To read more about this, visit the streaming section.

Query Parameters

selling_asset_type

string

REQUIRED

The type of the asset being sold. Either 'native', 'credit_alphanum4', or 'credit_alphanum12'

selling_asset_issuer

string

The Stellar address of the issuer of the asset being sold. Required if the selling_asset_type is not 'native'

selling_asset_code

string

The code for the asset being sold. Required if the selling_asset_type is not 'native'

buying_asset_type

string

REQUIRED

The type of the asset being bought. Either 'native', 'credit_alphanum4', or 'credit_alphanum12'

buying_asset_issuer

string

The Stellar address of the issuer of the asset being bought. Required if the buying_asset_type is not 'native'

buying_asset_code

string

The code for the asset being bought. Required if the buying_asset_type is not 'native'

limit

integer

The maximum number of records to return for bids and asks

Returns

bids

array

An array of bid offers

price_r

object

The price as a rational number

n

integer

The numerator

d

integer

The denominator

price

string

The price as a decimal string

amount

string

The amount of the asset being offered

asks

array

An array of ask offers

price_r

object

The price as a rational number

n

integer

The numerator

d

integer

The denominator

price

string

The price as a decimal string

amount

string

The amount of the asset being offered

base

object

Details about the base asset

asset_type

string

The type of the base asset

asset_code

string

(Optional) The code of the base asset

asset_issuer

string

(Optional) The issuer of the base asset

counter

object

Details about the counter asset

asset_type

string

The type of the counter asset

asset_code

string

The code of the counter asset

asset_issuer

string

The issuer of the counter asset

Request

1
curl --location 'https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10' \
2
--header 'Accept: application/json'
3

1
curl --location 'https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10' \
2
--header 'Accept: application/json'
3

1
var myHeaders = new Headers();
2
myHeaders.append("Accept", "application/json");
3

4
var requestOptions = {
5
  method: 'GET',
6
  headers: myHeaders,
7
  redirect: 'follow'
8
};
9

10
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10", requestOptions)
11
  .then(response => response.text())
12
  .then(result => console.log(result))
13
  .catch(error => console.log('error', error));
14

1
var myHeaders = new Headers();
2
myHeaders.append("Accept", "application/json");
3

4
var requestOptions = {
5
  method: 'GET',
6
  headers: myHeaders,
7
  redirect: 'follow'
8
};
9

10
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10", requestOptions)
11
  .then(response => response.text())
12
  .then(result => console.log(result))
13
  .catch(error => console.log('error', error));
14

1
import requests
2

3
url = "https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10"
4

5
payload = {}
6
headers = {
7
  'Accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
import requests
2

3
url = "https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10"
4

5
payload = {}
6
headers = {
7
  'Accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["Accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/order_book?selling_asset_type=native&buying_asset_type=credit_alphanum4&buying_asset_code=USDC&buying_asset_issuer=GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN&limit=10")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["Accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free