Parameters

object

object

REQUIRED

The nft_buy_offers request object.

nft_id

string

REQUIRED

The unique identifier of a NFToken object

ledger_index

string

The index of the ledger to retrieve information from

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 -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "nft_buy_offers",
6
  "params": [
7
    {
8
      "nft_id": "NFT_ID",
9
      "ledger_index": "validated"
10
    }
11
  ],
12
  "id": 1
13
}'

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "nft_buy_offers",
6
  "params": [
7
    {
8
      "nft_id": "NFT_ID",
9
      "ledger_index": "validated"
10
    }
11
  ],
12
  "id": 1
13
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'nft_buy_offers',
4
    params: [{"nft_id":"NFT_ID","ledger_index":"validated"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'nft_buy_offers',
4
    params: [{"nft_id":"NFT_ID","ledger_index":"validated"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "nft_buy_offers",
9
  "params": [
10
    {
11
      "nft_id": "NFT_ID",
12
      "ledger_index": "validated"
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "nft_buy_offers",
9
  "params": [
10
    {
11
      "nft_id": "NFT_ID",
12
      "ledger_index": "validated"
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "nft_buy_offers",
11
  params: [{"nft_id":"NFT_ID","ledger_index":"validated"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "nft_buy_offers",
11
  params: [{"nft_id":"NFT_ID","ledger_index":"validated"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "result": {
6
      "nft_id": "example_value",
7
      "offers": [
8
        {
9
          "amount": "example_value",
10
          "flags": 1,
11
          "nft_offer_index": 1,
12
          "owner": 1
13
        }
14
      ],
15
      "status": "example_value"
16
    },
17
    "warnings": [
18
      {
19
        "id": 1,
20
        "message": "example_value"
21
      }
22
    ]
23
  }
24
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "result": {
6
      "nft_id": "example_value",
7
      "offers": [
8
        {
9
          "amount": "example_value",
10
          "flags": 1,
11
          "nft_offer_index": 1,
12
          "owner": 1
13
        }
14
      ],
15
      "status": "example_value"
16
    },
17
    "warnings": [
18
      {
19
        "id": 1,
20
        "message": "example_value"
21
      }
22
    ]
23
  }
24
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free