Package nxt.http

Class CurrencyBuy

java.lang.Object
nxt.http.APIServlet.APIRequestHandler
nxt.http.CreateTransaction
nxt.http.CurrencyBuy
public final class CurrencyBuy extends CreateTransaction
Buy currency for coin

Parameters

  • currency - currency id
  • rateNQTPerUnit - exchange rate between coin amount and currency units
  • unitsQNT - number of units to buy

The currency buy transaction attempts to match existing exchange offers. When a match is found, the minimum number of units between the number of units offered and the units requested are exchanged at a rate matching the highest sell offer
A single transaction can match multiple sell offers or none. Unlike asset bid order, currency buy is not saved. It's either executed immediately (fully or partially) or not executed at all. For every match between buyer and seller an exchange record is saved, exchange records can be retrieved using the GetExchanges API