GetBuyOffers

Retrieves all buy offers (pending orders to buy currency) for a specific account or currency.

Request

GET /nxt?requestType=getBuyOffers

Parameters

Name	Type	Description	Required
currency	long	Filter by currency	Optional
account	string	Filter by account	Optional
firstIndex	int	Pagination start index	Optional
lastIndex	int	Pagination end index	Optional

Response

{
  "buyOffers": [
    {
      "order": "11111",
      "orderFullHash": "abc123...",
      "totem": "987654321",
      "account": "1234567890",
      "quantityQNT": "1000000000",
      "currency": "987654321",
      "priceQNTPerShare": "500",
      "height": 250,
      "transactionIndex": 1,
      "transactionHeight": 250,
      "type": "bid"
    }
  ]
}

Example

# Get buy offers for a currency
curl "http://localhost:22024/nxt?requestType=getBuyOffers&currency=987654321"

# Get buy offers for an account
curl "http://localhost:22024/nxt?requestType=getBuyOffers&account=1234567890"

Related

• CurrencyBuy
• GetSellOffers
• GetExchanges
• GetAvailableToBuy