Add doc for the nft_buy_offers method.

Per TOK-57.
This commit is contained in:
Dennis Dawson
2022-03-24 16:44:32 -07:00
committed by mDuo13
parent 302b0e8a43
commit 3cbc940afe

View File

@@ -0,0 +1,111 @@
---
html: nft_buy_offers.html
parent: nft-methods.html
blurb: Get a list of all buy offers for a NFToken.
labels:
- Non-fungible Tokens, NFTs, NFTokens
---
# account_nfts
[[Source]](https://github.com/ripple/rippled/blob/xls20/src/ripple/rpc/handlers/NFTOffers.cpp "Source")
{% include '_snippets/nfts-disclaimer.md' %}
The `nft_buy_offers` method returns a list of buy offers for a `NFToken` object.
## Request Format
An example of the request format:
<!-- MULTICODE_BLOCK_START -->
*WebSocket*
```json
{
"id": 1,
"command": "nft_buy_offers",
"params": [{
"tokenid": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007"
}]
}
```
*JSON-RPC*
```json
{
"method": "nft_buy_offers",
"tokenid": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007"
}
```
<!-- MULTICODE_BLOCK_END -->
[Try it! >](websocket-api-tool.html#nft_sell_offers)
The request includes the following parameters:
| Field | Type | Description |
|:----------------------|:---------------------------|:------------------------|
| `tokenid` | String | The unique identifier of a NFToken object. |
|
## Response Format
An example of a successful response:
<!-- MULTICODE_BLOCK_START -->
*WebSocket*
```json
{
"id": 7,
"result": {
"offers": [
{
"amount": "8000",
"flags": 0,
"index": "9A4ACB71D49C8A4F1B079DE9D3CD289851E637B68BE7FDC383D01BE413B24C7A",
"owner": "rGJUF4PvVkMNxG6Bg6AKg3avhrtQyAffcm"
}
],
"tokenid": "000800001FD350FC4A6133360827DE142E60E7522E4F4DF5409177A90000000E"
},
"type": "response"
}```
*JSON-RPC*
```json
{
{
"id": 7,
"result": {
"offers": [
{
"amount": "8000",
"flags": 0,
"index": "9A4ACB71D49C8A4F1B079DE9D3CD289851E637B68BE7FDC383D01BE413B24C7A",
"owner": "rGJUF4PvVkMNxG6Bg6AKg3avhrtQyAffcm"
}
],
"tokenid": "000800001FD350FC4A6133360827DE142E60E7522E4F4DF5409177A90000000E"
},
"type": "response"
}
}
```
<!-- MULTICODE_BLOCK_END -->
The response follows the [standard format][], with a successful result containing the following fields:
| `Field` | Type | Description |
|:---------------|:-----------------|:-----------------------------------------|
| `tokenid` | String | The NFToken associated with the sell offers |
| `offers` | Array | The list of sell offers for the NFToken |
## Possible Errors
* Any of the [universal error types][].
{% include '_snippets/rippled_versions.md' %}
{% include '_snippets/rippled-api-links.md' %}