Skip to main content

Liquidity Pool Trade Effects

Liquidity pools on Stellar support AMMs. Bitquery's Liquidity TradePoolEffects API gives you trade effects information regarding liquidity pools. The following are the fields in the schema:

query ($network: StellarNetwork!) {
  stellar(network: $network) {
    liquidityPoolTradeEffects(
      buyIssuer: {is: "an address"}
    ) {
      transaction {
        sender
        index
        hash
      }
      timestamp {
        time
      }
      sellIssuer {
        address
        annotation
      }
      sellCurrency {
        address
        decimals
        name
        symbol
        tokenId
        tokenType
      }
      sellAmount
      order
      operation {
        name
        index
      }
      liquidityPoolId
      liquidityPoolDetails
      effectIndex
      buyIssuer {
        address
        annotation
      }
      buyCurrency {
        address
        decimals
        name
        tokenId
        tokenType
        symbol
      }
      buyAmount
      address {
        annotation
        address
      }
    }
  }
}
{
  "network": "stellar"
}

Filtering Trade Effects API

  • buyIssuer

    The issuer of the asset that was bought in the liquidity pool trade effect. The is operator is used to specify that the issuer must be equal to the value of the $buyIssuer variable.

  • transactionSender

    The address of the account that sent the transaction that created the liquidity pool trade effect.

  • transactionIndex

    The index of the transaction that created the liquidity pool trade effect in the ledger.

  • transactionHash

    The hash of the transaction that created the liquidity pool trade effect.

  • time

    The time at which the liquidity pool trade effect was created.

  • sellIssuer

    The issuer of the asset that was sold in the liquidity pool trade effect. The is operator is used to specify that the issuer must be equal to the value of the $sellIssuer variable.

  • sellCurrencyName

    The name of the asset that was sold in the liquidity pool trade effect. The is operator is used to specify that the name must be equal to the value of the $sellCurrencyName variable.

  • sellAmount

    The amount of the asset that was sold in the liquidity pool trade effect.

  • options

    This object specifies the options for the query. The following fields are supported:

    • limit - The maximum number of results to return.
    • offset - The offset from the first result to return.
    • asc or desc The liquidity pool trade effects will be ordered in ascending order by the field mentioned

  • opSourceAccount

    The account that was the source of the liquidity pool trade effect.

  • opIndex

    The index of the operation that created the liquidity pool trade effect in the transaction.

  • operation

    The operation that created the liquidity pool trade effect.

  • liquidityPoolId

    The identifier of the liquidity pool that was involved in the liquidity pool trade effect.

  • liquidityPoolDetails

    The details of the liquidity pool that was involved in the liquidity pool trade effect. This includes the name, asset pair, and pool type.

  • effectIndex

    The index of the liquidity pool trade effect in the transaction.

  • date

    The date on which the liquidity pool trade effect was created.

  • buyCurrencyName

    The name of the asset that was bought in the liquidity pool trade effect. The is operator is used to specify that the name must be equal to the value of the $buyCurrencyName variable.

  • buyAmount

    The amount of the asset that was bought in the liquidity pool trade effect.

  • block

    The number of the block in which the liquidity pool trade effect was created.

  • any

    A catch-all field (OR logic) that can be used to filter for liquidity pool trade effects that match any of the other fields.

  • address

    The address of the account that was affected by the liquidity pool trade effect.

Fields​

  • transaction

    The transaction that created the liquidity pool trade effect. This includes the hash, index, and sender of the transaction.

  • timestamp

    The time at which the liquidity pool trade effect was created.

  • sellIssuer

    The issuer of the asset that was sold in the liquidity pool trade effect.

  • sellCurrency

    The asset that was sold in the liquidity pool trade effect in Lumens

  • sellAmount

    The amount of the asset that was sold in the liquidity pool trade effect.

  • order

    The order of the liquidity pool trade effect.

  • operation

    The operation that created the liquidity pool trade effect.

  • liquidityPoolId

    The identifier of the liquidity pool that was involved in the liquidity pool trade effect.

  • liquidityPoolDetails

    The details of the liquidity pool that was involved in the liquidity pool trade effect. This includes the name, asset pair, and pool type.

  • effectIndex

    The index of the liquidity pool trade effect in the transaction.

  • buyIssuer

    The issuer of the asset that was bought in the liquidity pool trade effect.

  • buyCurrency

    The asset that was bought in the liquidity pool trade effect in Lumens

  • buyAmount

    The amount of the asset that was bought in the liquidity pool trade effect.

  • address

    The address of the account that was affected by the liquidity pool trade effect.