Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Qortal Project Wiki

Important Notices


Project Model



Trade Portal

Qortal Hosting (QDN)

Voting System

AT System


Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services


Trade Portal Coin Recovery

LTC, ARRR, DOGE, DGB, or RVN Recovery

If you are buying QORT (by spending LTC, ARRR, DOGE, DGB, or RVN) and the trade fails, it should enter the "REFUNDING" state after 1 hour. This happens occasionally if they buyer and seller's nodes aren't able to communicate properly. The LTC, ARRR, DOGE, DGB, or RVN should be returned to your wallet with around 30 mins of the trade entering the REFUNDING state (a total of 1.5 hours after the trade began).

If for some reason you have not received the LTC / ARRR / DOGE / DGB / RVN refund (or the purchased QORT) after 2 hours, you can call the refundAll API to retry any failed refunds.

For this, you will need your node's API key, which can be found in the apikey.txt file in the folder that you installed the core. This will be the same place that you have the qortal.jar and db folder. Copy the contents of this apikey.txt file to your clipboard, then visit this link:


Under "POST /crosschain/htlc/refundAll", click "Try it out", paste the API key, then click "Execute".

`true` will be returned if anything was able to be refunded. `false` will be returned if there is nothing to refund. Alternatively, an error will be returned if it's unable to run the refund process.

As an alternative to the link above, you can use the command line (replace `apiKeyGoesHere` with your API key):

curl -X POST "http://localhost:12391/crosschain/htlc/refundAll" -H "accept: text/plain" -H "X-API-KEY: apiKeyGoesHere"

Either method is fine and they both achieve the same result.

If refundAll returned `false`, you may need to import your archived trades and try again. To do this, you can use the API documentation again: http://localhost:12391/api-documentation/#/Admin/importArchivedTrades

Under "POST /admin/repository/importarchivedtrades", click "Try it out", paste the API key, then click "Execute".

The command line alternative for this is:

curl -X POST "http://localhost:12391/admin/repository/importarchivedtrades" -H "accept: text/plain" -H "X-API-KEY: apiKeyGoesHere"

Once archived trades are imported, you can re-run the refundAll to speed up any refunds from these trades.

trade_portal_coin_recovery.txt · Last modified: 10/06/2022 14:50 by caldescent