Skip to main content

List All Ledgers



This endpoint lists all ledgers and can be used in streaming mode. Streaming mode allows you to listen for new ledgers as they close. If called in streaming mode, Horizon will start at the earliest known ledger unless a cursor is set, in which case it will start from that cursor. By setting the cursor value to now, you can stream ledgers since your request time.


Query Parameters

    cursor integer

    A number that points to a specific location in a collection of responses and is pulled from the paging_token value of a record.

    order string

    Possible values: [asc, desc]

    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.

    limit integer

    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.



    _embedded object
    records object[]
  • Array [
  • _links object
    self objectrequired
    href linkrequired
    templated boolean
    transactions objectrequired
    href linkrequired
    templated boolean
    operations objectrequired
    href linkrequired
    templated boolean
    payments object
    href linkrequired
    templated boolean
    effects objectrequired
    href linkrequired
    templated boolean
    id id (string)
    paging_token paging_token (string)
    hash hash (string)
    pre_hash hash (string)
    sequence int32
    successful_transaction_count int32
    failed_transaction_count int32
    operation_count int32
    tx_set_operation_count int32
    closed_at string
    total_coins string
    fee_pool string
    base_fee_in_stroops int32
    base_reserve_in_stroops int32
    max_tx_set_size int32
    protocol_version int32
    header_xdr string
  • ]