Console

POSTnft_buy_offers

XRP Ledger Mainnethttps://xrpl-mainnet.nodit.io/

Returns the list of buy offers on a given NFToken. It lets you check the offered amount and the creator of each offer.

Request Body
methodstringrequired
nft_idstringrequired

The identifier of the NFToken to look up.

limitinteger

The number of offers to return. Pass a value between 50 and 500.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

ledger_hashstring

The hash of the ledger version to use. Pass a 32-byte hex string.

ledger_indexinteger

Specifies the ledger version to use. Pass a ledger index as an integer, or use one of the shortcut strings below.

  • validated: Uses the most recent ledger version validated by the network.
  • closed: Uses the most recent ledger version the server has closed. It may not be validated.
  • current: Uses the in-progress ledger version the server is currently building.

The ledger index of the version to use.

Responses
nft_idstring

The identifier of the NFToken from the request.

amountoneOf

Represents an amount. XRP is expressed as a string in drops; tokens are expressed as an object.

XRP Amountstring
Token Amountobject
currencystring

The currency code. Either a 3-character code or a 40-character hex string.

issuerstring

The address of the account that issued the token.

valuestring

The amount expressed as a string.

flagsinteger

A bit-map of flags enabled for the offer.

nft_offer_indexstring

The ID that identifies this offer ledger entry.

ownerstring

The address of the account that created the offer.

destinationstring

The address of the account designated to accept this offer. Returned only when one is designated.

expirationinteger

The expiration time of the offer, in seconds since the Ripple Epoch. Returned only when an expiration is set.

limitinteger

The limit value used in the request.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

X-API-KEY
RequestCU50
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "nft_buy_offers",
  "params": [
    {
      "nft_id": "000800006203F49C21D5D6E022CB16DE3538F248662FC73C00000E39",
      "limit": 250
    }
  ]
}'
Response
Example · 200
{
  "result": {
    "nft_id": "000800006203F49C21D5D6E022CB16DE3538F248662FC73C00000E39",
    "offers": [
      {
        "amount": "1000000",
        "flags": 1,
        "nft_offer_index": "3D5F7A9B1C2E4A6C8D0F2B4D6E8A0C1E3F5B7D9A0C2E4F6B8D0A1C3E5F7B9D0A",
        "owner": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59"
      }
    ],
    "limit": 250
  }
}

Last updated