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

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.

POST//kraken.fireacademy.io/beta/get_puzzle

Authorization

ApiKeyAuth

Body

application/json

The inner puzzle hash

puzzle_hashstring

Example: "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba"

Response

200401500

OK

Body

application/json

resultobject

resultsinteger

Example: 1

successboolean

Example: true

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_puzzle', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "puzzle_hash": "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba"
    }),
});
const data = await response.json();

Response

200401500

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

Singleton States

The reason Beta was invented.

returns singleton states for given conditions

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)

POST//kraken.fireacademy.io/beta/get_singleton_states

Authorization

ApiKeyAuth

Body

application/json

The arguments (see description for more details)

amountinteger (int64)

Example: 1

coin_idstring (hex)

Example: "625799464319c8703ac2d0664af98cf45b9b306f7dcf717b1070d170bb5916a9"

header_hashstring (hex)

Example: "796c33c3905150e649211fdd9ed42c7c418758c30c321271973a7c792a5bd403"

heightinteger (int64)

Example: 2174316

inner_puzzle_hashstring (hex)

Example: "6b665c0e059050f71a1c3e8a7d5b58e4e1d7abbd02d937e9b5ab5abfd7f8eaba"

launcher_idstring (hex)

Example: "f4dd6f4ec490974f7eb98223748f47340a9e9363b4c2dccc1932cdbbc54d03fd"

limitinteger

Example: 7

offsetinteger

Example: 1

orderstring

Example: "desc"

order_bystring

Example: "amount"

parent_coin_idstring (hex)

Example: "e9676e8ce096c5be27dee2fbf2120054d206e4df2de9ef59c24a651d3c558c95"

puzzle_hashstring (hex)

Example: "0a5a9c760970ebcc094c6f9faa3d9730f066c7a8f7450841a94fc4fd59229bc2"

Response

200401500

OK

Body

application/json

resultsinteger

Example: 1

singleton_statesarray of object

successboolean

Example: true

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_singleton_states', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "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"
    }),
});
const data = await response.json();

Response

200401500

{
  "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

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).

GET//kraken.fireacademy.io/beta/get_peak_synced_block

Authorization

ApiKeyAuth

Response

200401500

OK

Body

application/json

resultsinteger

Example: 1

successboolean

Example: true

synced_blockobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_peak_synced_block', {
    method: 'GET',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

200401500

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

returns the peak synced block

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).

POST//kraken.fireacademy.io/beta/get_peak_synced_block

Authorization

ApiKeyAuth

Response

200401500

OK

Body

application/json

resultsinteger

Example: 1

successboolean

Example: true

synced_blockobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_peak_synced_block', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

200401500

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

returns block for given height

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

POST//kraken.fireacademy.io/beta/get_synced_block

Authorization

ApiKeyAuth

Body

application/json

The height

heightinteger

Example: 2000000

Response

200401500

OK

Body

application/json

resultsinteger

Example: 1

successboolean

Example: true

synced_blockobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_synced_block', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "height": 2000000
    }),
});
const data = await response.json();

Response

200401500

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

returns blocks for given range

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

POST//kraken.fireacademy.io/beta/get_synced_blocks

Authorization

ApiKeyAuth

Body

application/json

The start and end heights

endinteger

Example: 2000001

startinteger

Example: 2000000

Response

200401500

OK

Body

application/json

resultsinteger

Example: 1

successboolean

Example: true

synced_blocksarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//kraken.fireacademy.io/beta/get_synced_blocks', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "end": 2000001,
      "start": 2000000
    }),
});
const data = await response.json();

Response

200401500

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