Skip to content

/pool

/pool/active?<token>&<pkh>

Get list of active pools for given token and/or user.

User is 20 byte hash of a users public key, same as encoded in their cashaddr.

Token is the 32 byte token ID.

Example results

Query: /cauldron/pool/active/?token=b79bfc8246b5fc4707e7c7dedcb6619ef1ab91f494a790c20b0f4c422ed95b92

{
  "active": [
    {
      "owner_p2pkh_addr": "bitcoincash:zqmvqqsd6w08e4nvy8er0hzn6wzxvxj40u7tlk8wl3",
      "owner_pkh": "36c0020dd39e7cd66c21f237dc53d384661a557f",
      "sats": 776661580,
      "token_id": "b79bfc8246b5fc4707e7c7dedcb6619ef1ab91f494a790c20b0f4c422ed95b92",
      "tokens": 16,
      "tx_pos": 0,
      "txid": "94a933a0fa55093a0965eb867f1b9cac2bb07488ced4825bc31f86c9371f76aa"
    }
  ]
}

/pool/list_by_apy

List of pools ordered by highest APY.

Query: /cauldron/pool/list_by_apy

{
  "pools": [
    {
      "apy": 1329.314599388565,
      "pool_yield": 223.5651398319447,
      "sats": 1761,
      "token_id": "750743caae9c2bbd57934409f73c0eb2083a79254fcae6e7781b78800b1c4b13",
      "tokens": 214875,
      "tx_pos": 9,
      "txid": "2c373f46c73714920386e9372b687dad41ef806adaf63f9380c4269c582b1082"
    },
  ]
}

/pool/aggregated_apy?<token>&<pkh>&<start>&<end>

token: The 32 byte token ID

pkh: Public key hash for wallet account

start: Unix timestamp for period start (default 30 days)

end: Unix timestamp for period end (default NOW)

Fetch apy for a token and/or an account within a given time interval. All variables are optional. A query with no variables will return the AAPY based on all users and all tokens aggregated.

Example results

AAPY from MUSDv1 the last 30 days.

Query: /cauldron/pool/aggregated_apy?token=b38a33f750f84c5c169a6f23cb873e6e79605021585d4f3408789689ed87f366

{
  "apy":"17.53540060038928169876942871",
  "pools":133
}