> ## Documentation Index > Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve an Account's Offers > This endpoint represents all offers a given account has currently open and 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. If called in streaming mode, Horizon will start at the earliest known offer unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream offers created since your request time. This endpoint represents all offers a given account has currently open and 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. If called in streaming mode, Horizon will start at the earliest known offer unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream offers created since your request time. This method will use `20` [Compute Units](/nodeapi/about/billing). *** ## Reference: [Here](https://developers.stellar.org/docs/data/apis/horizon/api-reference/get-offers-by-account-id) ## OpenAPI ````yaml nodeapi/openapi/horizon-openapi-vc.json GET /accounts/{account_id}/offers openapi: 3.0.3 info: title: Horizon version: 0.0.1 servers: - url: https://mainnet.stellar.validationcloud.io/v1/ description: The Pubnet Network security: [] tags: - name: Accounts description: >- Users interact with the Stellar network through accounts. Everything else in the ledger—assets, offers, trustlines, etc. are owned by accounts, and accounts must authorize all changes to the ledger through signed transactions. - name: Assets description: >- Assets are representations of value issued on the Stellar network. An asset consists of a type, code, and issuer. - name: Claimable Balances description: >- A Claimable Balance represents the transfer of ownership of some amount of an asset. Claimable balances provide a mechanism for setting up a payment which can be claimed in the future. This allows you to make payments to accounts which are currently not able to accept them. - name: Effects description: >- Effects represent specific changes that occur in the ledger as a result of successful operations, but are not necessarily directly reflected in the ledger or history, as transactions and operations are. - name: Fee Stats description: >- Fee stats are used to predict what fee to set for a transaction before submitting it to the network. - name: Liquidity Pools description: >- Liquidity Pools provide a simple, non-interactive way to trade large amounts of capital and enable high volumes of trading. - name: Ledgers description: >- Each ledger stores the state of the network at a point in time and contains all the changes - transactions, operations, effects, etc. - to that state. - name: Offers description: >- Offers are statements about how much of an asset an account wants to buy or sell. - name: Order Books description: An order book is a collections of offers for a specific pair of assets. - name: Trade Aggregations description: >- A trade aggregation represents aggregated statistics on an asset pair (base and counter) for a specific time period. Trade aggregations are useful to developers of trading clients and provide historical trade data. - name: Trades description: >- When an offer is fully or partially fulfilled, a trade happens. Trades can also be caused by successful path payments, because path payments involve fulfilling offers. A trade occurs between two parties—base and counter. Which is which is either arbitrary or determined by the calling query. - name: Transactions description: >- Transactions are commands that modify the ledger state and consist of one or more operations. paths: /accounts/{account_id}/offers: get: tags: - Accounts summary: Retrieve an Account's Offers description: >- This endpoint represents all offers a given account has currently open and 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. If called in streaming mode, Horizon will start at the earliest known offer unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream offers created since your request time. operationId: GetOffersByAccountId parameters: - $ref: '#/components/parameters/AccountIDParam' - $ref: '#/components/parameters/CursorParam' - $ref: '#/components/parameters/OrderParam' - $ref: '#/components/parameters/LimitParam' responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/Links' - $ref: '#/components/schemas/Offer' examples: RetrieveAnAccountsOffers: $ref: '#/components/examples/RetrieveAnAccountsOffers' components: parameters: AccountIDParam: name: account_id in: path required: true description: This account’s public key encoded in a base32 string representation. schema: type: string example: GDMQQNJM4UL7QIA66P7R2PZHMQINWZBM77BEBMHLFXD5JEUAHGJ7R4JZ CursorParam: name: cursor in: query required: false description: >- A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record. schema: type: integer example: 6606617478959105 OrderParam: name: order in: query required: false description: >- A designation of the order in which records should appear. Options include asc (ascending) or desc (descending). If this argument isn’t set, it defaults to asc. schema: type: string enum: - asc - desc LimitParam: name: limit in: query required: false description: >- The maximum number of records returned. The limit can range from 1 to 200 - an upper limit that is hardcoded in Horizon for performance reasons. If this argument isn’t designated, it defaults to 10. schema: type: integer example: 10 schemas: Links: type: object properties: _links: type: object properties: self: $ref: '#/components/schemas/link' next: $ref: '#/components/schemas/link' prev: $ref: '#/components/schemas/link' Offer: type: object properties: _embedded: type: object properties: records: type: array items: type: object properties: _links: type: object properties: self: $ref: '#/components/schemas/link' offer_maker: $ref: '#/components/schemas/link' required: - self - offer_maker id: $ref: '#/components/schemas/id' paging_token: type: string seller: $ref: '#/components/schemas/address' selling: $ref: '#/components/schemas/BaseAsset' buying: $ref: '#/components/schemas/BaseAsset' amount: type: string price_r: $ref: '#/components/schemas/Price' price: type: string last_modified_ledger: $ref: '#/components/schemas/last_modified_ledger' last_modified_time: type: string sponser: type: string required: - id - paging_token - seller - selling - buying - amount - price_r - price - last_modified_ledger - last_modified_time link: type: object properties: href: type: string format: link templated: type: boolean required: - href id: type: string address: type: string pattern: G[A-Z0-9]{55} BaseAsset: type: object properties: asset_type: type: string asset_code: type: string asset_issuer: type: string required: - asset_type Price: type: object properties: 'n': type: integer format: int32 d: type: integer format: int32 last_modified_ledger: type: integer format: uint32 examples: RetrieveAnAccountsOffers: value: _links: self: href: "https://\thorizon-testnet.stellar.org/accounts/GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K/offers?cursor=&limit=10&order=asc" next: href: "https://\thorizon-testnet.stellar.org/accounts/GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K/offers?cursor=164943216&limit=10&order=asc" prev: href: "https://\thorizon-testnet.stellar.org/accounts/GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K/offers?cursor=164555927&limit=10&order=desc" _embedded: records: - _links: self: href: "https://\thorizon-testnet.stellar.org/offers/164555927" offer_maker: href: "https://\thorizon-testnet.stellar.org/accounts/GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K" id: 164555927 paging_token: '164555927' seller: GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K selling: asset_type: native buying: asset_type: credit_alphanum4 asset_code: BB1 asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN amount: '214.9999939' price_r: 'n': 10000000 d: 86000001 price: '0.1162791' last_modified_ledger: 28383147 last_modified_time: '2020-02-24T22:58:38Z' - _links: self: href: "https://\thorizon-testnet.stellar.org/offers/164943216" offer_maker: href: "https://\thorizon-testnet.stellar.org/accounts/GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K" id: 164943216 paging_token: '164943216' seller: GD3CJYUTZAY6JQF4CEI6Z7VW5O6VNGKZTBYUECTOJPEDTB7I2HZSPI2K selling: asset_type: credit_alphanum4 asset_code: BB1 asset_issuer: GD5J6HLF5666X4AZLTFTXLY46J5SW7EXRKBLEYPJP33S33MXZGV6CWFN buying: asset_type: native amount: '24.9999990' price_r: 'n': 32224991 d: 2500000 price: '12.8899964' last_modified_ledger: 28394149 last_modified_time: '2020-02-25T15:49:57Z' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.