Asset Exchange

Cancel Order

Cancel an existing asset order.

Method: POST

https://ardr.nownodes.io/nxt?requestType=cancelBidOrder

Example body (x-www-form-urlencoded)

requestType = cancelBidOrder
secretPhrase = IWontTellYou
chain = 2
order = 17185236428295897167
feeNQT = 100000000
deadline = 60

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Delete Asset Property

Permanently deletes a specified asset property.

Method: POST

https://ardr.nownodes.io/nxt?requestType=deleteAssetProperty

Example body (x-www-form-urlencoded)

requestType = deleteAssetProperty
secretPhrase = IWontTellYou
chain = 2
asset = 10982263251111884451
property = isIdentified
setter = ARDOR-X8ZN-WUJ2-SXY3-FBUYC

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Delete Asset Shares

Permanently deletes a specified quantity of owned asset shares.

Method: POST

https://ardr.nownodes.io/nxt?requestType=deleteAssetShares

Example body (x-www-form-urlencoded)

requestType = deleteAssetShares
secretPhrase = IWontTellYou
chain = 2
asset = 5920455660623529270
quantityQNT = 100
feeNQT = 100000000
deadline = 60
broadcast = false

Example response: 200

{
    "errorDescription": "Unknown asset",
    "errorCode": 5
}

Dividend Payment

Pay dividend to all shareholders of an asset.

Method: POST

https://ardr.nownodes.io/nxt?requestType=dividendPayment

Example body (x-www-form-urlencoded)

requestType = dividendPayment
secretPhrase = IWontTellYou
chain = 2
asset = 3517042713515967694
quantityQNT = 100
height = 161157
amountNQTPerShare = 100000000

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Get Account Asset Count

Get the number of assets owned by an account given the account ID.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAccountAssetCount&account=ARDOR-8N9W-TN4F-YA2S-H5B7R

Example response: 200

{
    "requestProcessingTime": 1,
    "numberOfAssets": 0
}

Get Account Assets

Get the assets owned by a given account in reverse quantity order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAccountAssets&account=ARDOR-4VNQ-RWZC-4WWQ-GVM8S

Example response: 200

{
    "accountAssets": [],
    "requestProcessingTime": 1
}

Get Account Current Order Ids

Get current asset order IDs given an account ID in reverse block height order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAccountCurrentBidOrderIds&chain=2&account=ARDOR-L6FM-89WK-VK8P-FCRBB&asset=17554243582654188572

Example response: 200

{
    "bidOrderIds": [],
    "requestProcessingTime": 0
}

Get Account Current Orders

Get current asset orders given an account ID in reverse block height order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAccountCurrentBidOrders&chain=2&account=ARDOR-L6FM-89WK-VK8P-FCRBB

Example response: 200

{
    "bidOrders": [],
    "requestProcessingTime": 1
}

Get All Assets

Get all assets in the exchange in reverse block height of creation order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAllAssets&firstIndex=1&lastIndex=5

Example response: 200

{
    "assets": [
        {
            "quantityQNT": "777",
            "accountRS": "ARDOR-BGWS-RQDY-KFWQ-35JST",
            "decimals": 0,
            "name": "Katzenweih",
            "description": "N4TM|Katzenweihnacht Audio|||||QmeC3vug3BZReSzCLzmzMdo55WwaUQNtsGqkfKLMfEAUHX",
            "hasPhasingAssetControl": false,
            "asset": "9337910373212510709",
            "account": "2081230090630642584"
        },
        {
            "quantityQNT": "1",
            "accountRS": "ARDOR-2BQ5-W5TK-C9AQ-APEWA",
            "decimals": 0,
            "name": "DG1BXPN1",
            "description": "UNIQUE BOGOSHIPO IN-GAME ITEM\r\n\"STANISLAV\"\r\nDOG\r\nGENERATION 1\r\nBREED X\r\nPET NUMBER 1 OF 1",
            "hasPhasingAssetControl": false,
            "asset": "9338106961544685278",
            "account": "9543573878757926595"
        },
        {
            "quantityQNT": "1",
            "accountRS": "ARDOR-5WW2-XQ63-CFGM-G7YAJ",
            "decimals": 0,
            "name": "Frenchietw",
            "description": "N4TM|Frenchie twentyone||34|Frencies||QmUKbXx93sDaKEFH7RkUj7pECEEkzii5do3C1KzRNEgzrZ",
            "hasPhasingAssetControl": false,
            "asset": "9345701807892367092",
            "account": "16727431064964952960"
        },
        {
            "quantityQNT": "1",
            "accountRS": "ARDOR-FSJE-8W3L-HPV3-HPUEE",
            "decimals": 0,
            "name": "Milo",
            "description": "N4TM|Milo||4s8|LNF22 Fan Frenchies||QmYDj2ChHNdzDx3uXCoWm5xsCfGUfvetGQSeZihGpHM7B5|80",
            "hasPhasingAssetControl": false,
            "asset": "9352109240203067897",
            "account": "17740617051906957836"
        },
        {
            "quantityQNT": "0",
            "accountRS": "ARDOR-RGJS-25L6-P6RW-CFPRY",
            "decimals": 0,
            "name": "harvest",
            "description": "raw plant material harvest",
            "hasPhasingAssetControl": false,
            "asset": "9358630304999303906",
            "account": "12636727823789963800"
        }
    ],
    "requestProcessingTime": 6
}

Get All Open Orders

Get all open bid/ask orders in reverse block height order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAllOpenBidOrders&chain=2&firstIndex=123&lastIndex=123

Example response: 200

{
    "requestProcessingTime": 3,
    "openOrders": [
        {
            "quantityQNT": "4",
            "orderFullHash": "bd0767e63c415512c6f592d7463304be08a60fa0b0ee3c4ba55cfb5b76c99ae9",
            "transactionHeight": 3323560,
            "accountRS": "ARDOR-B9JM-67DJ-CK9D-2UGR5",
            "priceNQTPerShare": "20100000000",
            "transactionIndex": 2,
            "asset": "7535070915409870441",
            "type": "bid",
            "account": "134503400619679251",
            "order": "1321033795522463677",
            "height": 3323560
        }
    ]
}

Get All Trades

Get all trades since a given timestamp in reverse block height order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAllTrades&chain=2&lastIndex=0

Example response: 200

{
    "trades": [
        {
            "seller": "17013198449221254668",
            "quantityQNT": "70",
            "sellerRS": "ARDOR-YHJE-V87J-ZAHF-G7S8S",
            "buyer": "17013198449221254668",
            "askOrderFullHash": "4c5ca32c4891937d57e484af82c30f162c991ec06d05185caeae25bf7df58c75",
            "buyerRS": "ARDOR-YHJE-V87J-ZAHF-G7S8S",
            "priceNQTPerShare": "10400000000",
            "bidOrderFullHash": "c6ce00313bf8b4ae455c827e675b7232c1903e15c1d6b2c755bc84e05d308f76",
            "block": "3836692534175058402",
            "asset": "14181059775676150956",
            "askOrderHeight": 3197837,
            "bidOrderHeight": 3342042,
            "tradeType": "buy",
            "timestamp": 197353779,
            "height": 3342042
        }
    ],
    "requestProcessingTime": 3
}

Get Asset

Get asset information given an asset ID.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAsset&asset=17554243582654188572

Example response: 200

{
    "errorDescription": "Unknown asset",
    "errorCode": 5
}

Get Asset Account Count

Get the number of accounts that own an asset given the asset ID.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetAccountCount&asset=17554243582654188572

Example response: 200

{
    "numberOfAccounts": 0,
    "requestProcessingTime": 0
}

Get Asset Accounts

Get the accounts that own an asset given the asset ID in reverse quantity order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetAccounts&asset=5539238107226883203

Example response: 200

{
    "accountAssets": [],
    "requestProcessingTime": 1
}

Get Asset Dividends

Get the dividend payment history for a specific asset.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetDividends&chain=2&asset=6277929525780034120

Example response: 200

{
    "dividends": [],
    "requestProcessingTime": 0
}

Get Asset Ids

Get the IDs of all assets in the exchange in reverse block height of creation order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetIds&firstIndex=15&lastIndex=15

Example response: 200

{
    "assetIds": [
        "9450025196186831282"
    ],
    "requestProcessingTime": 1
}

Get Asset Phased Transactions

Get pending phased transactions based on an asset in reverse chronological creation order. These transactions can be considered transaction approval requests.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetPhasedTransactions&chain=2&asset=17091401215301664836

Example response: 200

{
    "requestProcessingTime": 1,
    "transactions": []
}

Get Asset Properties

Get asset properties given asset and a setter. When it is provided property it lists the value of the given property.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetProperties&asset=17554243582654188572&setter=ARDOR-X8ZN-WUJ2-SXY3-FBUYC&property=isIdentified

Example response: 200

{
    "setterRS": "ARDOR-X8ZN-WUJ2-SXY3-FBUYC",
    "requestProcessingTime": 0,
    "asset": "17554243582654188572",
    "setter": "15382970207090678772",
    "properties": []
}

Get Asset Transfers

Get transfers associated with a given asset and/or account in reverse block height order (or in the expected order of execution for expected transfers).

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetTransfers&asset=17554243582654188572&lastIndex=0

Example response: 200

{
    "transfers": [],
    "requestProcessingTime": 5
}

Get Assets

Get asset information given multiple asset IDs.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssets&assets=17554243582654188572

Example response: 200

{
    "errorDescription": "Unknown asset",
    "errorCode": 5
}

Get Assets By Issuer

Get asset information given multiple creation account IDs in reverse block height of creation order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAssetsByIssuer&account=ARDOR-DE2F-W76R-GL25-HMFPR&lastIndex=0

Example response: 200

{
    "assets": [
        []
    ],
    "requestProcessingTime": 0
}

Get Expected Asset Deletes

Gets asset deletes which are expected to be executed in the next block. Since version 2.3.0e it returns both bundled and non-bundled transactions.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getExpectedAssetDeletes&chain=2

Example response: 200

{
    "deletes": [],
    "requestProcessingTime": 26
}

Get Order

Get a bid/ask order given an order ID.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getAskOrder&chain=2&order=6044046093672850641

Example response: 200

{
    "errorDescription": "Unknown order",
    "errorCode": 5
}

Get Order Ids

Get bid/ask order IDs given an asset ID, in order of decreasing bid price or increasing ask price.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getBidOrderIds&chain=2&asset=17554243582654188572

Example response: 200

{
    "bidOrderIds": [],
    "requestProcessingTime": 0
}

Get Expected Order Cancellations

Get all expected order cancellations in the order in which they are expected to be executed. Since version 2.3.0e it returns both bundled and non-bundled transactions.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getExpectedOrderCancellations&chain=2

Example response: 200

{
    "orderCancellations": [],
    "requestProcessingTime": 12
}

Get Last Trades

Get the last trade of each of multiple assets.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getLastTrades&chain=2&assets=17091401215301664836

Example response: 200

{
    "trades": [],
    "requestProcessingTime": 2
}

Increase Asset Shares

Increase asset shares of a specific asset.

Method: POST

https://ardr.nownodes.io/nxt?requestType=increaseAssetShares

Example body (x-www-form-urlencoded)

requestType = increaseAssetShares
secretPhrase = IWontTellYou
chain = 2
asset = 3295228938014260892
quantityQNT = 1000000

Example response: 200

{
    "errorDescription": "Unknown asset",
    "errorCode": 5
}

Issue Asset

Create an asset on the exchange.

Method: POST

https://ardr.nownodes.io/nxt?requestType=issueAsset

Example body (x-www-form-urlencoded)

requestType = issueAsset
chain = 2
name = SecretCoin
description = This is SecretCoin
quantityQNT = 100
publicKey = 57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c
feeNQT = 100000000000
deadline = 60

Example response: 200

{
    "amount": "0",
    "chain": 2,
    "errorDescription": "Not enough funds",
    "balance": "0",
    "fee": "100000000000",
    "errorCode": 6,
    "diff": "100000000000"
}

Place Order

Place an asset order.

Method: POST

https://ardr.nownodes.io/nxt?requestType=placeBidOrder

Example body (x-www-form-urlencoded)

requestType = placeBidOrder
chain = 2
secretPhrase = iwonttellyou
asset = 17554243582654188572
quantityQNT = 1000000
priceNQTPerShare = 100
feeNQT = 100000000
deadline = 60

Example response: 200

{
    "errorDescription": "Unknown asset",
    "errorCode": 5
}

Search Assets

Get assets having a name or description that match a given query in reverse relevance order.

Method: GET

https://ardr.nownodes.io/nxt?requestType=searchAssets&query=assets AND production

Example response: 200

{
    "assets": [],
    "requestProcessingTime": 22
}

Set Asset Property

Set an asset property that allows attaching metadata to assets, in the form of name/value pairs.

Method: GET

https://ardr.nownodes.io/nxt?requestType=setAssetProperty

Example body (x-www-form-urlencoded)

requestType = setAssetProperty
chain = 2
secretPhrase = iwonttellyou
asset = 10982263251111884451
value = true
property = isIdentified

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Set Phasing Asset Control

Set all transactions involving a given asset to be subject to approval (i.e. to use phasing).

Method: POST

https://ardr.nownodes.io/nxt?requestType=setPhasingAssetControl

Example body (x-www-form-urlencoded)

requestType = setPhasingAssetControl
chain = 2
secretPhrase = iwonttellyou
asset = 3295228938014260892
controlVotingModel = 0
controlQuorum = 1
controlWhitelisted = ARDOR-X8ZN-WUJ2-SXY3-FBUYC
feeNQT = 100000000
deadline = 60

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Set Asset Trade Royalties

Set or change the royalties percentage. Asset issuer can receive royalties, calculated as a fixed percentage from each trade of the asset, which is subtracted from the amount (in child chain coins) that the asset seller receives and gets added automatically to the asset issuer account.

Method: POST

https://ardr.nownodes.io/nxt?requestType=setAssetTradeRoyalties

Example body (x-www-form-urlencoded)

requestType = setPhasingAssetControl
chain = 2
secretPhrase = iwonttellyou
asset = 10982263251111884451
royaltiesPercentage = 10

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Get Phasing Asset Control

returns the phasing control for a given asset, if set.

Method: GET

https://ardr.nownodes.io/nxt?requestType=getPhasingAssetControl&chain=2&asset=3295228938014260892&

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}

Transfer Asset

Transfer a quantity of an asset from one account to another.

Method: POST

https://ardr.nownodes.io/nxt?requestType=transferAsset

Example body (x-www-form-urlencoded)

requestType = transferAsset
chain = 2
recipient = ARDOR-4VNQ-RWZC-4WWQ-GVM8S
asset = 17554243582654188572
quantityQNT = 1000
feeNQT = 100000000
deadline = 60

Example response: 200

{
    "errorDescription": "Unknown account",
    "errorCode": 5
}