List All Claimable Balances

This endpoint lists all available claimable balances.

This method will use 20 Compute Units.

Reference: Here

PreviousClaimable Balances NextRetrieve a Claimable Balance

Last updated 8 months ago

Was this helpful?

List All Claimable Balances

This endpoint lists all available claimable balances.

get

/claimable_balances

Query parameters

sponserstring

Account ID of the sponsor. Every account in the response will either be sponsored by the given account ID or have a subentry (trustline, offer, or data entry) which is sponsored by the given account ID.

Example: GDMQQNJM4UL7QIA66P7R2PZHMQINWZBM77BEBMHLFXD5JEUAHGJ7R4JZ

assetany

An issued asset represented as “Code:IssuerAccountID”. Every account in the response will have a trustline for the given asset.

claimantany

Account ID of the destination address. Only include claimable balances which can be claimed by the given account ID.

cursorinteger

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

Example: 6606617478959105

orderstring · enum

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.

Options: asc, desc

limitinteger

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.

Example: 10

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://mainnet.stellar.validationcloud.io/v1/<YOUR_API_KEY_HERE>/claimable_balances'

200

{
  "_links": {
    "self": {
      "href": "https://horizon-testnet.stellar.org/claimable_balances?asset=native&cursor=&limit=10&order=asc"
    },
    "next": {
      "href": "https://horizon-testnet.stellar.org/claimable_balances?asset=native&cursor=35938300-0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba&limit=10&order=asc"
    },
    "prev": {
      "href": "https://horizon-testnet.stellar.org/claimable_balances?asset=native&cursor=33324106-00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f&limit=10&order=desc"
    }
  },
  "_embedded": {
    "records": [
      {
        "id": "00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f",
        "asset": "native",
        "amount": "0.1000000",
        "sponsor": "GDOZMXWISPB57FITUQIGTFH2KNNW7QTFESXF5DZEAMZK6QHE3KVO5TRT",
        "last_modified_ledger": 33324106,
        "last_modified_time": "2020-12-30T23:02:56Z",
        "paging_token": "33324106-00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000691787983bc3ea12361092fe49ae83cbbe37804ee1590fe2b9b3e3860fc8261f/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GCD3T6UIQLYZPGRCYVSE7LKQB5HYYNVT7ENY6RCSFRFQYR5JTBDCECO3",
            "predicate": {
              "and": [
                {
                  "abs_before": "2020-12-30T23:03:56Z",
                  "abs_before_epoch": "1609369436"
                },
                {
                  "not": {
                    "abs_before": "2020-12-30T23:05:56Z",
                    "abs_before_epoch": "1609369556"
                  }
                }
              ]
            }
          }
        ]
      },
      {
        "id": "000000003a9a08342ca45d96abc011278644d83d1718ab16e44209fa1952829b66017c28",
        "asset": "native",
        "amount": "1.0000000",
        "sponsor": "GA5ACYSBFH5AFWMZ5T34FLT5W3X6Z4FT4PMN3NUDT3G2JCYJXYGD72EF",
        "last_modified_ledger": 33505955,
        "last_modified_time": "2021-01-12T21:02:00Z",
        "paging_token": "33505955-000000003a9a08342ca45d96abc011278644d83d1718ab16e44209fa1952829b66017c28",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000003a9a08342ca45d96abc011278644d83d1718ab16e44209fa1952829b66017c28"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000003a9a08342ca45d96abc011278644d83d1718ab16e44209fa1952829b66017c28/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000003a9a08342ca45d96abc011278644d83d1718ab16e44209fa1952829b66017c28/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GCXAULI3NAFEUKIXUQTD3HXGCTTLM6KVGKTUBZIHVUDP6WXEF7RWJV67",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "0000000063036dcfa438cb51180bea16e36850e3699efc934577b07322c818157e4d5411",
        "asset": "native",
        "amount": "0.0010000",
        "sponsor": "GBIIQM26JJS774T7CSP3WBFVUXHUCTZCV5ZPGMKL57POWMFPMLYOKOZQ",
        "last_modified_ledger": 34254613,
        "last_modified_time": "2021-03-03T10:36:28Z",
        "paging_token": "34254613-0000000063036dcfa438cb51180bea16e36850e3699efc934577b07322c818157e4d5411",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000063036dcfa438cb51180bea16e36850e3699efc934577b07322c818157e4d5411"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000063036dcfa438cb51180bea16e36850e3699efc934577b07322c818157e4d5411/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000063036dcfa438cb51180bea16e36850e3699efc934577b07322c818157e4d5411/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GBIIQM26JJS774T7CSP3WBFVUXHUCTZCV5ZPGMKL57POWMFPMLYOKOZQ",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "00000000d076fe2df3e6cc5e5c28e7bf257c11eb209d703a681c58bb867b78b67235c694",
        "asset": "native",
        "amount": "0.0010000",
        "sponsor": "GANVXZ2DQ2FFLVCBSVMBBNVWSXS6YVEDP247EN4C3CM3I32XR4U3OU2I",
        "last_modified_ledger": 34255259,
        "last_modified_time": "2021-03-03T11:35:31Z",
        "paging_token": "34255259-00000000d076fe2df3e6cc5e5c28e7bf257c11eb209d703a681c58bb867b78b67235c694",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d076fe2df3e6cc5e5c28e7bf257c11eb209d703a681c58bb867b78b67235c694"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d076fe2df3e6cc5e5c28e7bf257c11eb209d703a681c58bb867b78b67235c694/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d076fe2df3e6cc5e5c28e7bf257c11eb209d703a681c58bb867b78b67235c694/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GANVXZ2DQ2FFLVCBSVMBBNVWSXS6YVEDP247EN4C3CM3I32XR4U3OU2I",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "00000000da8ed8d0dccacce237c5395eb07bb845d2bb96425d18d168d535063316d99e7f",
        "asset": "native",
        "amount": "1.0000000",
        "sponsor": "GB7OYQFQI7GH622CKCFWPH4WSZUGOXXNY2XWV5K27S3SW2JHOWCCWEJ4",
        "last_modified_ledger": 35023766,
        "last_modified_time": "2021-04-20T19:00:04Z",
        "paging_token": "35023766-00000000da8ed8d0dccacce237c5395eb07bb845d2bb96425d18d168d535063316d99e7f",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000da8ed8d0dccacce237c5395eb07bb845d2bb96425d18d168d535063316d99e7f"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000da8ed8d0dccacce237c5395eb07bb845d2bb96425d18d168d535063316d99e7f/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000da8ed8d0dccacce237c5395eb07bb845d2bb96425d18d168d535063316d99e7f/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GAV2USD4ELGLRWBT67V7N37QAJKOPLHUJL3AVFW5NHWDHVXL4EQPSWZ5",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "00000000c551a949d0fb5199b05cb8220b4ba7dad4cd7968c849ab0fb51f744daab864fe",
        "asset": "native",
        "amount": "0.2091529",
        "sponsor": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
        "last_modified_ledger": 35530330,
        "last_modified_time": "2021-05-22T17:04:31Z",
        "paging_token": "35530330-00000000c551a949d0fb5199b05cb8220b4ba7dad4cd7968c849ab0fb51f744daab864fe",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000c551a949d0fb5199b05cb8220b4ba7dad4cd7968c849ab0fb51f744daab864fe"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000c551a949d0fb5199b05cb8220b4ba7dad4cd7968c849ab0fb51f744daab864fe/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000c551a949d0fb5199b05cb8220b4ba7dad4cd7968c849ab0fb51f744daab864fe/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GCSZDAUKEX3IZXXUEEMERIYTVKHDTVTWK7LHXHELZE5B472QMGGXQLHD",
            "predicate": {
              "unconditional": true
            }
          },
          {
            "destination": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "00000000d1f2ad9c1ff9124de62f9721ed5811f1f0d7705660c5a7daaa174ad5100c6b4d",
        "asset": "native",
        "amount": "0.2091529",
        "sponsor": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
        "last_modified_ledger": 35530330,
        "last_modified_time": "2021-05-22T17:04:31Z",
        "paging_token": "35530330-00000000d1f2ad9c1ff9124de62f9721ed5811f1f0d7705660c5a7daaa174ad5100c6b4d",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d1f2ad9c1ff9124de62f9721ed5811f1f0d7705660c5a7daaa174ad5100c6b4d"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d1f2ad9c1ff9124de62f9721ed5811f1f0d7705660c5a7daaa174ad5100c6b4d/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000d1f2ad9c1ff9124de62f9721ed5811f1f0d7705660c5a7daaa174ad5100c6b4d/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GBO4FL74OZTOCTABWFS2PH4LGI2CHFABDZ2LBPRH6UECXBAIU5LUIOF2",
            "predicate": {
              "unconditional": true
            }
          },
          {
            "destination": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "000000001b53636a29ca25d28d1c5bb165f55280167d53cfefb0ce297d98032b32f772d0",
        "asset": "native",
        "amount": "4.2696061",
        "sponsor": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
        "last_modified_ledger": 35686528,
        "last_modified_time": "2021-06-01T13:29:59Z",
        "paging_token": "35686528-000000001b53636a29ca25d28d1c5bb165f55280167d53cfefb0ce297d98032b32f772d0",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000001b53636a29ca25d28d1c5bb165f55280167d53cfefb0ce297d98032b32f772d0"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000001b53636a29ca25d28d1c5bb165f55280167d53cfefb0ce297d98032b32f772d0/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/000000001b53636a29ca25d28d1c5bb165f55280167d53cfefb0ce297d98032b32f772d0/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GD54EZPKQCBZKPI6F4KKYYLGLDWBOVKPXBL3BLFGYNCLTBFGFZZGVMRT",
            "predicate": {
              "unconditional": true
            }
          },
          {
            "destination": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "00000000ff1bb4a01b1d4e62ba23bcfd4e2c2289c63fe5ae0368f85b79d74a2224f8ab6c",
        "asset": "native",
        "amount": "29.8872425",
        "sponsor": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
        "last_modified_ledger": 35686528,
        "last_modified_time": "2021-06-01T13:29:59Z",
        "paging_token": "35686528-00000000ff1bb4a01b1d4e62ba23bcfd4e2c2289c63fe5ae0368f85b79d74a2224f8ab6c",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000ff1bb4a01b1d4e62ba23bcfd4e2c2289c63fe5ae0368f85b79d74a2224f8ab6c"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000ff1bb4a01b1d4e62ba23bcfd4e2c2289c63fe5ae0368f85b79d74a2224f8ab6c/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/00000000ff1bb4a01b1d4e62ba23bcfd4e2c2289c63fe5ae0368f85b79d74a2224f8ab6c/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GB2QQWOA32GRILAOZ57H5Z5MO52KNUO3WHJWVZZHWSN66LLDPXQMSILD",
            "predicate": {
              "unconditional": true
            }
          },
          {
            "destination": "GA5WWLUYCR4XJKS4ZYKWATKC7E3AVM3FZLWXWSKOBZWAGDROF5MUQXAT",
            "predicate": {
              "unconditional": true
            }
          }
        ]
      },
      {
        "id": "0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba",
        "asset": "native",
        "amount": "0.0000400",
        "sponsor": "GB6DNEWWSSPQAX7SR5MCWUTRVQPJBAERJTUQAZOVXXJDU2E6PIMKGMO2",
        "last_modified_ledger": 35938300,
        "last_modified_time": "2021-06-17T10:37:03Z",
        "paging_token": "35938300-0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba",
        "flags": {
          "clawback_enabled": false
        },
        "_links": {
          "self": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba"
          },
          "transactions": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba/transactions{?cursor,limit,order}",
            "templated": true
          },
          "operations": {
            "href": "https://horizon-testnet.stellar.org/claimable_balances/0000000017b9a95e25aa60200b52cc04f75c496dca76dc19fec21c942dfb35cce23c3eba/operations{?cursor,limit,order}",
            "templated": true
          }
        },
        "claimants": [
          {
            "destination": "GC2CMMOQ2BUFI33PPOLNJKMQYJGAXUP2KMZXEXE6TGE37JSXQPHI4UAE",
            "predicate": {
              "and": [
                {
                  "abs_before": "2021-07-16T21:00:00Z",
                  "abs_before_epoch": "1626469200"
                },
                {
                  "abs_before": "2021-08-16T21:00:00Z",
                  "abs_before_epoch": "1629147600"
                }
              ]
            }
          }
        ]
      }
    ]
  }
}

Success