Skip to main content

Retrieve an Account Offers REST API Endpoint

Retrieve offers associated with a particular account using its account ID

Updated on
Oct 4, 2023

Retrieve an Account Offers REST API Endpoint

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'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free