Skip to main content

The Trade Object

When Horizon returns information about a trade, it uses the following format:

  • ATTRIBUTEDATA TYPE

    DESCRIPTION

  • idstring

    A unique identifier for this trade.

  • paging_tokennumber

    A cursor value for use in pagination.

  • ledger_close_timestring

    An ISO 8601 formatted string of when the ledger with this trade was closed.

  • base_accountstring (optional)

    The account ID of the base party for this trade.

  • base_offer_idstring (optional)

    The base offer ID. If this offer was immediately and fully consumed, this will be a synethic ID.

  • base_liquidity_pool_idstring (optional)

    The base liquidity pool ID. If this trade was executed against a liquidity pool.

  • base_amountstring

    The amount of the base asset that was moved from base_account to counter_account.

  • base_asset_typestring

    The type for the base asset. Either native, credit_alphanum4, or credit_alphanum12.

  • base_asset_codestring

    The code for the base asset.

  • base_asset_issuerstring

    The Stellar address of the base asset’s issuer.

  • counter_accountstring (optional)

    The account ID of the base party for this trade.

  • counter_offer_idstring (optional)

    The counter offer ID. If this offer was immediately and fully consumed, this will be a synethic ID.

  • counter_liquidity_pool_idstring (optional)

    The counter liquidity pool ID. If this trade was executed against a liquidity pool.

  • counter_amountstring

    The amount of the counter asset that was moved from counter_account to base_account.

  • counter_asset_typestring

    The type for the counter asset. Either native, credit_alphanum4, or credit_alphanum12.

  • counter_asset_codestring

    The code for the counter asset.

  • counter_asset_issuerstring

    The Stellar address of the counter asset’s issuer.

  • priceobject

    An object of a number numerator and number denominator that represents the original offer price. To derive the price, divide n by d. n and d are represented as strings because they might be 64-bit integers.

    Show child attributes

  • nstring

    The numerator.

  • dstring

    The denominator.

  • base_is_sellerboolean

    Indicates with party is the seller.

    • Example
    {
      "_links": {
        "self": {
          "href": ""
        },
        "base": {
          "href": "https://horizon-testnet.stellar.org/accounts/GA23DVJUJVXUQ45SKQMZR7KH2ZOOBFWGWSEXHCT7VVKP2TYIMCQTQGNQ"
        },
        "counter": {
          "href": "https://horizon-testnet.stellar.org/accounts/GAFGG7CRFRCJLBHGI5L4IZD4QYR4GDX5NKB46CE4KZMNBILBTP3L4M75"
        },
        "operation": {
          "href": "https://horizon-testnet.stellar.org/operations/100089067462524929"
        }
      },
      "id": "100089067462524929-0",
      "paging_token": "100089067462524929-0",
      "ledger_close_time": "2019-04-07T11:30:03Z",
      "offer_id": "79502917",
      "base_offer_id": "4711775085889912833",
      "base_account": "GA23DVJUJVXUQ45SKQMZR7KH2ZOOBFWGWSEXHCT7VVKP2TYIMCQTQGNQ",
      "base_amount": "99.9999996",
      "base_asset_type": "native",
      "counter_offer_id": "79502917",
      "counter_account": "GAFGG7CRFRCJLBHGI5L4IZD4QYR4GDX5NKB46CE4KZMNBILBTP3L4M75",
      "counter_amount": "11.4722884",
      "counter_asset_type": "credit_alphanum4",
      "counter_asset_code": "EURT",
      "counter_asset_issuer": "GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S",
      "base_is_seller": false,
      "price": {
        "n": "10000000",
        "d": "87166567"
      }
    }