Beta API

The Beta API is in... beta.

Note: The Beta API is currently disabled for some much-needed updates. If you need to use it, please contact us.

Beta currently offers information about singletons.

FireAcademy.io

Leaflet can be acessed at https://kraken.fireacademy.io/beta/ or https://kraken.fireacademy.io/{api-key}/beta/. Billing is based on the number of returned results, with each result costing 42 credits. Each request consumes at least 42 credits:

request_cost = 42 * max(num_results, 1)

API

For a better experience, please refer to this generated page.

Puzzles

Wondering what's hidden behind a singleton's inner puzzle hash? Use this endpoint to find out!

returns the stored puzzle for a given puzzle_hash

post

Beta stores all revealed inner puzzles of singletons. Use this method to get it from the corresponding puzzle hash. The puzzle will be returned as a hex string.

Authorizations

Body

puzzle_hashstringOptionalExample: 6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba

Responses

post

HTTPcURLJavaScriptPython

POST /beta/get_puzzle HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "puzzle_hash": "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba"
}

{
  "result": {
    "puzzle": "ff02ffff01ff02ffff01ff02ff3effff04ff02ffff04ff05ffff04ffff02ff2fff5f80ffff04ff80ffff04ffff04ffff04ff0bffff04ff17ff808080ffff01ff808080ffff01ff8080808080808080ffff04ffff01ffffff0233ff04ff0101ffff02ff02ffff03ff05ffff01ff02ff1affff04ff02ffff04ff0dffff04ffff0bff12ffff0bff2cff1480ffff0bff12ffff0bff12ffff0bff2cff3c80ff0980ffff0bff12ff0bffff0bff2cff8080808080ff8080808080ffff010b80ff0180ffff0bff12ffff0bff2cff1080ffff0bff12ffff0bff12ffff0bff2cff3c80ff0580ffff0bff12ffff02ff1affff04ff02ffff04ff07ffff04ffff0bff2cff2c80ff8080808080ffff0bff2cff8080808080ffff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff2effff04ff02ffff04ff09ff80808080ffff02ff2effff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff02ffff03ff0bffff01ff02ffff03ffff09ff23ff1880ffff01ff02ffff03ffff18ff81b3ff2c80ffff01ff02ffff03ffff20ff1780ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff33ffff04ff2fffff04ff5fff8080808080808080ffff01ff088080ff0180ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff0180ffff01ff02ffff03ffff09ff23ffff0181e880ffff01ff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ffff02ffff03ffff22ffff09ffff02ff2effff04ff02ffff04ff53ff80808080ff82014f80ffff20ff5f8080ffff01ff02ff53ffff04ff818fffff04ff82014fffff04ff81b3ff8080808080ffff01ff088080ff0180ffff04ff2cff8080808080808080ffff01ff04ff13ffff02ff3effff04ff02ffff04ff05ffff04ff1bffff04ff17ffff04ff2fffff04ff5fff80808080808080808080ff018080ff0180ffff01ff04ffff04ff18ffff04ffff02ff16ffff04ff02ffff04ff05ffff04ff27ffff04ffff0bff2cff82014f80ffff04ffff02ff2effff04ff02ffff04ff818fff80808080ffff04ffff0bff2cff0580ff8080808080808080ff378080ff81af8080ff0180ff018080ffff04ffff01a0a04d9f57764f54a43e4030befb4d80026e870519aaa66334aef8304f5d0393c2ffff04ffff01ffff75ffc05968747470733a2f2f6261666b726569657175656b6879786b34643575366e77653462733378366f6c7369616b646269753467353276736a7665666f6b78686f6d6b6d712e697066732e6e667473746f726167652e6c696e6b2f80ffff68a090a1147c5d5c1f69e6d89c0cb77f3972401430a29c37755926a42b9573b98a64ffff826d75ffc05968747470733a2f2f6261666b7265696468336273697933626835686870766e6d367572357176757474373566783277697772646f62736d70686e6c3237776f726372792e697066732e6e667473746f726167652e6c696e6b2f80ffff826c7580ffff82736e01ffff82737401ffff826d68a067d8648c6c27e9cefab59ea47b0ad273ff4b7d591688dc1931e76af5fb3a228e80ffff04ffff01a0fe8a4b4e27a2e29a4d3fc7ce9d527adbcaccbab6ada3903ccf3ba9a769d2d78bffff04ffff01ff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b093c8e9237b64d8e9282a7f8e73369c671bdf4e8fa631704c58ae8aa7a8912322994e22df1b01dd8c896e13cf1683ba2dff018080ff018080808080",
    "puzzle_hash": "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba"
  },
  "results": 1,
  "success": true
}

Singleton States

The reason Beta was invented.

returns singleton states for given conditions

post

Singletons are like souls - when a coin dies (gets spent), they might move on to a new coin or disappear (melt). Beta views these transitions as changes of state. This endpoint takes multiple optional arguments and returns the states that match the criteria. Most body parameters are self-explanatory: if they match a field of the returned struct model (e.g., 'height' or 'launcher_id'), they act as filters. Only states with the specified values will be returned. The first special parameter is 'limit' - by default, this function returns 100 results at most. Use this parameter to tweak this value. 'order_by' can be 'coin_id', 'header_hash', 'height', 'parent_coin_id', 'puzzle_hash', 'amount', 'launcher_id', or 'inner_puzzle_hash'. The default ordering is ascending, but that can be changed by setting the 'order' parameter to 'desc'. If your query returns more than 100 results and you need all of them for some reasons, you can also use the 'offset' parameter. Note: Two singleton states CAN have the same coin id but a different 'melted' value - the primary key is a composite one: (coin_id, melted)

Authorizations

Body

amountinteger · int64OptionalExample: 1

coin_idstring · hexOptionalExample: 625799464319c8703ac2d0664af98cf45b9b306f7dcf717b1070d170bb5916a9

header_hashstring · hexOptionalExample: 796c33c3905150e649211fdd9ed42c7c418758c30c321271973a7c792a5bd403

heightinteger · int64OptionalExample: 2174316

inner_puzzle_hashstring · hexOptionalExample: 6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba

launcher_idstring · hexOptionalExample: f4dd6f4ec490974f7eb98223748f47340a9e9363b4c2dccc1932cdbbc54d03fd

limitintegerOptionalExample: 7

offsetintegerOptionalExample: 1

orderstringOptionalExample: desc

order_bystringOptionalExample: amount

parent_coin_idstring · hexOptionalExample: e9676e8ce096c5be27dee2fbf2120054d206e4df2de9ef59c24a651d3c558c95

puzzle_hashstring · hexOptionalExample: 0a5a9c760970ebcc094c6f9faa3d9730f066c7a8f7450841a94fc4fd59229bc2

Responses

post

HTTPcURLJavaScriptPython

POST /beta/get_singleton_states HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 576

{
  "amount": 1,
  "coin_id": "625799464319c8703ac2d0664af98cf45b9b306f7dcf717b1070d170bb5916a9",
  "header_hash": "796c33c3905150e649211fdd9ed42c7c418758c30c321271973a7c792a5bd403",
  "height": 2174316,
  "inner_puzzle_hash": "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba",
  "launcher_id": "f4dd6f4ec490974f7eb98223748f47340a9e9363b4c2dccc1932cdbbc54d03fd",
  "limit": 7,
  "offset": 1,
  "order": "desc",
  "order_by": "amount",
  "parent_coin_id": "e9676e8ce096c5be27dee2fbf2120054d206e4df2de9ef59c24a651d3c558c95",
  "puzzle_hash": "0a5a9c760970ebcc094c6f9faa3d9730f066c7a8f7450841a94fc4fd59229bc2"
}

{
  "results": 1,
  "singleton_states": [
    {
      "amount": 1,
      "coin_id": "625799464319c8703ac2d0664af98cf45b9b306f7dcf717b1070d170bb5916a9",
      "header_hash": "796c33c3905150e649211fdd9ed42c7c418758c30c321271973a7c792a5bd403",
      "height": 2174316,
      "inner_puzzle_hash": "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba",
      "launcher_id": "f4dd6f4ec490974f7eb98223748f47340a9e9363b4c2dccc1932cdbbc54d03fd",
      "melted": false,
      "parent_coin_id": "e9676e8ce096c5be27dee2fbf2120054d206e4df2de9ef59c24a651d3c558c95",
      "puzzle_hash": "0a5a9c760970ebcc094c6f9faa3d9730f066c7a8f7450841a94fc4fd59229bc2"
    }
  ],
  "success": true
}

Sync

Is Beta up-to-date or a trillion blocks behind?

Warning: Not suitable for heptapods.

returns the peak synced block

get

Beta constantly syncs to the blockchain by fetching the latest blocks. This function returns information about the latest processed block (the one with the biggest 'height' value).

Authorizations

Responses

get

HTTPcURLJavaScriptPython

GET /beta/get_peak_synced_block HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "results": 1,
  "success": true,
  "synced_block": {
    "header_hash": "9bb7135ae2b4a207807be2661007a89c8e3d0de1a58c0670da07b6099b9fedf7",
    "height": 2000000
  }
}

returns the peak synced block

post

Beta constantly syncs to the blockchain by fetching the latest blocks. This function returns information about the latest processed block (the one with the biggest 'height' value).

Authorizations

Responses

post

HTTPcURLJavaScriptPython

POST /beta/get_peak_synced_block HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "results": 1,
  "success": true,
  "synced_block": {
    "header_hash": "9bb7135ae2b4a207807be2661007a89c8e3d0de1a58c0670da07b6099b9fedf7",
    "height": 2000000
  }
}

returns block for given height

post

Beta constantly syncs to the blockchain by fetching the latest blocks. This function returns information about the block at the given height.

Authorizations

Body

heightintegerOptionalExample: 2000000

Responses

post

HTTPcURLJavaScriptPython

POST /beta/get_synced_block HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "height": 2000000
}

{
  "results": 1,
  "success": true,
  "synced_block": {
    "header_hash": "9bb7135ae2b4a207807be2661007a89c8e3d0de1a58c0670da07b6099b9fedf7",
    "height": 2000000
  }
}

returns blocks for given range

post

Beta constantly syncs to the blockchain by fetching the latest blocks. This function returns information about the blocks with height in [start, end).

Authorizations

Body

endintegerOptionalExample: 2000001

startintegerOptionalExample: 2000000

Responses

post

HTTPcURLJavaScriptPython

POST /beta/get_synced_blocks HTTP/1.1
Host: kraken.fireacademy.io
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "end": 2000001,
  "start": 2000000
}

{
  "results": 1,
  "success": true,
  "synced_blocks": [
    {
      "header_hash": "9bb7135ae2b4a207807be2661007a89c8e3d0de1a58c0670da07b6099b9fedf7",
      "height": 2000000
    }
  ]
}