> ## 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 Related Effects

> This endpoint represents effects referencing a given liquidity pool and can be used in streaming mode. Streaming mode allows you to listen for new effects referencing this liquidity pool as they are added to the Stellar ledger. If called in streaming mode, Horizon will start at the earliest known effect unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream effects created since your request time.

This endpoint represents effects referencing a given liquidity pool and can be used in streaming mode. Streaming mode allows you to listen for new effects referencing this liquidity pool as they are added to the Stellar ledger. If called in streaming mode, Horizon will start at the earliest known effect unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream effects 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/retrieve-related-effects)


## OpenAPI

````yaml nodeapi/openapi/horizon-openapi-vc.json GET /liquidity_pools/{liquidity_pool_id}/effects
openapi: 3.0.3
info:
  title: Horizon
  version: 0.0.1
servers:
  - url: https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>
    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:
  /liquidity_pools/{liquidity_pool_id}/effects:
    get:
      tags:
        - Liquidity Pools
      summary: Retrieve Related Effects
      description: >-
        This endpoint represents effects referencing a given liquidity pool and
        can be used in streaming mode. Streaming mode allows you to listen for
        new effects referencing this liquidity pool as they are added to the
        Stellar ledger. If called in streaming mode, Horizon will start at the
        earliest known effect unless a cursor is set, in which case it will
        start from that cursor. By setting the cursor value to now, you can
        stream effects created since your request time.
      operationId: RetrieveRelatedEffects
      parameters:
        - $ref: '#/components/parameters/LiquidityPoolParamId'
        - $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/Effect'
              examples:
                RetrieveRelatedEffects:
                  $ref: '#/components/examples/RetrieveRelatedEffects'
components:
  parameters:
    LiquidityPoolParamId:
      name: liquidity_pool_id
      in: path
      required: true
      description: A unique identifier for this liquidity pool.
      schema:
        type: string
    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'
    Effect:
      type: object
      properties:
        _embedded:
          type: object
          properties:
            records:
              type: array
              items:
                type: object
                properties:
                  _links:
                    type: object
                    properties:
                      operation:
                        $ref: '#/components/schemas/link'
                      succeeds:
                        $ref: '#/components/schemas/link'
                      precedes:
                        $ref: '#/components/schemas/link'
                  id:
                    $ref: '#/components/schemas/id'
                  paging_token:
                    $ref: '#/components/schemas/paging_token'
                  account:
                    $ref: '#/components/schemas/address'
                  type:
                    type: string
                    enum:
                      - Account Created
                      - Account Removed
                      - Account Credited
                      - Account Debited
                      - Account Thresholds Updated
                      - Account Home Domain Updated
                      - Account Flags Updated
                      - Account Inflation Destination Updated
                      - Signer Created
                      - Signer Removed
                      - Signer Updated
                      - Trustline Created
                      - Trustline Removed
                      - Trustline Updated
                      - Trustline Authorized
                      - Trustline Deauthorized
                      - Offer Created
                      - Offer Removed
                      - Offer Updated
                      - Trade
                      - Data Created
                      - Data Removed
                      - Data Updated
                      - Claimable Balance Created
                      - Claimable Balance Claimant Created
                      - Claimable Balance Claimed
                      - Account Sponsorship Created
                      - Account Sponsorship Updated
                      - Account Sponsorship Removed
                      - Trustline Sponsorship Created
                      - Trustline Sponsorship Updated
                      - Trustline Sponsorship Removed
                      - Account Data Sponsorship Created
                      - Account Data Sponsorship Updated
                      - Account Data Sponsorship Removed
                      - Claimable Balance Sponsorship Created
                      - Claimable Balance Sponsorship Updated
                      - Claimable Balance Sponsorship Removed
                      - Account Signer Sponsorship Created
                      - Account Signer Sponsorship Updated
                      - Account Signer Sponsorship Removed
                      - Liquidity Pool Created
                      - Liquidity Pool Removed
                      - Liquidity Pool Revoked
                      - Liquidity Pool Deposited
                      - Liquidity Pool Withdraw
                      - Liquidity Pool Trade
                      - Sequence Bumped
                  type_i:
                    type: number
                    example: 1
                  created_at:
                    type: string
          required:
            - id
            - paging_token
            - account
            - type
            - type_i
            - created_at
    link:
      type: object
      properties:
        href:
          type: string
          format: link
        templated:
          type: boolean
      required:
        - href
    id:
      type: string
    paging_token:
      type: string
    address:
      type: string
      pattern: G[A-Z0-9]{55}
  examples:
    RetrieveRelatedEffects:
      value:
        _links:
          self:
            href: >-
              https://horizon-testnet.stellar.org/liquidity_pools/67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9/effects?cursor=&order=asc
          next:
            href: >-
              https://horizon-testnet.stellar.org/liquidity_pools/67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9/effects?cursor=120192370561220608&order=asc
          prev:
            href: >-
              https://horizon-testnet.stellar.org/liquidity_pools/67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9/effects?cursor=120192344791343104&order=desc
        _embedded:
          records:
            - _links:
                operation:
                  href: >-
                    https://horizon-testnet.stellar.org/operations/3849085266190337
                succeeds:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=desc&cursor=3849085266190337-1
                precedes:
                  href: >-
                    https://horizon-testnet.stellar.org/effects?order=asc&cursor=3849085266190337-1
              id: 0000000012884905986-0000000001
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_deposited
              type_i: 81
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool:
                id: >-
                  67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
                fee_bp: 30
                type: constant_product
                total_trustlines: '300'
                total_shares: '5000'
                reserves:
                  - amount: '1000.0000005'
                    asset: >-
                      EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  - amount: '2000.0000000'
                    asset: >-
                      PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
              reserves_deposited:
                - asset: >-
                    EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  amount: '2378.0000005'
                - asset: PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
                  amount: '983.0000005'
              shares_received: '1000'
            - id: 0000000012884905986-0000000002
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_withdrew
              type_i: 82
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool:
                id: >-
                  67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
                fee_bp: 30
                type: constant_product
                total_trustlines: '299'
                total_shares: '4000'
                reserves:
                  - amount: '7.0000005'
                    asset: >-
                      EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  - amount: '1.0000000'
                    asset: >-
                      PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
              reserves_received:
                - asset: >-
                    EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  amount: '2478.0000005'
                - asset: PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
                  amount: '993.0000005'
              shares_redeemed: '1000'
            - id: 0000000012884905986-0000000003
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_trade
              type_i: 83
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool:
                id: >-
                  67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
                fee_bp: 30
                type: constant_product
                total_trustlines: '300'
                total_shares: '5000'
                reserves:
                  - amount: '1000.0000005'
                    asset: >-
                      EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  - amount: '2000.0000000'
                    asset: >-
                      PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
              sold:
                asset: PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
                amount: '983.0000005'
              bought:
                asset: EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                amount: '2378.0000005'
            - id: 0000000012884905986-0000000004
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_created
              type_i: 84
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool:
                id: >-
                  67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
                fee_bp: 30
                type: constant_product
                total_trustlines: '1'
                total_shares: '0'
                reserves:
                  - amount: '0'
                    asset: >-
                      EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  - amount: '0'
                    asset: >-
                      PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
            - id: 0000000012884905986-0000000005
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_removed
              type_i: 85
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool_id: 67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
            - id: 0000000012884905986-0000000006
              paging_token: 12884905986-2
              account: GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN7
              type: liquidity_pool_revoked
              type_i: 86
              created_at: '2021-11-18T03:15:54Z'
              liquidity_pool:
                id: >-
                  67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
                fee_bp: 30
                type: constant_product
                total_trustlines: '299'
                total_shares: '4000'
                reserves:
                  - amount: '7.0000005'
                    asset: >-
                      EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  - amount: '1.0000000'
                    asset: >-
                      PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
              reserves_revoked:
                - asset: >-
                    EURT:GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S
                  amount: '2478.0000005'
                  claimable_balance_id: idcbd1234
                - asset: PHP:GBUQWP3BOUZX34TOND2QV7QQ7K7VJTG6VSE7WMLBTMDJLLAW7YKGU6EP
                  amount: '993.0000005'
                  claimable_balance_id: cbid1235
              shares_revoked: '1000'
            - id: 0000000012884905986-0000000007
              paging_token: 157639717969326081-1
              account: GBBWI7TEVQBPEUXKYNGI3GBAH7EHFEREONKK3UK56ZSLJIDIYHQJCVSG
              type: trustline_created
              type_i: 20
              created_at: '2021-08-04T20:01:24Z'
              asset_type: liquidity_pool_shares
              liquidity_pool_id: 67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
              limit: '1000'
            - id: 0000000012884905986-0000000008
              paging_token: 157639717969326081-1
              account: GBBWI7TEVQBPEUXKYNGI3GBAH7EHFEREONKK3UK56ZSLJIDIYHQJCVSG
              type: trustline_updated
              type_i: 22
              created_at: '2021-08-04T20:01:24Z'
              asset_type: liquidity_pool_shares
              liquidity_pool_id: 67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
              limit: '2000'
            - id: 0000000012884905986-0000000009
              paging_token: 157639717969326081-1
              account: GBBWI7TEVQBPEUXKYNGI3GBAH7EHFEREONKK3UK56ZSLJIDIYHQJCVSG
              type: trustline_removed
              type_i: 21
              created_at: '2021-08-04T20:01:24Z'
              asset_type: liquidity_pool_shares
              liquidity_pool_id: 67260c4c1807b262ff851b0a3fe141194936bb0215b2f77447f1df11998eabb9
              limit: '0.0000000'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.