Please note that this method can be used in streaming mode. Streaming mode allows you to listen for new offers for this account as they are added to the Stellar ledger.

Path Parameters

account_id

string

REQUIRED

The account id to retrieve transaction records

Query Parameters

cursor

integer

The position of the data set to retrieve

order

string

The order in which transactions are retrieved. The possible values include ascending and descending order

limit

integer

The maximum number of transactions to retrieve in a single request

Returns

_links

object

The links related to the account data

self

object

The self-reference link

href

string

The URL for self-reference

templated

boolean

A boolean value that indicates whether the link is templated or not

next

object

The link to the next set of data

href

string

The URL for next set of data

templated

boolean

A boolean value that indicates whether the link is templated or not

prev

object

The link to the previous set of data

href

string

The URL for previous set of data

templated

boolean

A boolean value that indicates whether the link is templated or not

id

string

The unique identifier of the offer

paging_token

string

The paging token for the offer record, aiding in navigation

seller

string

The public key of the account that created the offer

selling

string

Details about the asset being sold in the offer

asset_type

string

The code of the asset being sold

asset_code

string

The code of the asset being sold

asset_issuer

string

The issuer's public key of the asset being sold

buying

string

Details about the asset being bought in exchange for the selling asset

asset_type

string

The type of the asset being bought, which could be native or credit_alphanum4/12

asset_code

string

The code of the asset being bought

asset_issuer

string

The issuer's public key of the asset being bought

amount

string

The amount of the selling asset that the offer is willing to exchange

price

string

The rational representation of the price of the offer

n

integer

The numerator

d

integer

The denominator

price

string

The decimal representation of the price calculated from price_r

last_modified_ledger

string

The ledger sequence number in which the offer was last modifiedr

last_modified_time

string

The timestamp when the offer was last modified

sponsor

string

The account ID of the sponsor

Request

1
curl -L -X GET 'https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers' \
2
-H 'Accept: application/json'

1
curl -L -X GET 'https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers' \
2
-H 'Accept: application/json'

1
var myHeaders = new Headers();
2
myHeaders.append("Accept", "application/json");
3

4
var requestOptions = {
5
  method: 'GET',
6
  headers: myHeaders,
7
  redirect: 'follow'
8
};
9

10
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers", requestOptions)
11
  .then(response => response.text())
12
  .then(result => console.log(result))
13
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Accept", "application/json");
3

4
var requestOptions = {
5
  method: 'GET',
6
  headers: myHeaders,
7
  redirect: 'follow'
8
};
9

10
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers", requestOptions)
11
  .then(response => response.text())
12
  .then(result => console.log(result))
13
  .catch(error => console.log('error', error));

1
import requests
2

3
url = "https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers"
4

5
payload = {}
6
headers = {
7
  'Accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
import requests
2

3
url = "https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers"
4

5
payload = {}
6
headers = {
7
  'Accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

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

4
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["Accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

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

4
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/accounts/GAHGP55YRY3GPLDAB7OSDFXK2JCPS5YN2B3ZKXCRCBBYQUELEF5LBXV5/offers")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["Accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free