Skip to main content

The Order Book Object

When Horizon returns information about an order book, it uses the following format:

  • ATTRIBUTEDATA TYPE

    DESCRIPTION

  • bidsobject

    The prices and amounts for the buyside of the asset pair.

    Show child attributes
  • price_robject

    A precise representation of the bid price of the asset pair.

    Show child attributes
  • nnumber

    The numerator.

  • dnumber

    The denominator.

  • pricestring

    The bid price of the base asset denominated in the counter asset. A number representing the decimal form of price_r.

  • amountstring

    The amount of counter asset that the account making this offer is willing to buy at this price.

  • asksobject

    The prices and amounts for the sellside of the asset pair.

    Show child attributes
  • price_robject

    A precise representation of the ask price of the asset pair.

    Show child attributes
  • nnumber

    The numerator.

  • dnumber

    The denominator.

  • pricestring

    The ask price of the base asset denominated in the counter asset. A number representing the decimal form of price_r.

  • amountstring

    The amount of counter asset that the account making this offer is willing to sell at this price.

  • baseobject

    Details about the base asset.

    Show child attributes
  • asset_typestring

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

  • asset_codestring

    The code for the base asset.

  • asset_issuerstring

    The Stellar address of the base asset’s issuer.

  • counterobject

    Details about the counter asset.

    Show child attributes
  • asset_typestring

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

  • asset_codestring

    The code for the counter asset.

  • asset_issuerstring

    The Stellar address of the counter asset’s issuer.

  • The latest ledger known to Horizon is included as an HTTP header in the response.

    Example
    {
    "bids": [
    {
    "price_r": {
    "n": 6014600,
    "d": 102275119
    },
    "price": "0.0588080",
    "amount": "0.1722469"
    },
    {
    "price_r": {
    "n": 1250000,
    "d": 21831117
    },
    "price": "0.0572577",
    "amount": "0.2991796"
    }
    ],
    "asks": [
    {
    "price_r": {
    "n": 118163,
    "d": 2000000
    },
    "price": "0.0590815",
    "amount": "8057.2710223"
    },
    {
    "price_r": {
    "n": 60627,
    "d": 1000000
    },
    "price": "0.0606270",
    "amount": "10000.0000000"
    }
    ],
    "base": {
    "asset_type": "native"
    },
    "counter": {
    "asset_type": "credit_alphanum4",
    "asset_code": "USD",
    "asset_issuer": "GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX"
    }
    }