Get currency buy offers given a currency ID and/or an account ID

POST

https://ardr.nownodes.io/nxt

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsobjectrequired

Show child attributes

requestTypestring

chaininteger

The chain related to the operation

currencystring

The currency ID

accountstring

The account ID

availableOnlyboolean

True to include only offers with non-zero supply and limit

firstIndexinteger

A zero-based index to the first offer to retrieve

lastIndexinteger

A zero-based index to the last offer to retrieve

requireBlockstring

The block ID of a block that must be present in the blockchain during execution

requireLastBlockstring

The block ID of a block that must be last in the blockchain during execution

idintegerrequired

Response

200OK

Buy offers retrieved successfully

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Get currency buy offers given a currency ID and/or an account ID

curl -X POST 'https://ardr.nownodes.io/nxt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "getBuyOffers",
    "params": {
      "requestType": "getBuyOffers",
      "chain": 0,
      "currency": "string",
      "account": "string",
      "availableOnly": true,
      "firstIndex": 0,
      "lastIndex": 0,
      "requireBlock": "string",
      "requireLastBlock": "string"
    },
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ardr.nownodes.io/nxt");
const result = await provider.send("getBuyOffers", {
  "requestType": "getBuyOffers",
  "chain": 0,
  "currency": "string",
  "account": "string",
  "availableOnly": true,
  "firstIndex": 0,
  "lastIndex": 0,
  "requireBlock": "string",
  "requireLastBlock": "string"
});
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "getBuyOffers",
  "params": {
    "requestType": "getBuyOffers",
    "chain": 0,
    "currency": "string",
    "account": "string",
    "availableOnly": true,
    "firstIndex": 0,
    "lastIndex": 0,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://ardr.nownodes.io/nxt"))
response = w3.provider.make_request("getBuyOffers", {
  "requestType": "getBuyOffers",
  "chain": 0,
  "currency": "string",
  "account": "string",
  "availableOnly": True,
  "firstIndex": 0,
  "lastIndex": 0,
  "requireBlock": "string",
  "requireLastBlock": "string"
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://ardr.nownodes.io/nxt"),
});

const result = await client.request({
  method: "getBuyOffers",
  params: {
  "requestType": "getBuyOffers",
  "chain": 0,
  "currency": "string",
  "account": "string",
  "availableOnly": true,
  "firstIndex": 0,
  "lastIndex": 0,
  "requireBlock": "string",
  "requireLastBlock": "string"
},
});

console.log(result);

const endpoint = "https://ardr.nownodes.io/nxt";
const apiKey = "YOUR_API_KEY";

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

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "getBuyOffers", params: {
  "requestType": "getBuyOffers",
  "chain": 0,
  "currency": "string",
  "account": "string",
  "availableOnly": true,
  "firstIndex": 0,
  "lastIndex": 0,
  "requireBlock": "string",
  "requireLastBlock": "string"
}, id: 1 });
console.log(result);

const response = await fetch('https://ardr.nownodes.io/nxt', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "getBuyOffers",
      "params": {
        "requestType": "getBuyOffers",
        "chain": 0,
        "currency": "string",
        "account": "string",
        "availableOnly": true,
        "firstIndex": 0,
        "lastIndex": 0,
        "requireBlock": "string",
        "requireLastBlock": "string"
      },
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "getBuyOffers",
  "params": {
    "requestType": "getBuyOffers",
    "chain": 0,
    "currency": "string",
    "account": "string",
    "availableOnly": True,
    "firstIndex": 0,
    "lastIndex": 0,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "id": 1
}

response = requests.post('https://ardr.nownodes.io/nxt', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ardr.nownodes.io/nxt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "getBuyOffers",
    "params": {
      "requestType": "getBuyOffers",
      "chain": 0,
      "currency": "string",
      "account": "string",
      "availableOnly": true,
      "firstIndex": 0,
      "lastIndex": 0,
      "requireBlock": "string",
      "requireLastBlock": "string"
    },
    "id": 1
  }'

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "getBuyOffers",
  "params": {
    "requestType": "getBuyOffers",
    "chain": 0,
    "currency": "string",
    "account": "string",
    "availableOnly": true,
    "firstIndex": 0,
    "lastIndex": 0,
    "requireBlock": "string",
    "requireLastBlock": "string"
  },
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "offers": [
      {
        "offer": "string",
        "supplyQNT": "string",
        "expirationHeight": 0,
        "accountRS": "string",
        "rateNQTPerUnit": "string",
        "limitQNT": "string",
        "currency": "string",
        "offerFullHash": "string",
        "account": "string",
        "height": 0
      }
    ],
    "lastBlock": "string",
    "requestProcessingTime": 0
  }
}

Documentation

How to migrate to NOWNodes

Get currency buy offers given a currency ID and/or an account ID

Authorizations

Body

Response