Publish an exchange offer for an exchangeable currency

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

buyRateNQTPerUnitstring

The offered buy rate (in NQT per QNT)

sellRateNQTPerUnitstring

The offered sell rate (in NQT per QNT)

totalBuyLimitQNTstring

The cumulative limit (in QNT) of currency buys

totalSellLimitQNTstring

The cumulative limit (in QNT) of currency sells

initialBuySupplyQNTstring

The initial amount (in QNT) of currency offered to buy

initialSellSupplyQNTstring

The initial amount (in QNT) of currency offered to sell

expirationHeightinteger

The blockchain height for expiration of the offer

idintegerrequired

Response

200OK

Exchange offer published successfully

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Publish an exchange offer for an exchangeable currency

curl -X POST 'https://ardr.nownodes.io/nxt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "publishExchangeOffer",
    "params": {
      "requestType": "publishExchangeOffer",
      "chain": 0,
      "currency": "string",
      "buyRateNQTPerUnit": "string",
      "sellRateNQTPerUnit": "string",
      "totalBuyLimitQNT": "string",
      "totalSellLimitQNT": "string",
      "initialBuySupplyQNT": "string",
      "initialSellSupplyQNT": "string",
      "expirationHeight": 0
    },
    "id": 1
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://ardr.nownodes.io/nxt");
const result = await provider.send("publishExchangeOffer", {
  "requestType": "publishExchangeOffer",
  "chain": 0,
  "currency": "string",
  "buyRateNQTPerUnit": "string",
  "sellRateNQTPerUnit": "string",
  "totalBuyLimitQNT": "string",
  "totalSellLimitQNT": "string",
  "initialBuySupplyQNT": "string",
  "initialSellSupplyQNT": "string",
  "expirationHeight": 0
});
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": "publishExchangeOffer",
  "params": {
    "requestType": "publishExchangeOffer",
    "chain": 0,
    "currency": "string",
    "buyRateNQTPerUnit": "string",
    "sellRateNQTPerUnit": "string",
    "totalBuyLimitQNT": "string",
    "totalSellLimitQNT": "string",
    "initialBuySupplyQNT": "string",
    "initialSellSupplyQNT": "string",
    "expirationHeight": 0
  },
  "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("publishExchangeOffer", {
  "requestType": "publishExchangeOffer",
  "chain": 0,
  "currency": "string",
  "buyRateNQTPerUnit": "string",
  "sellRateNQTPerUnit": "string",
  "totalBuyLimitQNT": "string",
  "totalSellLimitQNT": "string",
  "initialBuySupplyQNT": "string",
  "initialSellSupplyQNT": "string",
  "expirationHeight": 0
})
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "publishExchangeOffer",
  params: {
  "requestType": "publishExchangeOffer",
  "chain": 0,
  "currency": "string",
  "buyRateNQTPerUnit": "string",
  "sellRateNQTPerUnit": "string",
  "totalBuyLimitQNT": "string",
  "totalSellLimitQNT": "string",
  "initialBuySupplyQNT": "string",
  "initialSellSupplyQNT": "string",
  "expirationHeight": 0
},
});

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: "publishExchangeOffer", params: {
  "requestType": "publishExchangeOffer",
  "chain": 0,
  "currency": "string",
  "buyRateNQTPerUnit": "string",
  "sellRateNQTPerUnit": "string",
  "totalBuyLimitQNT": "string",
  "totalSellLimitQNT": "string",
  "initialBuySupplyQNT": "string",
  "initialSellSupplyQNT": "string",
  "expirationHeight": 0
}, 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": "publishExchangeOffer",
      "params": {
        "requestType": "publishExchangeOffer",
        "chain": 0,
        "currency": "string",
        "buyRateNQTPerUnit": "string",
        "sellRateNQTPerUnit": "string",
        "totalBuyLimitQNT": "string",
        "totalSellLimitQNT": "string",
        "initialBuySupplyQNT": "string",
        "initialSellSupplyQNT": "string",
        "expirationHeight": 0
      },
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "publishExchangeOffer",
  "params": {
    "requestType": "publishExchangeOffer",
    "chain": 0,
    "currency": "string",
    "buyRateNQTPerUnit": "string",
    "sellRateNQTPerUnit": "string",
    "totalBuyLimitQNT": "string",
    "totalSellLimitQNT": "string",
    "initialBuySupplyQNT": "string",
    "initialSellSupplyQNT": "string",
    "expirationHeight": 0
  },
  "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": "publishExchangeOffer",
    "params": {
      "requestType": "publishExchangeOffer",
      "chain": 0,
      "currency": "string",
      "buyRateNQTPerUnit": "string",
      "sellRateNQTPerUnit": "string",
      "totalBuyLimitQNT": "string",
      "totalSellLimitQNT": "string",
      "initialBuySupplyQNT": "string",
      "initialSellSupplyQNT": "string",
      "expirationHeight": 0
    },
    "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": "publishExchangeOffer",
  "params": {
    "requestType": "publishExchangeOffer",
    "chain": 0,
    "currency": "string",
    "buyRateNQTPerUnit": "string",
    "sellRateNQTPerUnit": "string",
    "totalBuyLimitQNT": "string",
    "totalSellLimitQNT": "string",
    "initialBuySupplyQNT": "string",
    "initialSellSupplyQNT": "string",
    "expirationHeight": 0
  },
  "id": 1
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "signatureHash": "string",
    "unsignedTransactionBytes": "string",
    "transactionJSON": {
      "senderPublicKey": "string",
      "chain": 0,
      "signature": "string",
      "feeNQT": "string",
      "type": 0,
      "fullHash": "string",
      "version": 0,
      "ecBlockId": "string",
      "signatureHash": "string",
      "attachment": {
        "totalSellLimit": "string",
        "buyRateNQTPerUnit": "string",
        "initialSellSupplyQNT": "string",
        "totalBuyLimitQNT": "string",
        "expirationHeight": 0,
        "sellRateNQTPerUnit": "string",
        "version.PublishExchangeOffer": 0,
        "currency": "string",
        "initialBuySupplyQNT": "string"
      },
      "senderRS": "string",
      "subtype": 0,
      "amountNQT": "string",
      "sender": "string",
      "ecBlockHeight": 0,
      "deadline": 0,
      "transaction": "string",
      "timestamp": 0,
      "height": 0
    },
    "broadcasted": true,
    "requestProcessingTime": 0,
    "transactionBytes": "string",
    "transaction": "string"
  }
}

Documentation

How to migrate to NOWNodes

Publish an exchange offer for an exchangeable currency

Authorizations

Body

Response