Skip to main content

nft_buy_offers RPC Method

Returns a list of buy offers for a given NFToken object

Updated on
Oct 4, 2023

nft_buy_offers RPC Method

Parameters

nft_id
string
REQUIRED
The unique identifier of a NFToken object
ledger_hash
string
A 20-byte hex string for identifying the ledger version
ledger_index
string
The index of the ledger to retrieve information from
limit
string
REQUIRED
It limits the number of NFT buy offers to retrieve. This value cannot be lower than 50 or more than 500. The default is 250
marker
string
The value from a previous paginated respons

Returns

result
object
An object with the following fields:
nft_id
string
The NFToken these offers are for, as specified in the request
offers
array
A list of buy offers for the token, which contains the following fields:
amount
string
The amount offered to buy the NFT for
flags
integer
A set of bit-flags for this offer
nft_offer_index
integer
The ledger object ID of this offer
owner
integer
The account that placed this offer
status
string
The status of the request
warnings
array
A list of warnings
id
integer
The ID of the warning
message
string
The warning message
Request
1
curl https://docs-demo.xrp-mainnet.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{
5
"method": "nft_buy_offers",
6
"params": [{
7
"nft_id": "NFT_ID",
8
"ledger_index": "validated"
9
}],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free