| Name | koios-api JSON |
| Version |
1.1.0.1
JSON |
| download |
| home_page | |
| Summary | A python package for the Cardano Blockchain Koios API (https://api.koios.rest/) |
| upload_time | 2024-01-16 14:44:25 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.7 |
| license | |
| keywords |
koios
cardano
blockchain
rest
api
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# koios-api-python
A python package for the Cardano Blockchain [Koios API](https://api.koios.rest/).
## Install
To install the module, type the following command:
```bash
pip3 install koios_api
```
## Environment
By default, koios_api works with mainnet, but it can also work with the preview
and preprod testnets, and even with custom Api URLs (because anyone can install
an own Koios Api). To use a testnet you can set the environment variable:
```bash
#preprod
export CARDANO_NET=preprod
```
```bash
#preview
export CARDANO_NET=preview
```
To work with a custom Api URL, set the environment variable:
```bash
export API_BASE_URL=https://custom.url/api/v1
```
By default, the requests are unauthenticated (public tier),
and there is a low limit of requests you can make. In order to increase the
number of requests, you can authenticate using an API Token that you can obtain
from the [pricing](https://koios.rest/pricing/Pricing.html) page after
connecting your wallet and signing a message to prove the ownership on the
wallet. There is also a free tier with 10x more requests than the public tier.
You need to set the API Token in the KOIOS_API_TOKEN environment variable
in order to use it, otherwise the public tier is used.
```bash
export KOIOS_API_TOKEN="your Koios API Token here"
```
Other environment variables that can be set, and their default versions, are:
```bash
SLEEP_TIME=1
API_RESP_COUNT=1000
REQUEST_TIMEOUT=60
```
SLEEP_TIME is the time between retries after an API errors. API_RESP_COUNT
is the maximum number of records the API should return (1000 is the absolute
maximum supported by the Koios API). REQUEST_TIMEOUT is the timeout for get
and post requests to the Koios API.
## Using the module
Importing the complete module:
```python
import koios_api
koios_api.get_tip()
```
The result will be like this:
```json
[
{
"hash": "442765ab5660346a6af3ba7667bbd35934e6219a52f0f53a80f28d27a70309c1",
"epoch_no": 381,
"abs_slot": 79265882,
"epoch_slot": 37082,
"block_no": 8129347,
"block_time": 1670832173
}
]
```
Import only specific functions:
```python
from koios_api.network import get_tip
get_tip()
```
The result will be identical.
## Modules
[Network](#Network)\
[get_tip](#get_tip) Get the tip info about the latest block seen by chain\
[get_genesis](#get_genesis) Get the Genesis parameters used to start specific\
era on chain\
[get_totals](#get_totals) Get the circulating utxo, treasury, rewards, supply
and reserves in lovelace for specified epoch, all epochs if empty\
[get_param_updates](#get_param_updates) Get all parameter update proposals
submitted to the chain starting Shelley era\
[get_reserve_withdrawals](#get_reserve_withdrawals) List of all withdrawals
from reserves against stake accounts\
[get_treasury_withdrawals](#get_treasury_withdrawals) List of all withdrawals
from treasury against stake accounts
[Epoch](#Epoch)\
[get_epoch_info](#get_epoch_info) Get the epoch information, all epochs
if no epoch specified\
[get_epoch_params](#get_epoch_params) Get the protocol parameters for
specific epoch, returns information about all epochs if no epoch specified\
[get_epoch_block_protocols](#get_epoch_block_protocols) Get the information
about block protocol distribution in epoch
[Block](#Block)\
[get_blocks](#get_blocks) Get summarised details about all blocks (paginated,
the latest first)\
[get_block_info](#get_block_info) Get detailed information about a specific
block\
[get_block_txs](#get_block_txs) Get a list of all transactions included in
provided blocks
[Transactions](#Transactions)\
[get_utxo_info](#get_utxo_info) Get UTxO set for requested UTxO references\
[get_tx_info](#get_tx_info) Get detailed information about transaction(s)\
[get_tx_metadata](#get_tx_metadata) Get metadata information (if any)
for given transaction(s)\
[get_tx_metalabels](#get_tx_metalabels) Get a list of all transaction
metadata labels\
[submit_tx](#submit_tx) Submit an already serialized transaction
to the network\
[get_tx_status](#get_tx_status) Get the number of block confirmations
for a given transaction hash list\
[Stake Account](#Stake_Account)\
[get_account_list](#get_account_list) Get a list of all accounts\
[get_account_info](#get_account_info) Get the account information for
given stake addresses (accounts)\
[get_account_info_cached](#get_account_info_cached) Get the cached account
information for given stake addresses (accounts)\
[get_account_utxos](#get_account_utxos) Get a list of all Txs for a
given stake address (account)\
[get_account_txs](#get_account_txs) Get a list of all UTxOs for a
given stake address (account)\
[get_account_rewards](#get_account_rewards) Get the full rewards history
(including MIR) for given stake addresses (accounts)\
[get_account_updates](#get_account_updates) Get the account updates
(registration, deregistration, delegation and withdrawals) for
given stake addresses (accounts)\
[get_account_addresses](#get_account_addresses) Get all addresses associated
with given staking accounts\
[get_account_assets](#get_account_assets) Get the native asset balance of
given accounts\
[get_account_history](#get_account_history) Get the staking history of
given stake addresses (accounts)
[Address](#Address)\
[get_address_info](#get_address_info) Get the transaction hash list of input
address array, optionally filtering after specified block height (inclusive)\
[get_address_utxos](#get_address_utxos) Get UTxO set for given addresses\
[get_credential_utxos](#get_credential_utxos) Get a list of UTxO against input
payment credential array including their balances\
[get_address_txs](#get_address_txs) Get the transaction hash list of input
address array, optionally filtering after specified block height (inclusive)\
[get_credential_txs](#get_credential_txs) Get the transaction hash list
of input payment credential array, optionally filtering after specified block
height (inclusive)\
[get_address_assets](#get_address_assets) Get the list of all the assets
(policy, name and quantity) for given addresses
[Asset](#Asset)\
[get_asset_list](#get_asset_list) Get the list of all native assets
(paginated)\
[get_policy_asset_list](#get_policy_asset_list) Get the list of asset under
the given policy (including balances)\
[get_asset_token_registry](#get_asset_token_registry) Get a list of assets
registered via token registry on github\
[get_asset_info](#get_asset_info) Get the information of a list of assets
including first minting & token registry metadata\
[get_asset_utxos](#get_asset_utxos) Get the UTXO information of a list of
assets\
[get_asset_history](#get_asset_history) Get the mint/burn history
of an asset\
[get_asset_addresses](#get_asset_addresses) Get the list of all addresses
holding a given asset\
[get_asset_nft_address](#get_asset_nft_address) Get the address where specified
NFT currently reside on.\
[get_policy_asset_addresses](#get_policy_asset_addresses) Get the list of
addresses with quantity for each asset on the given policy\
[get_policy_asset_info](#get_policy_asset_info) Get the information for
all assets under the same policy\
[get_asset_summary](#get_asset_summary) Get the summary of an asset
(total transactions exclude minting/total wallets include only wallets
with asset balance)\
[get_asset_txs](#get_asset_txs) Get the list of all asset transaction
hashes (the newest first)\
[Pool](#Pool)\
[get_pool_list](#get_pool_list) A list of all currently registered/retiring
(not retired) pools\
[get_pool_info](#get_pool_info) Current pool statuses and details for
a specified list of pool ids\
[get_pool_stake_snapshot](#get_pool_stake_snapshot) Returns Mark, Set and Go
stake snapshots for the selected pool, useful for leaderlog calculation\
[get_pool_delegators](#get_pool_delegators) Returns information about live
delegators for a given pool\
[get_pool_delegators_history](#get_pool_delegators_history) Returns information
about active delegators (incl. history) for a given pool and epoch number
(all epochs if not specified)\
[get_pool_blocks](#get_pool_blocks) Returns information about blocks minted
by a given pool for all epochs (or _epoch_no if provided)\
[get_pool_history](#get_pool_history) Returns information about pool stake,
block and reward history in a given epoch (or all epochs that pool existed for,
in descending order if no epoch number was provided)\
[get_pool_updates](#get_pool_updates) Returns all pool updates for all pools
or only updates for specific pool if specified\
[get_pool_registrations](#get_pool_registrations) Return all pool registrations
initiated in the requested epoch\
[get_pool_retirements](#get_pool_retirements) Return all pool retirements
initiated in the requested epoch\
[get_pool_relays](#get_pool_relays) A list of registered relays for all
currently registered/retiring (not retired) pools\
[get_pool_metadata](#get_pool_metadata) A list of registered relays for all
currently registered/retiring (not retired) pools\
[get_retiring_pools](#get_retiring_pools) Get the retiring stake pools list
[Script](#Script)\
[get_script_info](#get_script_info) List of script information for given
script hashes\
[get_native_script_list](#get_native_script_list) The list of all existing
native script hashes along with their creation transaction hashes\
[get_plutus_script_list](#get_plutus_script_list) The list of all existing
native script hashes along with their creation transaction hashes\
[get_script_redeemers](#get_script_redeemers) The list of all redeemers
for a given script hash\
[get_script_utxos](#get_script_utxos) List of all UTXOs for a given script hash\
[get_datum_info](#get_datum_info) The list of datum information for
given datum hashes
### Stake_Account
#### get_account_list
Get a list of all accounts\
Parameters:\
The offset (optional) to start from, default 0\
The maximum number of accounts to return (optional), default 0 (no limit)\
Returns: The list of accounts dictionaries\
This takes a very long time to execute (about one hour), because the total
number of accounts is in the millions range.\
Example:\
`account_list = get_account_list()`\
Example response:
```json
[
{
"id": "stake1uyfmzu5qqy70a8kq4c8rw09q0w0ktfcxppwujejnsh6tyrg5c774g"
},
{
"id": "stake1uydhlh7f2kkw9eazct5zyzlrvj32gjnkmt2v5qf6t8rut4qwch8ey"
},
{
"id": "stake1uxsgkz6fvgws5wn80vckwvghzapnhfmf0672nmmkm2tt9fcaau5sw"
},
...
]
```
#### get_account_info
Get the account information for given stake addresses (accounts)\
Parameters: Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Returns: The list of account information dictionaries\
Example:\
`account_info = get_account_info('stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j')`\
Example response:
```json
[
{
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"status": "registered",
"delegated_pool": "pool18r2y72aue5nmv489xtnfxl36vzusq95qst6urd87yd5hgzms04c",
"total_balance": "20418617",
"utxo": "20418617",
"rewards": "0",
"withdrawals": "0",
"rewards_available": "0",
"reserves": "0",
"treasury": "0"
}
]
```
#### get_account_info_cached
Get the cached account information for given stake addresses (accounts)\
Parameters: Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Returns: The list of account information dictionaries\
Example:\
`account_info_cached = get_account_info_cached('stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j')`\
Example response:
```json
[
{
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"status": "registered",
"delegated_pool": "pool18r2y72aue5nmv489xtnfxl36vzusq95qst6urd87yd5hgzms04c",
"total_balance": "20418617",
"utxo": "20418617",
"rewards": "0",
"withdrawals": "0",
"rewards_available": "0",
"reserves": "0",
"treasury": "0"
}
]
```
#### get_account_utxos
Get a list of all UTxOs for given stake addresses (account)s\
Parameters: Stake address\
Returns: The list of all UTxOs at all payment addresses associated with
the stake address\
Example:\
`account_utxos = get_account_utxos('stake1ux5r7myfhycj234wpqyhh3h8skgwvq0hsstpw52f66857uq95cas6')`
Example response:
```json
[
{
"tx_hash": "215bcaa7b13c491db28d5525d9b2a13a7d8ddabd563da8113a449ab33a6a60be",
"tx_index": 2,
"address": "addr1q9dwzug2qzdsqvpvrn886nqdtwr02n9kxtwqsxce2gacvedg8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqeuerev",
"value": "85813474",
"block_height": 8214437,
"block_time": 1672580966
},
{
"tx_hash": "1eb26dce2f471fbe32aa8cb303f5e8d8078d1da4dbbb78a7bc135036bb3f2f9c",
"tx_index": 0,
"address": "addr1q88u9gz83nhs9p5pud9kyucx8sg0ygae2p9a4g2p2y55c4ag8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqqyd2n7",
"value": "110094569",
"block_height": 8406870,
"block_time": 1676555396
},
{
"tx_hash": "d530de851c2f867f2174c1073b04bdb9f2e2d16029fcfb488e8150ba66976d43",
"tx_index": 0,
"address": "addr1qxyp2wsafavj47dpc6uqgqx8se3969jn4crfk7y4zwd7vfag8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqlyvudm",
"value": "1249900",
"block_height": 8489290,
"block_time": 1678248733
},
...
{
"tx_hash": "d8e3ca8b36f9a785ff33f01aa5460f9248ea94acd621ea187093206b04aa6e30",
"tx_index": 0,
"address": "addr1q8txa88kt6rpdv3zzn8ghx7u4udf6rpj690rfdvlqn35fldg8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqplx97u",
"value": "54000000",
"block_height": 8759577,
"block_time": 1683809438
}
]
```
#### get_account_txs
Get a list of all Txs for a given stake address (account)\
Parameters: Stake address\
Returns: The list of all transaction hashes for all payment addresses associated with
the stake address\
Example:\
`account_txs = get_account_txs('stake1uyrx65wjqjgeeksd8hptmcgl5jfyrqkfq0xe8xlp367kphsckq250')`
Example response:
```json
[
{
"tx_hash": "5e209eee15637645198ddf22f84f905d50b6103661da98597eb6da0ef7245fa1",
"epoch_no": 251,
"block_height": 5427308,
"block_time": 1615051845
},
{
"tx_hash": "a6981b394e5cf9b801d2c81b81b5aecaf556abd8eca5a00067e2d53c2f6eebab",
"epoch_no": 251,
"block_height": 5427334,
"block_time": 1615052248
},
{
"tx_hash": "e9504ad3c28120abb0fab3504f09a4f9f203c62159a53d74eb8e206fda2cd4b5",
"epoch_no": 252,
"block_height": 5431176,
"block_time": 1615130928
},
{
"tx_hash": "7605d6442d46bb2de29f251f893b8ddccd424ad107240e787dda0bfcb552713c",
"epoch_no": 252,
"block_height": 5433510,
"block_time": 1615179291
},
{
"tx_hash": "645ed2e34370b0d8c1385c07d3a85b337ef6982e2686528c4b90ecaef6b3c35b",
"epoch_no": 252,
"block_height": 5436849,
"block_time": 1615247429
},
...
]
```
#### get_account_rewards
Get the full rewards history (including MIR) for given stake addresses
(accounts)\
Parameters:\
Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Epoch (optional), default: current epoch\
Returns: The list of rewards dictionaries by account (stake address)\
Example:\
`account_rewards = get_account_rewards('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\
Example response:
```json
[
{
"stake_address": "stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z",
"rewards": [
{
"earned_epoch": 233,
"spendable_epoch": 235,
"amount": "3990414",
"type": "member",
"pool_id": "pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy"
},
{
"earned_epoch": 234,
"spendable_epoch": 236,
"amount": "2792902",
"type": "member",
"pool_id": "pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy"
},
...
{
"earned_epoch": 379,
"spendable_epoch": 381,
"amount": "6496870",
"type": "member",
"pool_id": "pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd"
}
]
}
]
```
#### get_account_updates
Get the account updates (registration, deregistration, delegation and
withdrawals) for given stake addresses (accounts)\
Parameters: Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Returns: The list of account updates dictionaries by account (stake address)\
Example:\
`account_updates = get_account_updates('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\
Example response:
```json
[
{
"stake_address": "stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z",
"updates": [
{
"action_type": "withdrawal",
"tx_hash": "487bc75f00fe934dad33683271cca8540fe868eef7025962678f179a1a111ecc",
"epoch_no": 324,
"epoch_slot": 70687,
"absolute_slot": 54675487,
"block_time": 1646241778
},
{
"action_type": "withdrawal",
"tx_hash": "eb3ffa01f434e210716151fd9001af82529e371a91c20af02512942f988a2119",
"epoch_no": 269,
"epoch_slot": 339679,
"absolute_slot": 31184479,
"block_time": 1622750770
},
...
{
"action_type": "withdrawal",
"tx_hash": "b056dcbff9b908e1bd3ed015466f64486538058ba3553dbf885b216d88343370",
"epoch_no": 252,
"epoch_slot": 58375,
"absolute_slot": 23559175,
"block_time": 1615125466
}
]
}
]
```
#### get_account_addresses
Get all addresses associated with given staking accounts\
Parameters: \
Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
First Only boolean (optional): Only return the first result (default False)\
Empty boolean (optional): Include zero quantity entries (default True)\
Returns: The list of addresses dictionaries by account (stake address)\
Example:\
`account_addresses = get_account_addresses('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\
Example response:
```json
[
{
"stake_address": "stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z",
"addresses": [
"addr1qxwjxvzv8rmyutcjp0647w4n05wv7aez9jdmqcxn8a9sshll0qre4udr9ny9sj8020uxher08k44ssl9pxlk3w5f4x2qjyz9yf"
]
}
]
```
#### get_account_assets
Get the native asset balance of given accounts\
Parameters: Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Returns: The list of account assets dictionaries by account (stake address)\
Example:\
`account_assets = get_account_assets('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\
Example response:
```json
[
{
"stake_address": "stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z",
"asset_list": [
{
"policy_id": "0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913",
"asset_name": "6c70202302",
"fingerprint": "asset1awuysx8hc686uz0dykmvmc7jfut2ulceucf6yc",
"quantity": "418089787"
},
{
"policy_id": "0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913",
"asset_name": "6c7020f302",
"fingerprint": "asset1mcq0awl6awlaqg0ywukf94q0mnau263l9rght5",
"quantity": "586811406"
},
...
{
"policy_id": "ea2d23f1fa631b414252824c153f2d6ba833506477a929770a4dd9c2",
"asset_name": "4d414442554c",
"fingerprint": "asset1q0kwjy669gmsqpvxp4lr0sp26pdm0dafme3qp2",
"quantity": "500"
}
]
}
]
```
#### get_account_history
Get the staking history of given stake addresses (accounts)\
Parameters: Stake address(es), as a string (for one address) or a list
(for multiple addresses)\
Returns: The list of staking history dictionaries by account (stake address)\
Example:\
`account_history = get_account_history('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\
Example response:
```json
[
{
"stake_address": "stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z",
"history": [
{
"pool_id": "pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy",
"epoch_no": 233,
"active_stake": "4655706122"
},
{
"pool_id": "pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy",
"epoch_no": 234,
"active_stake": "5020706122"
},
...
{
"pool_id": "pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd",
"epoch_no": 381,
"active_stake": "10247851319"
}
]
}
]
```
### Network
#### get_tip
Get the tip info about the latest block seen by chain\
Parameters: none\
Returns: The tip information as a list of one dictionary\
Example:\
`tip = get_tip()`\
Example response:
```json
[
{
"hash": "442765ab5660346a6af3ba7667bbd35934e6219a52f0f53a80f28d27a70309c1",
"epoch_no": 381,
"abs_slot": 79265882,
"epoch_slot": 37082,
"block_no": 8129347,
"block_time": 1670832173
}
]
```
#### get_genesis
Get the Genesis parameters used to start specific era on chain\
Parameters: none\
Returns: Genesis parameters used to start each era on chain as a list of
one dictionary\
Example:\
`genesis = get_genesis()`\
Example response:
```json
[
{
"networkmagic": "764824073",
"networkid": "Mainnet",
"activeslotcoeff": "0.05",
"updatequorum": "5",
"maxlovelacesupply": "45000000000000000",
"epochlength": "432000",
"systemstart": 1506203091,
"slotsperkesperiod": "129600",
"slotlength": "1",
"maxkesrevolutions": "62",
"securityparam": "2160",
"alonzogenesis": "{\"lovelacePerUTxOWord\":34482,\"executionPrices\":{\"prSteps\":{\"numerator\":721,\"denominator\":10000000},\"prMem\":{\"numerator\":577,\"denominator\":10000}},\"maxTxExUnits\":{\"exUnitsMem\":10000000,\"exUnitsSteps\":10000000000},\"maxBlockExUnits\":{\"exUnitsMem\":50000000,\"exUnitsSteps\":40000000000},\"maxValueSize\":5000,\"collateralPercentage\":150,\"maxCollateralInputs\":3,\"costModels\":{\"PlutusV1\":{\"sha2_256-memory-arguments\":4,\"equalsString-cpu-arguments-constant\":1000,\"cekDelayCost-exBudgetMemory\":100,\"lessThanEqualsByteString-cpu-arguments-intercept\":103599,\"divideInteger-memory-arguments-minimum\":1,\"appendByteString-cpu-arguments-slope\":621,\"blake2b-cpu-arguments-slope\":29175,\"iData-cpu-arguments\":150000,\"encodeUtf8-cpu-arguments-slope\":1000,\"unBData-cpu-arguments\":150000,\"multiplyInteger-cpu-arguments-intercept\":61516,\"cekConstCost-exBudgetMemory\":100,\"nullList-cpu-arguments\":150000,\"equalsString-cpu-arguments-intercept\":150000,\"trace-cpu-arguments\":150000,\"mkNilData-memory-arguments\":32,\"lengthOfByteString-cpu-arguments\":150000,\"cekBuiltinCost-exBudgetCPU\":29773,\"bData-cpu-arguments\":150000,\"subtractInteger-cpu-arguments-slope\":0,\"unIData-cpu-arguments\":150000,\"consByteString-memory-arguments-intercept\":0,\"divideInteger-memory-arguments-slope\":1,\"divideInteger-cpu-arguments-model-arguments-slope\":118,\"listData-cpu-arguments\":150000,\"headList-cpu-arguments\":150000,\"chooseData-memory-arguments\":32,\"equalsInteger-cpu-arguments-intercept\":136542,\"sha3_256-cpu-arguments-slope\":82363,\"sliceByteString-cpu-arguments-slope\":5000,\"unMapData-cpu-arguments\":150000,\"lessThanInteger-cpu-arguments-intercept\":179690,\"mkCons-cpu-arguments\":150000,\"appendString-memory-arguments-intercept\":0,\"modInteger-cpu-arguments-model-arguments-slope\":118,\"ifThenElse-cpu-arguments\":1,\"mkNilPairData-cpu-arguments\":150000,\"lessThanEqualsInteger-cpu-arguments-intercept\":145276,\"addInteger-memory-arguments-slope\":1,\"chooseList-memory-arguments\":32,\"constrData-memory-arguments\":32,\"decodeUtf8-cpu-arguments-intercept\":150000,\"equalsData-memory-arguments\":1,\"subtractInteger-memory-arguments-slope\":1,\"appendByteString-memory-arguments-intercept\":0,\"lengthOfByteString-memory-arguments\":4,\"headList-memory-arguments\":32,\"listData-memory-arguments\":32,\"consByteString-cpu-arguments-intercept\":150000,\"unIData-memory-arguments\":32,\"remainderInteger-memory-arguments-minimum\":1,\"bData-memory-arguments\":32,\"lessThanByteString-cpu-arguments-slope\":248,\"encodeUtf8-memory-arguments-intercept\":0,\"cekStartupCost-exBudgetCPU\":100,\"multiplyInteger-memory-arguments-intercept\":0,\"unListData-memory-arguments\":32,\"remainderInteger-cpu-arguments-model-arguments-slope\":118,\"cekVarCost-exBudgetCPU\":29773,\"remainderInteger-memory-arguments-slope\":1,\"cekForceCost-exBudgetCPU\":29773,\"sha2_256-cpu-arguments-slope\":29175,\"equalsInteger-memory-arguments\":1,\"indexByteString-memory-arguments\":1,\"addInteger-memory-arguments-intercept\":1,\"chooseUnit-cpu-arguments\":150000,\"sndPair-cpu-arguments\":150000,\"cekLamCost-exBudgetCPU\":29773,\"fstPair-cpu-arguments\":150000,\"quotientInteger-memory-arguments-minimum\":1,\"decodeUtf8-cpu-arguments-slope\":1000,\"lessThanInteger-memory-arguments\":1,\"lessThanEqualsInteger-cpu-arguments-slope\":1366,\"fstPair-memory-arguments\":32,\"modInteger-memory-arguments-intercept\":0,\"unConstrData-cpu-arguments\":150000,\"lessThanEqualsInteger-memory-arguments\":1,\"chooseUnit-memory-arguments\":32,\"sndPair-memory-arguments\":32,\"addInteger-cpu-arguments-intercept\":197209,\"decodeUtf8-memory-arguments-slope\":8,\"equalsData-cpu-arguments-intercept\":150000,\"mapData-cpu-arguments\":150000,\"mkPairData-cpu-arguments\":150000,\"quotientInteger-cpu-arguments-constant\":148000,\"consByteString-memory-arguments-slope\":1,\"cekVarCost-exBudgetMemory\":100,\"indexByteString-cpu-arguments\":150000,\"unListData-cpu-arguments\":150000,\"equalsInteger-cpu-arguments-slope\":1326,\"cekStartupCost-exBudgetMemory\":100,\"subtractInteger-cpu-arguments-intercept\":197209,\"divideInteger-cpu-arguments-model-arguments-intercept\":425507,\"divideInteger-memory-arguments-intercept\":0,\"cekForceCost-exBudgetMemory\":100,\"blake2b-cpu-arguments-intercept\":2477736,\"remainderInteger-cpu-arguments-constant\":148000,\"tailList-cpu-arguments\":150000,\"encodeUtf8-cpu-arguments-intercept\":150000,\"equalsString-cpu-arguments-slope\":1000,\"lessThanByteString-memory-arguments\":1,\"multiplyInteger-cpu-arguments-slope\":11218,\"appendByteString-cpu-arguments-intercept\":396231,\"lessThanEqualsByteString-cpu-arguments-slope\":248,\"modInteger-memory-arguments-slope\":1,\"addInteger-cpu-arguments-slope\":0,\"equalsData-cpu-arguments-slope\":10000,\"decodeUtf8-memory-arguments-intercept\":0,\"chooseList-cpu-arguments\":150000,\"constrData-cpu-arguments\":150000,\"equalsByteString-memory-arguments\":1,\"cekApplyCost-exBudgetCPU\":29773,\"quotientInteger-memory-arguments-slope\":1,\"verifySignature-cpu-arguments-intercept\":3345831,\"unMapData-memory-arguments\":32,\"mkCons-memory-arguments\":32,\"sliceByteString-memory-arguments-slope\":1,\"sha3_256-memory-arguments\":4,\"ifThenElse-memory-arguments\":1,\"mkNilPairData-memory-arguments\":32,\"equalsByteString-cpu-arguments-slope\":247,\"appendString-cpu-arguments-intercept\":150000,\"quotientInteger-cpu-arguments-model-arguments-slope\":118,\"cekApplyCost-exBudgetMemory\":100,\"equalsString-memory-arguments\":1,\"multiplyInteger-memory-arguments-slope\":1,\"cekBuiltinCost-exBudgetMemory\":100,\"remainderInteger-memory-arguments-intercept\":0,\"sha2_256-cpu-arguments-intercept\":2477736,\"remainderInteger-cpu-arguments-model-arguments-intercept\":425507,\"lessThanEqualsByteString-memory-arguments\":1,\"tailList-memory-arguments\":32,\"mkNilData-cpu-arguments\":150000,\"chooseData-cpu-arguments\":150000,\"unBData-memory-arguments\":32,\"blake2b-memory-arguments\":4,\"iData-memory-arguments\":32,\"nullList-memory-arguments\":32,\"cekDelayCost-exBudgetCPU\":29773,\"subtractInteger-memory-arguments-intercept\":1,\"lessThanByteString-cpu-arguments-intercept\":103599,\"consByteString-cpu-arguments-slope\":1000,\"appendByteString-memory-arguments-slope\":1,\"trace-memory-arguments\":32,\"divideInteger-cpu-arguments-constant\":148000,\"cekConstCost-exBudgetCPU\":29773,\"encodeUtf8-memory-arguments-slope\":8,\"quotientInteger-cpu-arguments-model-arguments-intercept\":425507,\"mapData-memory-arguments\":32,\"appendString-cpu-arguments-slope\":1000,\"modInteger-cpu-arguments-constant\":148000,\"verifySignature-cpu-arguments-slope\":1,\"unConstrData-memory-arguments\":32,\"quotientInteger-memory-arguments-intercept\":0,\"equalsByteString-cpu-arguments-constant\":150000,\"sliceByteString-memory-arguments-intercept\":0,\"mkPairData-memory-arguments\":32,\"equalsByteString-cpu-arguments-intercept\":112536,\"appendString-memory-arguments-slope\":1,\"lessThanInteger-cpu-arguments-slope\":497,\"modInteger-cpu-arguments-model-arguments-intercept\":425507,\"modInteger-memory-arguments-minimum\":1,\"sha3_256-cpu-arguments-intercept\":0,\"verifySignature-memory-arguments\":1,\"cekLamCost-exBudgetMemory\":100,\"sliceByteString-cpu-arguments-intercept\":150000}}}"
}
]
```
#### get_totals
Get the circulating utxo, treasury, rewards, supply and reserves in lovelace
for specified epoch, all epochs if empty\
Parameters: Epoch (optional)\
Returns: Supply/reserves/utxo/fees/treasury stats as a list of one dictionary
(if the epoch is specified) or a list of all available epochs
(if the epoch parameter is not specified)\
Example:\
`totals = get_totals(380)`\
Example response:
```json
[
{
"epoch_no": 380,
"circulation": "33505907705011256",
"treasury": "1085266054287657",
"reward": "635180192555825",
"supply": "35230640457275590",
"reserves": "9769359542724410"
}
]
```
#### get_param_updates
Get all parameter update proposals submitted to the chain starting
Shelley era\
Parameters: none\
Returns: All parameter update proposals\
Example:\
`param_updates = get_param_updates()`
```json
[
{
"tx_hash": "b516588da34b58b7d32b6a057f513e16ea8c87de46615631be3316d8a8847d46",
"block_height": 4533644,
"block_time": 1596923351,
"epoch_no": 210,
"data": {
"decentralisation": 0.9
}
},
{
"tx_hash": "784902982af484f78d10f1587072f5a6b888ed0c1296d4ecf1e21c0251696ca1",
"block_height": 4558648,
"block_time": 1597425824,
"epoch_no": 211,
"data": {
"decentralisation": 0.8
}
},
...
]
```
#### get_reserve_withdrawals
List of all withdrawals from reserves against stake accounts\
Parameters: none\
Returns: The list of withdrawals from reserves against stake accounts\
Example:\
`reserve_withdrawals = get_reserve_withdrawals()`
```json
[
{
"epoch_no": 298,
"epoch_slot": 60492,
"tx_hash": "03b02cff29a5f2dfc827e00345eaab8b29a3d740e9878aa6e5dd2b52da0763c5",
"block_hash": "7650ae0c9508fd236f370f1ac329b2d4ae0f8bcf583f2878dbb568c311d08c7c",
"block_height": 6407962,
"amount": "66000000000000",
"stake_address": "stake1uykws5pmwjxktdhlkz0pac3cu2guw6fjys2zaanmdew6xrs5lgv4n"
}
]
```
#### get_treasury_withdrawals
List of all withdrawals from treasury against stake accounts\
Parameters: none\
Returns: The list of withdrawals from treasury against stake accounts\
Example:\
`treasury_withdrawals = get_treasury_withdrawals()`
```json
[
{
"epoch_no": 441,
"epoch_slot": 152858,
"tx_hash": "d689bee077e69269ea7e9e8f5b09f5f93af887c117cd7a1157d09bec209900dd",
"block_hash": "18add9785eeaacbe0534cf362cd49e78170f23a3a91b862ef5ba2ad444bc2766",
"block_height": 9394726,
"amount": "50000000000000",
"stake_address": "stake1uxv9hwk8523p3asgnnjv0t49qvmlj96j22dw434j2gyks2qn9x52u"
}
]
```
### Epoch
#### get_epoch_info
Get the epoch information, all epochs if no epoch specified\
Parameters: Epoch (optional)\
Returns: The list of epoch info dictionaries\
Example:\
`epoch_info = get_epoch_info(448)`\
Example response:
```json
[
{
"epoch_no": 448,
"out_sum": "118059162440190062",
"fees": "102026957711",
"tx_count": 293835,
"blk_count": 21134,
"start_time": 1699739091,
"end_time": 1700171091,
"first_block_time": 1699739174,
"last_block_time": 1700171052,
"active_stake": "22973647281453944",
"total_rewards": "10027944051413",
"avg_blk_reward": "474493425"
}
]
```
#### get_epoch_params
Get the protocol parameters for specific epoch, returns information
about all epochs if no epoch specified\
Parameters: Epoch (optional)\
Returns: The list of epoch protocol parameters dictionaries\
Example:\
`epoch_params = get_epoch_params(448)`\
Example response:
```json
[
{
"epoch_no": 448,
"min_fee_a": 44,
"min_fee_b": 155381,
"max_block_size": 90112,
"max_tx_size": 16384,
"max_bh_size": 1100,
"key_deposit": "2000000",
"pool_deposit": "500000000",
"max_epoch": 18,
"optimal_pool_count": 500,
"influence": 0.3,
"monetary_expand_rate": 0.003,
"treasury_growth_rate": 0.2,
"decentralisation": 0,
"extra_entropy": null,
"protocol_major": 8,
"protocol_minor": 0,
"min_utxo_value": "0",
"min_pool_cost": "170000000",
"nonce": "d58c8fdf57a9d20b4e72fce94056ad2ed2b62e40a7b0b35e1f37f267f9546c07",
"block_hash": "a74c031d215542d19fdafee6a28fde865c5961d296759e0ae9d19d50aa6f8a12",
"cost_models": {
"PlutusV1": [
205665,
812,
1,
1,
1000,
571,
0,
1,
1000,
24177,
4,
1,
1000,
32,
117366,
10475,
4,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
100,
100,
23000,
100,
19537,
32,
175354,
32,
46417,
4,
221973,
511,
0,
1,
89141,
32,
497525,
14068,
4,
2,
196500,
453240,
220,
0,
1,
1,
1000,
28662,
4,
2,
245000,
216773,
62,
1,
1060367,
12586,
1,
208512,
421,
1,
187000,
1000,
52998,
1,
80436,
32,
43249,
32,
1000,
32,
80556,
1,
57667,
4,
1000,
10,
197145,
156,
1,
197145,
156,
1,
204924,
473,
1,
208896,
511,
1,
52467,
32,
64832,
32,
65493,
32,
22558,
32,
16563,
32,
76511,
32,
196500,
453240,
220,
0,
1,
1,
69522,
11687,
0,
1,
60091,
32,
196500,
453240,
220,
0,
1,
1,
196500,
453240,
220,
0,
1,
1,
806990,
30482,
4,
1927926,
82523,
4,
265318,
0,
4,
0,
85931,
32,
205665,
812,
1,
1,
41182,
32,
212342,
32,
31220,
32,
32696,
32,
43357,
32,
32247,
32,
38314,
32,
57996947,
18975,
10
],
"PlutusV2": [
205665,
812,
1,
1,
1000,
571,
0,
1,
1000,
24177,
4,
1,
1000,
32,
117366,
10475,
4,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
23000,
100,
100,
100,
23000,
100,
19537,
32,
175354,
32,
46417,
4,
221973,
511,
0,
1,
89141,
32,
497525,
14068,
4,
2,
196500,
453240,
220,
0,
1,
1,
1000,
28662,
4,
2,
245000,
216773,
62,
1,
1060367,
12586,
1,
208512,
421,
1,
187000,
1000,
52998,
1,
80436,
32,
43249,
32,
1000,
32,
80556,
1,
57667,
4,
1000,
10,
197145,
156,
1,
197145,
156,
1,
204924,
473,
1,
208896,
511,
1,
52467,
32,
64832,
32,
65493,
32,
22558,
32,
16563,
32,
76511,
32,
196500,
453240,
220,
0,
1,
1,
69522,
11687,
0,
1,
60091,
32,
196500,
453240,
220,
0,
1,
1,
196500,
453240,
220,
0,
1,
1,
1159724,
392670,
0,
2,
806990,
30482,
4,
1927926,
82523,
4,
265318,
0,
4,
0,
85931,
32,
205665,
812,
1,
1,
41182,
32,
212342,
32,
31220,
32,
32696,
32,
43357,
32,
32247,
32,
38314,
32,
35892428,
10,
57996947,
18975,
10,
38887044,
32947,
10
]
},
"price_mem": 0.0577,
"price_step": 7.21e-05,
"max_tx_ex_mem": 14000000,
"max_tx_ex_steps": 10000000000,
"max_block_ex_mem": 62000000,
"max_block_ex_steps": 20000000000,
"max_val_size": 5000,
"collateral_percent": 150,
"max_collateral_inputs": 3,
"coins_per_utxo_size": "4310"
}
]
```
#### get_epoch_block_protocols
Get the information about block protocol distribution in epoch\
Parameters: Epoch (optional)\
Returns: The list of epoch protocol distribution dictionaries\
Example:\
`epoch_block_protocols = get_epoch_block_protocols(380)`\
Example response:
```json
[
{
"proto_major": 7,
"proto_minor": 0,
"blocks": 8930
},
{
"proto_major": 8,
"proto_minor": 0,
"blocks": 12340
}
]
```
### Block
#### get_blocks
Get summarised details about all blocks (paginated - latest first)\
Parameters: The maximum number of blocks to return\
Returns: The list of block dictionaries (the newest first)\
Example:\
`blocks = get_blocks(3)`\
Example response:
```json
[
{
"hash": "8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6",
"epoch_no": 381,
"abs_slot": 79266935,
"epoch_slot": 38135,
"block_height": 8129401,
"block_size": 49025,
"block_time": 1670833226,
"tx_count": 19,
"vrf_key": "vrf_vk1pj8n7cv07gn4s83vnxgnh3l4m0uqunud2hfmn6d203v6gjvn6jfq9yanjy",
"pool": "pool1qqq6qqa0hpzvumv5p87ynczfmdj557xuwlc3289ke42g72z7f74",
"proto_major": 8,
"proto_minor": 0,
"op_cert_counter": 10
},
{
"hash": "6464132c9227e39f2a9bca27d738a28d9cd64aba37f55277d75e7e8e0aa5d892",
"epoch_no": 381,
"abs_slot": 79266917,
"epoch_slot": 38117,
"block_height": 8129400,
"block_size": 88807,
"block_time": 1670833208,
"tx_count": 52,
"vrf_key": "vrf_vk1hnkdcm6y67amyfnhu4gv2n77496wxmnznke6fqdan53j20mc6jjq7q98e6",
"pool": "pool1nhd907krga9dh69kf0jg4tl0764rravepy337gptvsknxyyx94k",
"proto_major": 8,
"proto_minor": 0,
"op_cert_counter": 20
},
{
"hash": "7ba6d760e576d3b078dedd931284e0f818306fd71bdba47a0fc6b8b9b7c22dbc",
"epoch_no": 381,
"abs_slot": 79266839,
"epoch_slot": 38039,
"block_height": 8129399,
"block_size": 10031,
"block_time": 1670833130,
"tx_count": 7,
"vrf_key": "vrf_vk1kchxdfjqfew7vt88e7l6q2eg3nylf5arahhp8pzfn5z2eyy0z4tsg7sr5k",
"pool": "pool15yyxtkhz64p7a8cnax9l7u82s9t9hdhyxsa3tdm977qhgpnsuhq",
"proto_major": 7,
"proto_minor": 0,
"op_cert_counter": 30
}
]
```
#### get_block_info
Get detailed information about a specific block\
Parameters: Block hash as string (for one block) or list of block hashes
(for multiple blocks)\
Returns: The list of block dictionaries\
Example:\
`block_info = get_block_info('8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6')`\
Example response:
```json
[
{
"hash": "8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6",
"epoch_no": 381,
"abs_slot": 79266935,
"epoch_slot": 38135,
"block_height": 8129401,
"block_size": 49025,
"block_time": 1670833226,
"tx_count": 19,
"vrf_key": "vrf_vk1pj8n7cv07gn4s83vnxgnh3l4m0uqunud2hfmn6d203v6gjvn6jfq9yanjy",
"op_cert": "9dac36a4e413be97bcc4d34341023d3ee9d825e27a45beac739270f6e344d478",
"op_cert_counter": 10,
"pool": "pool1qqq6qqa0hpzvumv5p87ynczfmdj557xuwlc3289ke42g72z7f74",
"proto_major": 8,
"proto_minor": 0,
"total_output": "45569728258134",
"total_fees": "5966381",
"num_confirmations": 10,
"parent_hash": null,
"child_hash": null
}
]
```
#### get_block_txs
Get a list of all transactions included in provided blocks\
Parameters: Block(s) hash(es) as string (for one block) or list of block hashes
(for multiple blocks)\
Returns: The list of transaction dictionaries by block\
Example:\
`block_txs = get_block_txs('8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6')`\
Example response:
```json
[
{
"block_hash": "8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6",
"tx_hashes": [
"d1c7496398b02cb2833c3e164947e1ec171819b7ec056fc6b798e2ee122af862",
"6fe4152a34ee23ccdb5b42e9397ec1c960e51eb28d101b7a59645ce8299fa553",
"2982bdebe8425c19a275416331cdb54d71409e9107e0add51784a37735fc2316",
"bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef",
"291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937",
"505057f2ce7e9cc2442c6dd2339e476e916f1d7b03888110c455082a808e47f5",
"1b4cab1352b8f5b91f97a05c05244ad654282ece5b5f118a0302bc90c86e7476",
"9f38998d3ef516f3150a1dc1f8a3f96ca8aa98636b63d835b4f480712d010474",
"99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6",
"0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060",
"a42ee1a5685ff6953464c32af6221b43732a8550d40f2b7f67f6d2250dfdcbb2",
"63f99851ff566f801552aed538f8edd2eb4d20b9b66d475f2d51b075595443e7",
"ecc46903435f89dde0e65865404a1c3a3af0ec78e08ff6e771e410539037f35e",
"1515e444851c9c7d3abe85ff275c5fd5af8d4844da04f1472d343bcc27f7e58c",
"12ad9fd5bb7482ee08de25d748288c41df4b05ac079d307a36b6159980fa4b03",
"c99ed71da7c20d34ceba491c68e60a94c898db0c4b4360f54da09f7ae09370f0",
"a061003549062114645dfd5d7a353189edb2b6d0f9049f8b1a52ee42d5397247",
"57619d9198ac449cda755e255ed639d43c82a0e38ec001194f373a151d05a159",
"6a4adc1e4ef496dc5fadb01641cc849633a13524ac63800a1e1c2e4e87238777"
]
}
]
```
### Transactions
#### get_utxo_info
Get UTxO set for requested UTxO references\
Parameters: UTxO(s) hash(es) and index(es) as a string (for one transaction)
or list (for multiple transactions), with "#" between the UTxO hash
and the index\
Returns: The list of complete UTxO information\
Example:\
`utxo_info = get_utxo_info('99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6#0')`\
Example response:
```json
[
{
"tx_hash": "99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6",
"tx_index": 0,
"address": "addr1qy59gr3ylt0us3xj7tawpxfn6ccauxa2upwv04m8mg5jehujfkxey5y9v6huj69rp39fk8zh3gpvrmc0mc4fr0j379kqp865ns",
"value": "4817999",
"stake_address": "stake1uxfymrvj2zzkdt7fdz3scj5mr3tc5qkpau8au253heglzmqjatts0",
"payment_cred": "28540e24fadfc844d2f2fae09933d631de1baae05cc7d767da292cdf",
"epoch_no": 381,
"block_height": 8129401,
"block_time": 1670833226,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": true
}
]
```
#### get_tx_info
Get detailed information about transaction(s)\
Parameters: Transaction(s) hash(es) as a string (for one transaction)
or list (for multiple transactions)\
Returns: The list of transactions details dictionaries\
Example:\
`tx_info = get_tx_info('99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6')`\
Example response:
```json
[
{
"tx_hash": "99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6",
"block_hash": "8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6",
"block_height": 8129401,
"epoch_no": 381,
"epoch_slot": 38135,
"absolute_slot": 79266935,
"tx_timestamp": 1670833226,
"tx_block_index": 8,
"tx_size": 436,
"total_output": "4817999",
"fee": "182001",
"deposit": "0",
"invalid_before": null,
"invalid_after": null,
"collateral_inputs": [],
"collateral_output": null,
"reference_inputs": [],
"inputs": [
{
"value": "5000000",
"tx_hash": "1d6776a3a1bed38f6705bc8c861c2a49d65423ecac9409f4a532a085901e29f8",
"tx_index": 0,
"asset_list": [
{
"quantity": "2",
"policy_id": "27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357",
"asset_name": "414952",
"fingerprint": "asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25"
},
{
"quantity": "2",
"policy_id": "27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357",
"asset_name": "4541525448",
"fingerprint": "asset1udwewa3sp34ukmeddhkwf8msqd6dq6frhy2j9s"
}
],
"datum_hash": null,
"stake_addr": null,
"inline_datum": null,
"payment_addr": {
"cred": "48edbef119f1330e0faa124f623054ab5e2e4464e9f6c9b8ebf0afaf",
"bech32": "addr1v9ywm0h3r8cnxrs04gfy7c3s2j44utjyvn5ldjdca0c2ltccgqdes"
},
"reference_script": null
}
],
"outputs": [
{
"value": "4817999",
"tx_hash": "99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6",
"tx_index": 0,
"asset_list": [
{
"quantity": "1",
"policy_id": "27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357",
"asset_name": "414952",
"fingerprint": "asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25"
}
],
"datum_hash": null,
"stake_addr": "stake1uxfymrvj2zzkdt7fdz3scj5mr3tc5qkpau8au253heglzmqjatts0",
"inline_datum": null,
"payment_addr": {
"cred": "28540e24fadfc844d2f2fae09933d631de1baae05cc7d767da292cdf",
"bech32": "addr1qy59gr3ylt0us3xj7tawpxfn6ccauxa2upwv04m8mg5jehujfkxey5y9v6huj69rp39fk8zh3gpvrmc0mc4fr0j379kqp865ns"
},
"reference_script": null
}
],
"withdrawals": [],
"assets_minted": [
{
"quantity": "-1",
"policy_id": "27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357",
"asset_name": "414952",
"fingerprint": "asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25"
},
{
"quantity": "-2",
"policy_id": "27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357",
"asset_name": "4541525448",
"fingerprint": "asset1udwewa3sp34ukmeddhkwf8msqd6dq6frhy2j9s"
}
],
"metadata": null,
"certificates": [],
"native_scripts": [],
"plutus_contracts": []
}
]
```
#### get_tx_metadata
Get metadata information (if any) for given transaction(s)\
Parameters: Transaction(s) hash(es) as a string (for one transaction)
or list (for multiple transactions)\
Returns: The list of transactions metadata dictionaries\
Example:\
`tx_metadata = get_tx_metadata('291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937')`\
Example response:
```json
[
{
"tx_hash": "291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937",
"metadata": {
"0": "d8799f581c078075595cc992a8d99eaad00a118e59303f1dae095601a05dec15",
"1": "9a9fd8799fd8799fd8799f581c07279c6cb6238c73c6ef7429894d7906a5b326",
"2": "39faa311af8f56f884ffd87a80ffa140d8799f00a1401a069db9c0ffffd8799f",
"3": "d8799fd8799f581c70e60f3b5ea7153e0acc7a803e4401d44b8ed1bae1c7baaa",
"4": "d1a62a72ffd8799fd8799fd8799f581c1e78aae7c90cc36d624f7b3bb6d86b52",
"5": "696dc84e490f343eba89005fffffffffa140d8799f00a1401a00a95f60ffffd8",
"6": "799fd8799fd8799f581c078075595cc992a8d99eaad00a118e59303f1dae0956",
"7": "01a05dec159affd8799fd8799fd8799f581c6921c483c2ba3451072c5f90058d",
"8": "c40c7b35af88238dd105f82570d2ffffffffa140d8799f00a1401a19cd87a0ff",
"9": "ffffff",
"30": "4"
}
}
]
```
#### get_tx_metalabels
Get a list of all transaction metadata labels\
Parameters: none\
Returns: The list of transaction metadata labels dictionaries\
Example:\
`tx_metalabels = get_tx_metalabels()`\
Example response:
```json
[
{
"key": "0"
},
{
"key": "1"
},
{
"key": "2"
},
{
"key": "3"
},
{
"key": "4"
},
{
"key": "5"
},
...
{
"key": "1657732524678"
},
{
"key": "1657905239358"
}
]
```
#### submit_tx
Submit an already serialized transaction to the network\
Parameters: Transaction in cbor format\
Returns: Transaction hash\
Example:\
`response = submit_tx(tx)`\
Example response:
```text
0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060
```
#### get_tx_status
Get the number of block confirmations for a given transaction hash list\
Parameters: Transaction(s) hash(es) as a string (for one transaction)
or list (for multiple transactions)\
Returns: The list of transactions block confirmations dictionaries\
Example:\
`tx_status = get_tx_status('0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060')`\
Example response:
```json
[
{
"tx_hash": "0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060",
"num_confirmations": 228
}
]
```
### Address
#### get_address_info
Get the transaction hash list of input address array, optionally filtering
after specified block height (inclusive)\
Parameters: Payment address(es) as string (for one address) or list
(for multiple addresses)\
Returns: The list of transactions dictionaries\
Example:\
`address_info = get_address_info('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\
Example response:
```json
[
{
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"balance": "15418617",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"script_address": false,
"utxo_set": [
{
"tx_hash": "c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973",
"tx_index": 1,
"block_height": 8129403,
"block_time": 1670833300,
"value": "15418617",
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": []
}
]
}
]
```
#### get_address_utxos
Get UTxO set for given addresses\
Parameters: \
Address(es): Payment address(es) as string (for one address) or list
(for multiple addresses)\
Extended: Boolean which controls whether certain optional fields supported\
by a given endpoint are populated as a part of the request\
Returns: The list of transactions dictionaries\
Example:\
`address_utxos = get_address_utxos('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\
Example response:
```json
[
{
"tx_hash": "eb9fc5848297ac94903164519dc9955acc5645b831ed48ad03c67edefec9b50d",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "5459647",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 439,
"block_height": 9356379,
"block_time": 1696084155,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "67f7b1240deff9bafd7d5f9da199d40f1072519edfc21592485a583f31a8a966",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "12740897",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 447,
"block_height": 9532358,
"block_time": 1699686385,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "cb3646d0739dd1884b2cf16fbc8fc768763103ddcdd3a3f9fc7fd6a0ea75fa63",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "19778509",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 448,
"block_height": 9537064,
"block_time": 1699782852,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "1fc61d4f02f170554e06b2608fc021a5c6910faa125c8baebbaa66d16dadec44",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "25618819",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 448,
"block_height": 9538689,
"block_time": 1699816992,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "f38eb43c9c5d899ad9d5a727a6cd64fce34e5ddb0b3cc29a3241931ba323f2d9",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "16173935",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 449,
"block_height": 9564511,
"block_time": 1700343086,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "1c00a4087c594c4453c8c3a8f51663d0a9ba59f3e3e02cf961c01d8cc80edd44",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "15633446",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 450,
"block_height": 9587376,
"block_time": 1700814155,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "40e3609e2d1c3ea38601d119dbf6711a448defaadc4fa1d1590c0d48f29c240e",
"tx_index": 1,
"address": "addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7",
"value": "12308427",
"stake_address": "stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j",
"payment_cred": "dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39",
"epoch_no": 450,
"block_height": 9592563,
"block_time": 1700923481,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
}
]
```
#### get_credential_utxos
Get a list of UTxO against input payment credential array including their
balances\
Parameters: Payment credential(s) as string (for one credential) or list
(for multiple credentials)\
Returns: The list of UTxO against input payment credential array including
their balances\
Example:\
`credential_utxos = get_credential_utxos('0c35748e147183cd784875e78a5b372fa6975e9ac6406d6015c09bac')`\
Example response:
```json
[
{
"tx_hash": "8e9b85284f92ad85416d4fb0a3ff5d3bbd9b57c4a4d97a8d39dc99316eace0cf",
"tx_index": 0,
"value": "5000000"
},
{
"tx_hash": "e7333c01d3c2887767aca13e5c74fb858fbf0119cd90d944869ee72b8b81f523",
"tx_index": 1,
"value": "20432286"
},
{
"tx_hash": "ecfbbc335ec203b10ee65faddf06fb0ceac27c36ef3a76047fbf820f6e9ed7f2",
"tx_index": 2,
"value": "2301540"
},
{
"tx_hash": "b70a9107a38e776c0b1d94a1578c393a1ce01ea8e28ed56c5c724a2639e31bfe",
"tx_index": 2,
"value": "1150770"
},
{
"tx_hash": "1107afdada22f259aa798de57ca3839e212e977467628c85315326917a13dd3b",
"tx_index": 2,
"value": "1150770"
},
...
{
"tx_hash": "b9d519ff9309dd78a7e8031aef2fa6b21358478efed5f0bdf234fa10c83eede7",
"tx_index": 1,
"value": "137666866"
}
]
```
#### get_address_txs
Get the transaction hash list of input address array, optionally filtering
after specified block height (inclusive)\
Parameters: Payment address(es) as string (for one address) or list
(for multiple addresses)\
Returns: The list of transactions dictionaries\
Example:\
`address_txs = get_address_txs('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\
Example response:
```json
[
{
"tx_hash": "c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973",
"epoch_no": 381,
"block_height": 8129403,
"block_time": 1670833300
},
{
"tx_hash": "bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef",
"epoch_no": 381,
"block_height": 8129401,
"block_time": 1670833226
},
{
"tx_hash": "2534b92a1d04ef39f9915bef8d7c5246cc4db880ac01f3499fe9aa83ac155a19",
"epoch_no": 380,
"block_height": 8127226,
"block_time": 1670787767
},
...
{
"tx_hash": "3c16d642fc92012a8808446b29fe89028a2bc37508048a9eb465265d30a24386",
"epoch_no": 373,
"block_height": 7971352,
"block_time": 1667570778
}
]
```
#### get_credential_txs
Get the transaction hash list of input payment credential array,
optionally filtering after specified block height (inclusive)\
Parameters: \
Credential(s) as string (for one credential) or list
(for multiple credentials)\
After block height (optional): Only fetch information after
specific block height\
Returns: The list of address information dictionaries\
Example:\
`credential_txs = get_credential_txs('dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39')`\
Example response:
```json
[
{
"tx_hash": "c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973",
"epoch_no": 381,
"block_height": 8129403,
"block_time": 1670833300
},
{
"tx_hash": "bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef",
"epoch_no": 381,
"block_height": 8129401,
"block_time": 1670833226
},
...
{
"tx_hash": "3c16d642fc92012a8808446b29fe89028a2bc37508048a9eb465265d30a24386",
"epoch_no": 373,
"block_height": 7971352,
"block_time": 1667570778
}
]
```
#### get_address_assets
Get the list of all the assets (policy, name and quantity) for given
addresses\
Parameters: Payment address(es) as string (for one address) or list
(for multiple addresses)\
Returns: The list of assets dictionaries by address\
Example:\
`address_assets = get_address_assets('addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh')`\
Example response:
```json
[
{
"address": "addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh",
"asset_list": [
{
"policy_id": "07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd",
"asset_name": "4379626572696130363936",
"fingerprint": "asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70",
"quantity": "1"
},
{
"policy_id": "14a95b2a4a863c8074d6a78a6a445150223e867999a90295dc1d0cf6",
"asset_name": "50726f6a65637456656e757330303536",
"fingerprint": "asset1pdz0dvugfezf6evgyvvyl5zda8mhdfhef8d3fd",
"quantity": "1"
},
...
{
"policy_id": "ffff5571ecec795284f04ad6e6852ed2d46d924535ed68ad97fa1e70",
"asset_name": "634e4654636f6e486f70706572363935",
"fingerprint": "asset1dcn7mx0ccelvmweef6wjcuhur9a2hpg8des4pl",
"quantity": "1"
}
]
}
]
```
### Asset
#### get_asset_list
Get the list of all native assets (paginated)\
Parameters:\
Asset Policy (optional), default: all policies\
The offset (optional) to start from, default 0\
The maximum number of accounts to return (optional), default 0 (no limit)\
Returns: The list of assets dictionaries by policy\
Example:\
`asset_list = get_asset_list()`\
Example response:
```json
[
{
"policy_id": "00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae",
"asset_name": "6e7574636f696e",
"fingerprint": "asset12h3p5l3nd5y26lr22am7y7ga3vxghkhf57zkhd"
},
{
"policy_id": "000000adf8fcbdf03a5c154123aff674edf287fb13532a343b617fb2",
"asset_name": "5853534e4654",
"fingerprint": "asset1ke42k9ug86yr535qwkq5edlvfdvlpfuslrmfup"
},
...
{
"policy_id": "00255c245861e1e15ef8aced64d44dd20682ee7c2bb42b7941e199dd",
"asset_name": "43726565707942616c6c7a57316231303137",
"fingerprint": "asset12dvnasghksl5k7w696nd5t692j6myexapwjh0d"
},
...
]
```
#### get_policy_asset_list
Get the list of asset under the given policy (including balances)\
Parameters: Asset Policy\
Returns: List of dictionaries with the asset under the given policy\
Example:\
`asset_policy_list = get_policy_asset_list('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\
Example response:
```json
[
{
"asset_name": "",
"asset_name_ascii": "",
"fingerprint": "asset1pht97cylpt7azuu9mwhmd9c9zdgmumwrrm5yrc",
"minting_tx_hash": "90415fda215ff5098d7fa1385c7358c589066332068b720380726e3ef0b26de4",
"total_supply": "0",
"mint_cnt": 1,
"burn_cnt": 1,
"creation_time": 1665100800,
"minting_tx_metadata": {
"777": {
"addr": [
"addr1qy36jns6h4w4f80u6xed49k6qn9c7tk4x4us5kaxztjq8x3un2me8nvc5ke",
"gvll0gnwlj2ypzfhhqpns47u76gafttmq208x4d"
],
"rate": "0.05"
}
},
"token_registry_metadata": null
},
...
{
"asset_name": "4379626572696130333939",
"asset_name_ascii": "Cyberia0399",
"fingerprint": "asset1g7tgq2ly8uhtzcz79uhay8tq46h9rq62arfm8s",
"minting_tx_hash": "98db0a36106a92149b256887f6300f2b228e14d24d488e4b1614920083cd64ff",
"total_supply": "1",
"mint_cnt": 1,
"burn_cnt": 0,
"creation_time": 1665187200,
"minting_tx_metadata": {
"721": {
"nonce": "c966f455d3e03537",
"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd": {
"Cyberia0399": {
"Pose": "Lunge pose - Anjaneyasana",
"Skin": "Gold",
"name": "Cyberia Chakra Planet #0399",
"files": [
{
"src": "ipfs://QmVsMggcQE3da9xuZv7uvJRH84gs5ebGQ8kxVPSQw52XRf",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmSHyNm11PrqyrUXszKtsz52ADH6A934c3gw41H7CMCj7D",
"mediaType": "text/html"
}
],
"image": "ipfs://QmVsMggcQE3da9xuZv7uvJRH84gs5ebGQ8kxVPSQw52XRf",
"Artist": "Shrink",
"Avatar": "Male",
"Chakra": "Sacral - Svadhisthana",
"Mantra": "VAM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Sexual and Creative Energy",
"Location": "Below the Belly Button",
"Collection": "Chakra Planets",
"Planet colour": "Orange"
},
"Cyberia2795": {
"Pose": "Headstand - Sirsasana",
"Skin": "Gold",
"name": "Cyberia Chakra Planet #2795",
"files": [
{
"src": "ipfs://QmZ4TGY2Jzy5JGaD3S7RLsrP9K8jbp44e7463iHAGitM5a",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmcEqKkAcxeGNZimSiQZ2duZA4sx4xJawh35VwuJoS3A9m",
"mediaType": "text/html"
}
],
"image": "ipfs://QmZ4TGY2Jzy5JGaD3S7RLsrP9K8jbp44e7463iHAGitM5a",
"Artist": "Shrink",
"Avatar": "Female",
"Chakra": "Crown - Sahasrara",
"Mantra": "OM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Spiritual Connection",
"Location": "Top of the Head",
"Collection": "Chakra Planets",
"Planet colour": "Purple"
}
}
}
},
"token_registry_metadata": null
}
]
```
#### get_asset_token_registry
Get a list of assets registered via token registry on github\
Parameters: logo (bool) - include the logo in the response or not, default: True\
Returns: The list of assets registered via token registry on github\
Example:\
`asset_token_registry = get_asset_token_registry()`\
Example response:
```json
[
{
"policy_id": "00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae",
"asset_name": "6e7574636f696e",
"asset_name_ascii": "nutcoin",
"ticker": "NUT",
"description": "The legendary Nutcoin, the first native asset minted on Cardano.",
"url": "https://fivebinaries.com/nutcoin",
"decimals": 0,
"logo": "iVBORw0KGgoAAAANSUhEUgAAAGQA....2rCPgau2EAAAAASUVORK5CYII="
},
{
"policy_id": "00109530994ea381c0bfe0936c85ea01bfe2765c24ef6dad5740c33e",
"asset_name": "486f646c657220436f616c6974696f6e20436f696e",
"asset_name_ascii": "Hodler Coalition Coin",
"ticker": "HODLR",
"description": "Stake ₳DA with the Hodler Coalition. Save the World.",
"url": "https://www.hodlerstaking.com/",
"decimals": 4,
"logo": "iVBORw0KGgoAAAANSUhEUgAAARAAA...4RtRz5t2G8zAAAAAElFTkSuQmCC"
},
{
"policy_id": "0011fbab202151eca9e9ef7680569d9419d12e51e693cb05a2edd2ed",
"asset_name": "4341524b",
"asset_name_ascii": "Cardano Ark Token",
"ticker": "CARK",
"description": "Utility token for the Cardano Ark",
"url": "https://www.cardanoark.com/",
"decimals": 0,
"logo": ""
},
...
]
```
#### get_asset_info
Get the information of a list of assets including first minting &\
token registry metadata\
Parameters: Asset(s) as policy id and asset name (hex)\
("asset_policy.asset_name"), separated by dot ("."), as a string \
(for one) asset or as a list for multiple assets\
Returns: The list of assets including first minting & token registry metadata\
Example:\
`asset_info = get_asset_info('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd.4379626572696130363936')`\
Example response:
```json
[
{
"policy_id": "07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd",
"asset_name": "4379626572696130363936",
"asset_name_ascii": "Cyberia0696",
"fingerprint": "asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70",
"minting_tx_hash": "f17b6fafbd1760d5d9defc0334c6a74926fd61a126842ac640b40ffb9c551a31",
"total_supply": "1",
"mint_cnt": 1,
"burn_cnt": 0,
"creation_time": 1665182000,
"minting_tx_metadata": {
"721": {
"nonce": "4f0b0a78bc757e05",
"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd": {
"Cyberia0696": {
"Pose": "Warrior II Pose - Virabhadrasana II",
"Skin": "Red",
"name": "Cyberia Chakra Planet #0696",
"files": [
{
"src": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d",
"mediaType": "text/html"
}
],
"image": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"Artist": "Shrink",
"Avatar": "Male",
"Chakra": "Root - Muladhara",
"Mantra": "LAM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Grounding",
"Location": "Base of Spine",
"Collection": "Chakra Planets",
"Planet colour": "Red"
}
}
}
},
"token_registry_metadata": null
}
]
```
#### get_asset_utxos
Get the UTXO information of a list of assets\
Parameters:\
Asset(s) as policy id and asset name (hex)\
("asset_policy.asset_name"), separated by dot ("."), as a string \
(for one) asset or as a list for multiple assets\
Extended: Controls whether certain optional fields supported\
by a given endpoint are populated\
Returns: List of UTxO information for the requested assets\
Example:\
`asset_utxos = get_asset_utxos('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd.4379626572696130363936')`\
Example response:
```json
[
{
"tx_hash": "0cfaa1a897dcac81d8faf7227f34654532a4b40b82694fe29e68af9bfa300cf8",
"tx_index": 3,
"address": "addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh",
"value": "22424930",
"stake_address": "stake1uy679wem7a6nv4hadzfvdrfrvzd7fxx805mermr5ryl4fkgylfnyv",
"payment_cred": "1c1578b4e5abce42d30c33c8a70e21f2ea79b3e773c5ccdded25ae7c",
"epoch_no": 447,
"block_height": 9523865,
"block_time": 1699513130,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
}
]
```
#### get_asset_history
Get the mint/burn history of an asset\
Parameters:\
Asset Policy\
Asset Name in hexadecimal format (optional), default: all policy assets\
Returns: List of dictionaries with the mint/burn history of an asset\
Example:\
`asset_history = get_asset_history('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\
Example response:
```json
[
{
"policy_id": "07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd",
"asset_name": "4379626572696130363936",
"fingerprint": "asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70",
"minting_txs": [
{
"tx_hash": "f17b6fafbd1760d5d9defc0334c6a74926fd61a126842ac640b40ffb9c551a31",
"block_time": 1665182000,
"quantity": "1",
"metadata": [
{
"key": "721",
"json": {
"nonce": "4f0b0a78bc757e05",
"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd": {
"Cyberia0696": {
"Pose": "Warrior II Pose - Virabhadrasana II",
"Skin": "Red",
"name": "Cyberia Chakra Planet #0696",
"files": [
{
"src": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d",
"mediaType": "text/html"
}
],
"image": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"Artist": "Shrink",
"Avatar": "Male",
"Chakra": "Root - Muladhara",
"Mantra": "LAM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Grounding",
"Location": "Base of Spine",
"Collection": "Chakra Planets",
"Planet colour": "Red"
}
}
}
}
]
}
]
}
]
```
#### get_asset_addresses
Get the list of all addresses holding a given asset\
Parameters:\
Asset Policy\
Asset Name in hexadecimal format (optional), default: all policy assets\
Returns: List of dictionaries with the wallets holding the asset and the
amount of assets per wallet\
Example:\
`asset_addresses = get_asset_addresses('07697e6ca1e21777ac76f26d0779c
53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\
Example response:
```json
[
{
"payment_address": "addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh",
"quantity": "1"
}
]
```
#### get_asset_nft_address
Get the address where specified NFT currently reside on.\
Parameters:\
Asset Policy\
Asset Name in hexadecimal format\
Returns: The wallet address holding the NFT as a list of one dictionary\
Example:\
`asset_nft_address = get_asset_nft_address('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\
Example response:
```json
[
{
"payment_address": "addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh"
}
]
```
#### get_policy_asset_addresses
Get the list of addresses with quantity for each asset on the given policy\
Parameters: Asset Policy\
Returns: List of addresses with quantity for each asset on the given policy\
Example:\
`asset_policy_info = get_policy_asset_addresses('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\
Example response:
```json
[
{
"asset_name": "4379626572696130303233",
"payment_address": "addr1qxu5vk5xafdp39d95ya06d6uya8ldua7crpdzd2an07uw8mrtndmfr0d4qarvgj2wasdwlvrnlqt262jn5asnws7aekssq73gf",
"quantity": "1"
},
{
"asset_name": "4379626572696130303330",
"payment_address": "addr1q9wj7ylly5nz2kel6huy966tcsw2l3ct9at7m3euhfxyv246nlp3dj9pda2rphtzycwexsaapyk73k25y3j5neyhg45s879sk4",
"quantity": "1"
},
...
{
"asset_name": "4379626572696132383338",
"payment_address": "addr1qxg2l50ryn6z23543v6nujvkql9zwj7f7hvsjwalw6jvf25n5k332a42ge9w5en95g9af59fft32g0la0qtfr9vfyyesccney2",
"quantity": "1"
}
]
```
#### get_policy_asset_info
Get the list of asset under the given policy (including balances)\
Parameters: Asset Policy\
Returns: List of dictionaries with the policy assets\
Example:\
`asset_policy_info = get_policy_asset_info('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\
Example response:
```json
[
{
"asset_name": "",
"asset_name_ascii": "",
"fingerprint": "asset1pht97cylpt7azuu9mwhmd9c9zdgmumwrrm5yrc",
"minting_tx_metadata": {
"key": "777",
"json": {
"addr": [
"addr1qy36jns6h4w4f80u6xed49k6qn9c7tk4x4us5kaxztjq8x3un2me8nvc5ke",
"gvll0gnwlj2ypzfhhqpns47u76gafttmq208x4d"
],
"rate": "0.05"
}
},
"token_registry_metadata": null,
"total_supply": "0",
"creation_time": 1665161713
},
{
"asset_name": "4379626572696130353930",
"asset_name_ascii": "Cyberia0590",
"fingerprint": "asset1dzurenp8f6n8zu3lwglrs0g54xnmd5xwqe9yqp",
"minting_tx_metadata": {
"key": "721",
"json": {
"nonce": "ac2834e7b5707c30",
"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd": {
"Cyberia0590": {
"Pose": "Warrior II Pose - Virabhadrasana II",
"Skin": "Red",
"name": "Cyberia Chakra Planet #0590",
"files": [
{
"src": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d",
"mediaType": "text/html"
}
],
"image": "ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX",
"Artist": "Shrink",
"Avatar": "Male",
"Chakra": "Root - Muladhara",
"Mantra": "LAM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Grounding",
"Location": "Base of Spine",
"Collection": "Chakra Planets",
"Planet colour": "Red"
}
}
}
},
"token_registry_metadata": null,
"total_supply": "1",
"creation_time": 1665180305
},
...
{
"asset_name": "4379626572696131313535",
"asset_name_ascii": "Cyberia1155",
"fingerprint": "asset1c7ymj2plmz9dddyx80axrpwy8uhm8q4hzdg3g7",
"minting_tx_metadata": {
"key": "721",
"json": {
"nonce": "18501ab3c76e955b",
"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd": {
"Cyberia0921": {
"Pose": "Headstand - Sirsasana",
"Skin": "Gold",
"name": "Cyberia Chakra Planet #0921",
"files": [
{
"src": "ipfs://QmaNEfYXpqFM3vRdvhUkccFpSHUc6MpA6D1Jriefz5oaZr",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmT22qfNW8Ts3FcfbLTe1jx2L7XfJaxzuqKLZ9Qiw45srk",
"mediaType": "text/html"
}
],
"image": "ipfs://QmaNEfYXpqFM3vRdvhUkccFpSHUc6MpA6D1Jriefz5oaZr",
"Artist": "Shrink",
"Avatar": "Male",
"Chakra": "Crown - Sahasrara",
"Mantra": "OM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Spiritual Connection",
"Location": "Top of the Head",
"Collection": "Chakra Planets",
"Planet colour": "Purple"
},
"Cyberia1155": {
"Pose": "Headstand - Sirsasana",
"Skin": "Purple",
"name": "Cyberia Chakra Planet #1155",
"files": [
{
"src": "ipfs://QmdRbAZpWvrXQ1wDqWL7fhifJfd6dowx4oZpufdWFiG5Qo",
"name": "Please wait while your experience below loads.",
"mediaType": "image/jpg"
},
{
"src": "ipfs://QmfC6r68AzrQyN17Yns4fhtVY4HE9FCPdtv5bsBgfac1qD",
"mediaType": "text/html"
}
],
"image": "ipfs://QmdRbAZpWvrXQ1wDqWL7fhifJfd6dowx4oZpufdWFiG5Qo",
"Artist": "Shrink",
"Avatar": "Female",
"Chakra": "Crown - Sahasrara",
"Mantra": "OM",
"Discord": "https://dsc.gg/cyberiacnft",
"Twitter": "https://twitter.com/cyberiaCNFT",
"Website": "https://cyberia.gg/",
"Function": "Spiritual Connection",
"Location": "Top of the Head",
"Collection": "Chakra Planets",
"Planet colour": "Purple"
}
}
}
},
"token_registry_metadata": null,
"total_supply": "1",
"creation_time": 1670493734
}
]
```
#### get_asset_summary
Get the summary of an asset (total transactions exclude minting/total wallets
include only wallets with asset balance)\
Parameters:\
Asset Policy\
Asset Name in hexadecimal format (optional), default: all policy assets\
Returns: List of dictionaries with the mint/burn history of an asset\
Example:\
`asset_summary = get_asset_summary('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696131313535')`\
Example response:
```json
[
{
"policy_id": "07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd",
"asset_name": "4379626572696131313535",
"fingerprint": "asset1c7ymj2plmz9dddyx80axrpwy8uhm8q4hzdg3g7",
"total_transactions": 1,
"staked_wallets": 0,
"unstaked_addresses": 0
}
]
```
#### get_asset_txs
Get the list of all asset transaction hashes (the newest first)\
Parameters:\
Asset Policy\
Asset Name in hexadecimal format (optional), default: all policy assets\
Block number (optional) - return only the transactions after this block\
History boolean (optional) - include all historical transactions, setting to
false includes only the non-empty ones\
Returns: List of dictionaries with the mint/burn history of an asset\
Example:\
`asset_txs = get_asset_txs('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696131313535')`\
Example response:
```json
[
{
"tx_hash": "d4ac560398b95e6435bd6657e39fe5638f7c5bfaa6ffa6b8fa9bfae0b4882666",
"epoch_no": 380,
"block_height": 8112717,,
"block_time": 1670493734
}
]
```
### Pool
#### get_pool_list
A list of all currently registered/retiring (not retired) pools\
Parameters: none\
Returns: The list of stake pool dictionaries\
Example:\
`pool_list = get_pool_list()`\
Example response:
```json
[
{
"pool_id_bech32": "pool100wj94uzf54vup2hdzk0afng4dhjaqggt7j434mtgm8v2gfvfgp",
"ticker": "JFLD"
},
{
"pool_id_bech32": "pool102s2nqtea2hf5q0s4amj0evysmfnhrn4apyyhd4azcmsclzm96m",
"ticker": "YULI"
},
...
{
"pool_id_bech32": "pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd",
"ticker": "APEX"
},
...
]
```
#### get_pool_info
Current pool statuses and details for a specified list of pool ids\
Parameters: Stake pool bech32 ID as string (for one stake pool) or list of
stake pool bech32 IDs (for multiple stake pools)\
Returns: Current pool(s) status(es) and details\
Example:\
`pool_info = get_pool_info('pool10ljdn3zwsh7vjkxf6t250423l5qy487x83st7m8a53jxznrkw5g')`\
Example response:
```json
[
{
"pool_id_bech32": "pool10ljdn3zwsh7vjkxf6t250423l5qy487x83st7m8a53jxznrkw5g",
"pool_id_hex": "7fe4d9c44e85fcc958c9d2d547d551fd004a9fc63c60bf6cfda46461",
"active_epoch_no": 214,
"vrf_key_hash": "d163c63c5d8d668942542926945f19b89264d4d3ed469dc7fa2741c52f102aec",
"margin": 0.005,
"fixed_cost": "340000000",
"pledge": "1200000000000",
"reward_addr": "stake1u9ea9tc86xqvg6jqafhk8gz2j36csqe6gqtsd0yq7usr0eg4y2625",
"owners": [
"stake1u9sfwmw28cmv5c7fg60jygjk3035ssh893ece9y7qph5cpcy9xwk2",
"stake1uxlxz7gsrmxnfa23eg7n08t9dw3lk9kmhvpunc32ascazls0xyq8s"
],
"relays": [
{
"dns": "rl1.fortunepool.net",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
},
{
"dns": "rl2.fortunepool.net",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
},
...
{
"dns": "rl12.fortunepool.net",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
}
],
"meta_url": "http://poolpros.tech/poolMetaData.json",
"meta_hash": "1b085d187182cc78f3e9755c8b40b21050e710fe4a1067f9a2dbda8cadf342ba",
"meta_json": {
"name": "FORTUNE Pool",
"ticker": "FORT",
"homepage": "http://fortunepool.net",
"description": "FORTUNE Pool - A secure Cardano (ADA) stakepool with reliable uptime, high pledge and great rewards for delegators. Delegate with us and make your ADA FORTUNE"
},
"pool_status": "registered",
"retiring_epoch": null,
"op_cert": "1c6b83ff17b31a05046cf660c2a02c852e50eacfa60d89b89ab16aafa7797fc2",
"op_cert_counter": 9,
"active_stake": "4942731898587",
"sigma": 0.00019699539760911983,
"block_count": 722,
"live_pledge": "1255022000000",
"live_stake": "4939842959490",
"live_delegators": 89,
"live_saturation": 7.01
}
]
```
#### get_pool_stake_snapshot
Returns Mark, Set and Go stake snapshots for the selected pool, useful for
leaderlog calculation\
Parameters: Stake pool bech32 id\
Returns: Pool snapshot as list of dictionaries by epoch (current and
previous 2)\
Example:\
`pool_stake_snapshot = get_pool_stake_snapshot('pool155efqn9xpcf73pphkk88cmlkdwx4ulkg606tne970qswczg3asc')`\
Example response:
```json
[
{
"snapshot": "Go",
"epoch_no": 380,
"nonce": "3950677ef48bb212ad335f253ad1998be4e9fe4ae2a26d402607850461398125",
"pool_stake": "64328594406327",
"active_stake": "25065309972207037"
},
{
"snapshot": "Set",
"epoch_no": 381,
"nonce": "4d617a9da289e6ff2574cc737ac22b337c6d2766847d3422db519f137dee7c43",
"pool_stake": "64328594406327",
"active_stake": "25090595813788584"
},
{
"snapshot": "Mark",
"epoch_no": 382,
"nonce": null,
"pool_stake": "64328594406327",
"active_stake": "25079111896910089"
}
]
```
#### get_pool_delegators
Returns information about live delegators for a given pool\
Parameters Stake pool bech32 id\
Returns: The list of pool delegators dictionaries\
Example:\
`pool_delegators = get_pool_delegators('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd')`\
Example response:
```json
[
{
"stake_address": "stake1u80603g5n7vtycl75c60jmv56jx3cw53v23xv0txkpcu8kcwr2k27",
"amount": "852345",
"active_epoch_no": 328,
"latest_delegation_tx_hash": "2c91c8497df98e6a51bf8c05222af8e7b195847764e4a4407afe2504e0773fc7"
},
{
"stake_address": "stake1u82mfrr9ztql37er3hy73rtpccuv5fmet2lrrudmzdrm6qgpf22jy",
"amount": "244092618",
"active_epoch_no": 323,
"latest_delegation_tx_hash": "3594999b3aff5f33490a8ad4611f844efd305782403a8e51067f3ea4721ce821"
},
...
{
"stake_address": "stake1uyzwh2mwjwphgs7kxvd7s8jn640plxf368wj0syftewl0nq06vlqu",
"amount": "103417951621",
"active_epoch_no": 323,
"latest_delegation_tx_hash": "7193e5702d1cac1255c9dac8efe8368abda5b7b6c58b515467b8e2e1ca07d2be"
}
]
```
#### get_pool_delegators_history
Returns information about active delegators (incl. history) for a given pool
and epoch number (all epochs if not specified)\
Parameters:\
Stake pool bech32 id\
Epoch (optional)\
Returns: The list of pool delegators dictionaries\
Example:\
`pool_delegators_history = get_pool_delegators_history('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 380)`\
Example response:
```json
[
{
"stake_address": "stake1uyezz2wzt4rl5wug8ju8zshvfzkw2lksw8jfp0wpueq2nccnnkwxh",
"amount": "1043563298281",
"epoch_no": 380
},
{
"stake_address": "stake1uxptzz4gkehxj5ht85xdjmad5qt0mc00dxmyxd84e2dgrvsla9k0u",
"amount": "1010182386722",
"epoch_no": 380
},
...
{
"stake_address": "stake1uxkm4akqqkkt2ayqwnj5wgex4hddgq65st892cz33ez726q9lf3un",
"amount": "45053",
"epoch_no": 380
}
]
```
#### get_pool_blocks
Returns information about blocks minted by a given pool for all epochs
(or _epoch_no if provided)\
Parameters:\
Stake pool bech32 id\
Epoch (optional)\
Returns: The list of pool blocks dictionaries\
Example:\
`pool_blocks = get_pool_blocks('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 380)`\
Example response:
```json
[
{
"epoch_no": 380,
"epoch_slot": 98385,
"abs_slot": 78895185,
"block_height": 8111118,
"block_hash": "043b2d7b5d125d9f891aa12ad04976be4c3f1ce862b71aff3352dd76be943ae5",
"block_time": 1670461476
},
{
"epoch_no": 380,
"epoch_slot": 381300,
"abs_slot": 79178100,
"block_height": 8125194,
"block_hash": "c6c811e01decdf241465e5b63684917f48fa11556ff04b22ae46d112703a19dc",
"block_time": 1670744391
}
]
```
#### get_pool_history
Returns information about pool stake, block and reward history in a given epoch
(or all epochs that pool existed for, in descending order if no epoch number
was provided)\
Parameters:\
Stake pool bech32 id\
Epoch (optional)\
Returns: Information about pool stake, block and reward history as a list
dictionaries by epoch (descending)\
Example:\
`pool_history = get_pool_history('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 379)`\
Example response:
```json
[
{
"epoch_no": 379,
"active_stake": "3158165931346",
"active_stake_pct": 0.012602983456573744,
"saturation_pct": 4.48,
"block_cnt": 4,
"delegator_cnt": 200,
"margin": 0.0199,
"fixed_cost": "340000000",
"pool_fees": "380697027",
"deleg_rewards": "2004379694",
"epoch_ros": 4.74052366
}
]
```
#### get_pool_updates
Returns all pool updates for all pools or only updates for specific pool
if specified\
Parameters: Stake pool bech32 id (optional)\
Returns: pool updates as a list of dictionaries\
Example:\
`pool_updates = get_pool_updates('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd')`\
Example response:
```json
[
{
"tx_hash": "6358622ef9c7a395aaf1590661330a17095fef3c39caa2ae319c737c85bfacb9",
"block_time": 1665138387,
"pool_id_bech32": "pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd",
"pool_id_hex": "538299a358e79a289c8de779f8cd09dd6a6bb286de717d1f744bb357",
"active_epoch_no": 370,
"vrf_key_hash": "d32b8a284fb259478909aebb4d465d0e2c214ab187d905006da624de023cff7a",
"margin": 0.0199,
"fixed_cost": "340000000",
"pledge": "25000000000",
"reward_addr": "stake1u8mpqafgs22r32cfmkwey9ypjuyl0q0wj2qycxadcjrk0kqu7qh8n",
"owners": [
"stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy",
"stake1uxey9c4w4dlrym6yayltuwmgzucm6068y3spmvan43t2zhs4l9r7f",
"stake1u87djlkkkfehdmxq5zu4nwg7np065kyrr3j38wagcsr56pqc3u0zj"
],
"relays": [
{
"dns": "relay1.apexpool.info",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
},
{
"dns": "relay2.apexpool.info",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
}
],
"meta_url": "https://apexpool.info/poolmetadata.json",
"meta_hash": "82e5f297f2145badd7b03f02a215fc4478772d0df3818e21e36738be48ccc55c",
"meta_json": null,
"pool_status": "registered",
"retiring_epoch": null
},
{
"tx_hash": "0b8fc5e712d6232c2ce2fe64243e6a9ecdc5419a490e929914c2d31d4153e66a",
"block_time": 1649591452,
"pool_id_bech32": "pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd",
"pool_id_hex": "538299a358e79a289c8de779f8cd09dd6a6bb286de717d1f744bb357",
"active_epoch_no": 334,
"vrf_key_hash": "d32b8a284fb259478909aebb4d465d0e2c214ab187d905006da624de023cff7a",
"margin": 0.0199,
"fixed_cost": "340000000",
"pledge": "25000000000",
"reward_addr": "stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy",
"owners": [
"stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy",
"stake1uxey9c4w4dlrym6yayltuwmgzucm6068y3spmvan43t2zhs4l9r7f",
"stake1u87djlkkkfehdmxq5zu4nwg7np065kyrr3j38wagcsr56pqc3u0zj"
],
"relays": [
{
"dns": "relay1.apexpool.info",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
},
{
"dns": "relay2.apexpool.info",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 6000
}
],
"meta_url": "https://apexpool.info/poolmetadata.json",
"meta_hash": "82e5f297f2145badd7b03f02a215fc4478772d0df3818e21e36738be48ccc55c",
"meta_json": null,
"pool_status": "registered",
"retiring_epoch": null
},
...
]
```
#### get_pool_registrations
A list all pool registrations initiated in the requested epoch\
Parameters: Epoch\
Returns: The list of pool registrations\
Example:\
`pool_registrations = get_pool_registrations(450)`\
Example response:
```json
[
{
"pool_id_bech32": "pool1newmccddazerzanrdeeelvzk6vzh9stxn5n8ravshqa05n0t83u",
"tx_hash": "02e3644f9bc23e7f0d04addfee80b4f36ba1da774da3c26ec76a7c8ea43a44ac",
"block_hash": "8aaec0f14cf462e4fa6e7a3340c85f94c746f4397b027d55202f667bf36843fc",
"block_height": 9577227,
"epoch_no": 450,
"epoch_slot": 2118,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1q9kwa675j2z53jecrs6pn3fqsc9ypxrsypu5dgu6hammqkagy22",
"tx_hash": "56a2a1d4cbb28b09f075a8c1db67f7ad721f003703a1d33aa1b9d9784f1fbccf",
"block_hash": "2b3f126ce6381437e9968a6a928a49cd4d1fe09c1cf63648c0fae2bcb4038805",
"block_height": 9578008,
"epoch_no": 450,
"epoch_slot": 17681,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1yc6f3cqsc7jfh07hcns64v5cp8720mve870pgxf2wkr3u8l7tse",
"tx_hash": "5b99ddca8dda03fe9f21be8f36ece2fa22ec97df84d5257f322b948b73e92adb",
"block_hash": "2c15575b2ad41a337e375fed103b11eb8f42c086b7cbba23a126c84f24721554",
"block_height": 9578511,
"epoch_no": 450,
"epoch_slot": 28254,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1m83drqwlugdt9jn7jkz8hx3pne53acfkd539d9cj8yr92dr4k9y",
"tx_hash": "42e10b531d571b9a750425c722e8093e6c447e5c5ba5d1ac9357aea179e597c0",
"block_hash": "272e94bab3c3a15c440e1e1bf9e430ad3d52d6c536bf60f5ba7ac56a16183d89",
"block_height": 9578947,
"epoch_no": 450,
"epoch_slot": 36901,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1cuhcw4dhj577rzz847q5swfvrnthj2vn62hry6ljzp6g6v3ag77",
"tx_hash": "7c49f3d0360a10526c709b4bcddb33f31e1f74b005b5238eaddde2e4021f9630",
"block_hash": "3419666414394246cc24469409acd82f28995fcf3c58f860f7195dbcc1fe266a",
"block_height": 9580008,
"epoch_no": 450,
"epoch_slot": 58006,
"active_epoch_no": 452
},
{
"pool_id_bech32": "pool1l6aeyn35nkqkn9lqqlwqnpraakdzuukjrqprcrj3sctk6hhe32k",
"tx_hash": "d2a105e8c0822cbd22748c4aa18c28dfd0418709a98c316c32eb44c0d9c7e6d4",
"block_hash": "608fb2ebef32d8b10858c726c0a277b627423357eb2f79d739750af80b181131",
"block_height": 9580897,
"epoch_no": 450,
"epoch_slot": 76704,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1uct8k7ruvu3dgl9hws4pj3tk9stzpls4evnys4r8q5vj2p9w92w",
"tx_hash": "27b530a2a786a127277786acf831096b0f1b1f5ae83ce91dfabdb0f7c65b1aa7",
"block_hash": "9552a30577df9acad319e2684b850f74f3f559df137b70efe670822bb1834607",
"block_height": 9581443,
"epoch_no": 450,
"epoch_slot": 88553,
"active_epoch_no": 452
},
{
"pool_id_bech32": "pool1n940lfxkd7z73qzj5y554yrletrmgg5x2eya9tpglh3uwcqfnud",
"tx_hash": "4d389be4801cc2b434913eaec34f21aa1cf531db390c63efa57fe3989cefa70b",
"block_hash": "f1867fe6bcd19fd6b01f25c9b1c976c16d4b5be7ba8b195c8ccb2e80f959c1e7",
"block_height": 9583181,
"epoch_no": 450,
"epoch_slot": 125441,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool13hxlxd6qa68fmfhrvvmasa0mjg30tj9p5v2lmgmgsmrp2rgzkfp",
"tx_hash": "cdf6afa4b2937f3cd66cceedbeb21fddccea4d05502e5081009d5aba3503002b",
"block_hash": "bd4b98742aba98ff82271b3652609ecb85a3ded9320f0f64a66aed436f58ebd9",
"block_height": 9587487,
"epoch_no": 450,
"epoch_slot": 213334,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment",
"tx_hash": "44994b6b060e4e80e16bc698de63379d0097db856184d989cc0795d87ad9b7fe",
"block_hash": "e05cd9b36fb762a58d72d18618b491586afe29360f76740d55ea757a09411795",
"block_height": 9588831,
"epoch_no": 450,
"epoch_slot": 242054,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment",
"tx_hash": "09cb3e784b8ee4173645b1e11fc8bd2d713d7fc1b364c9611eef673be4eae582",
"block_hash": "7aeec2cdc64e5cd1c61c173a84986e50f511637d3fe22822c34212e26f8c6210",
"block_height": 9588884,
"epoch_no": 450,
"epoch_slot": 243186,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment",
"tx_hash": "7aa6b0d94d87783d73176a39238a3cabc62a27df43cd2762c229c51fa602660d",
"block_hash": "42a01085d4f264829f11019bfe3fb670e7e61935dd30b63a5c4ebb7093ee4fd1",
"block_height": 9589567,
"epoch_no": 450,
"epoch_slot": 256996,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool18qahj5ggudguk69g9aaztf5dvapmazql4hdvd7v0947j7gy4wqf",
"tx_hash": "1179715221bc784df721c194602029a6a62085766bbc16db622cbd2d0d974faf",
"block_hash": "eb9cd7d9566d497f6376971ba7c4d95fa428b1be586b66c89c694a0775d7de4c",
"block_height": 9591466,
"epoch_no": 450,
"epoch_slot": 297514,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool15zn2lqq4849ujttuthaycpamnyr8ae9k2pn2fkrlfzzsx4ek0tc",
"tx_hash": "175bf0a069d8e0346218adf9cee275587e7e84a46e9675f6fca38869accd94d4",
"block_hash": "ab68b679dc821c949b93732add66c4971939c24396f1b2399a17932e9b250811",
"block_height": 9591954,
"epoch_no": 450,
"epoch_slot": 308121,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1c2utlagkpht4zj0jetsf245c258geuxnjqp9kf4f2z9rutx9dz4",
"tx_hash": "3be74ebb172cfc2ac41082f3a3c8973f02c6cb9799bf6f67959bd694626747b2",
"block_hash": "1b1166be3f20cd632babf0bd93e4c5a83be0593de0da713d042ee1eddf1ae9ba",
"block_height": 9593244,
"epoch_no": 450,
"epoch_slot": 334101,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool12jnulzs7j8lsku4r2a7q6tee6tt66872vwhqh8jxvgzn6837jtl",
"tx_hash": "016e41bb64e7035476dff7d9dcace3bb6b16ae51e4b3c6da2674be590cd93ac7",
"block_hash": "2c654e3fb4175ae986959511b35523d5a2ff4efb67a13a0ff37a97000f86950c",
"block_height": 9593277,
"epoch_no": 450,
"epoch_slot": 334984,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool18a8vhtlcz7t0mahmfdlgtpsspvae62egz936j3dt7f9ykr4j2av",
"tx_hash": "7f96bfaca34138de9655119b41b3f34c43adbd4718c0a2d54c3616b546a0ffc8",
"block_hash": "0c8e16208e52471e358580e200a9821ef96a44a9bdf93cd8a5e7a958b90388a9",
"block_height": 9593628,
"epoch_no": 450,
"epoch_slot": 342344,
"active_epoch_no": 452
},
{
"pool_id_bech32": "pool1vz59e00250xfjck8qd04kns89j56430wjzpdf37zfjnnyxttm37",
"tx_hash": "75f3103f3f8d403eb304591d798ae3e3f50f06bd666daa821ebc09e9b945d635",
"block_hash": "bc0f759ecd13ca14806186a6a51efc055c62b0cb58133c1dfb0d85ed4133b894",
"block_height": 9593801,
"epoch_no": 450,
"epoch_slot": 345816,
"active_epoch_no": 453
},
{
"pool_id_bech32": "pool1vz59e00250xfjck8qd04kns89j56430wjzpdf37zfjnnyxttm37",
"tx_hash": "d2da61083e80d53d965df6a7cd15ab951668bb1b813ab5b24066b37e9a98540b",
"block_hash": "a98dcc8c557d4e09a41aa2188bd0ea0f25339924c41c408bcdc394b5b2b863a3",
"block_height": 9593950,
"epoch_no": 450,
"epoch_slot": 349251,
"active_epoch_no": 453
}
]
```
#### get_pool_retirements
A list all pool retirements initiated in the requested epoch\
Parameters: Epoch\
Returns: The list of pool retirements\
Example:\
`pool_retirements = get_pool_retirements(450)`\
Example response:
```json
[
{
"pool_id_bech32": "pool1xzfrmeux886ckdm2ekk3t3xe2ch5666m7zxa6dt0zrfm5mq2ksm",
"tx_hash": "5f3bd9d5f64a198536ac02b13e45f24732cca0c818fc10313995763890e5976a",
"block_hash": "aee6a51b81927d692e98e461ab70fe0c3b0474dfaafba50d94031e4359ef2d8a",
"block_height": 9579834,
"epoch_no": 450,
"epoch_slot": 54556,
"active_epoch_no": 451
},
{
"pool_id_bech32": "pool1m7rvxkzc6rseh8axp7ckk7kwlqzctnvqc4lqq5w84sn4g4j4e90",
"tx_hash": "a90f15070843765554f380636101eab57eb41c1055d099d13fd940715081eb04",
"block_hash": "2d0843e1fcb595a98efa7d63db61b9756a474a15d090841b73e0e66d3df20e55",
"block_height": 9584807,
"epoch_no": 450,
"epoch_slot": 158485,
"active_epoch_no": 451
},
{
"pool_id_bech32": "pool1g3wjq2yyg7hxteky9eym8fhc9xdtut63ss46a96gxndhqjgerqv",
"tx_hash": "26cdc11b9fd7412758c8dad42a4b0bd76776fb9d711e3d649a5152441555e8b9",
"block_hash": "aef604b4f652b6e276f206c204e30e38c2c17894f6e5e388b75cbeba5f88e784",
"block_height": 9593197,
"epoch_no": 450,
"epoch_slot": 332983,
"active_epoch_no": 451
}
]
```
#### get_pool_relays
A list of registered relays for all currently registered/retiring
(not retired) pools\
Parameters: none\
Returns: The list of relays dictionaries by stake pool\
Example:\
`pool_relays = get_pool_relays()`\
Example response:
```json
[
{
"pool_id_bech32": "pool100wj94uzf54vup2hdzk0afng4dhjaqggt7j434mtgm8v2gfvfgp",
"relays": [
{
"dns": null,
"srv": null,
"ipv4": "165.232.146.185",
"ipv6": null,
"port": 3000
}
]
},
{
"pool_id_bech32": "pool102s2nqtea2hf5q0s4amj0evysmfnhrn4apyyhd4azcmsclzm96m",
"relays": []
},
...
{
"pool_id_bech32": "pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6",
"relays": [
{
"dns": null,
"srv": null,
"ipv4": "45.13.59.72",
"ipv6": null,
"port": 6000
},
{
"dns": null,
"srv": null,
"ipv4": "45.13.59.73",
"ipv6": null,
"port": 6000
}
]
},
...
]
```
#### get_pool_metadata
A list of registered relays for all currently registered/retiring
(not retired) pools\
Parameters: Stake pool bech32 ID(s) as string (for one stake pool)
or list of stake pool bech32 IDs (for multiple stake pools)\
Returns: The list of pool metadata dictionaries\
Example:\
`pool_metadata = get_pool_metadata('pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6')`\
Example response:
```json
[
{
"pool_id_bech32": "pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6",
"meta_url": "https://git.io/J1yfm",
"meta_hash": "e123e7e59922deab90ff06642500c69cafe03933f0854b1534a829cbae2cf472",
"meta_json": {
"name": "Innovatio",
"ticker": "INNV",
"homepage": "https://www.innovatiofounder.com/",
"description": "Pool focused on the expansion of the Innovatio brand and its financial services and to the support of the community of entrepreneurs and freelancers of the blockchain ecosystem"
}
}
]
```
#### get_retiring_pools
Get the retiring stake pools list\
Parameters: none\
Returns: The list of retiring pools dictionaries\
Example:\
`retiring_pools = get_retiring_pools()`\
Example response:
```json
[
{
"tx_hash": "39a046ef9b5b9e149d24bae8c86f6fb93b08d57312615d22b6a3e73279198e73",
"block_time": 1667610905,
"pool_id_bech32": "pool1a8z4kxgsul7u4nedkxlx7g86mlcwt45dv4ntygmfsqc6kdse5c7",
"pool_id_hex": "e9c55b1910e7fdcacf2db1be6f20fadff0e5d68d6566b223698031ab",
"active_epoch_no": 375,
"vrf_key_hash": "8ad95d9965ca817e7d7d5d6985ba4c92b77a206250fa59f52acb6ab36507c79b",
"margin": 0,
"fixed_cost": "340000000",
"pledge": "2000000",
"reward_addr": "stake1uyyyeu9dl8l8tvly08nvsdm8dwu9q94w3ywxyn84jqz2qzgm6a42u",
"owners": [
"stake1uyyyeu9dl8l8tvly08nvsdm8dwu9q94w3ywxyn84jqz2qzgm6a42u"
],
"relays": [
{
"dns": null,
"srv": null,
"ipv4": "158.140.192.143",
"ipv6": null,
"port": 3001
}
],
"meta_url": "https://raw.githubusercontent.com/etsraphael/Cardano/p/p.json",
"meta_hash": "dee0758d3212808f99698e96446dd9400b4455d5c44286f91f66dd6c5796d064",
"meta_json": null,
"pool_status": "retiring",
"retiring_epoch": 391
},
{
"tx_hash": "e91b2fe2fdd88af555ff28a4e9bc0c2cd0d7d403f84bf76095ddef9696960222",
"block_time": 1623852340,
"pool_id_bech32": "pool14y230zspjkhezehue4p2d9q87xh3p8a0vnpugzdty7gwcruepps",
"pool_id_hex": "a915178a0195af9166fccd42a69407f1af109faf64c3c409ab2790ec",
"active_epoch_no": 275,
"vrf_key_hash": "fc9af9335415593f9c4f171aded1fd80cb69a0e1e663a978572ace376f0a4f11",
"margin": 0,
"fixed_cost": "340000000",
"pledge": "12000000000",
"reward_addr": "stake1uyam20k8v2azz38r2jf499udyru7qfs4flaefc05h9546cqjmjnmr",
"owners": [
"stake1uyam20k8v2azz38r2jf499udyru7qfs4flaefc05h9546cqjmjnmr"
],
"relays": [
{
"dns": "relay1.faststakepool.com",
"srv": null,
"ipv4": null,
"ipv6": null,
"port": 3000
}
],
"meta_url": "https://raw.githubusercontent.com/FASTstakepool/meta/master/data",
"meta_hash": "64bdb12028955b248b2d61467aedba30388a95d175636b3b042e9c69aa710dd4",
"meta_json": null,
"pool_status": "retiring",
"retiring_epoch": 392
},
...
```
### Script
#### get_script_info
List of script information for given script hashes\
Parameters: Script hash(es) as string (for one script hash) or list
(for a list of script hashes)\
Returns The list of information for the requested scripts\
Example:\
`script_info = get_script_info('2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9')`\
Example response:
```json
[
{
"script_hash": "2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9",
"creation_tx_hash": "2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28",
"type": "plutusV2",
"value": null,
"bytes": "5906ce010000...4980101010001",
"size": 1745
}
]
```
#### get_native_script_list
List of all existing native script hashes along with their creation
transaction hashes\
Parameters: none\
Returns: The list of all native scripts dictionaries\
Example:\
`native_script_list = get_native_script_list()`\
Example response:
```json
[
{
"script_hash": "65c197d565e88a20885e535f93755682444d3c02fd44dd70883fe89e",
"creation_tx_hash": "4a3f86762383f1d228542d383ae7ac89cf75cf7ff84dec8148558ea92b0b92d0",
"type": "timelock",
"script": {
"type": "all",
"scripts": [
{
"type": "sig",
"keyHash": "a96da581c39549aeda81f539ac3940ac0cb53657e774ca7e68f15ed9"
},
{
"type": "sig",
"keyHash": "ccfcb3fed004562be1354c837a4a4b9f4b1c2b6705229efeedd12d4d"
},
{
"type": "sig",
"keyHash": "74fcd61aecebe36aa6b6cd4314027282fa4b41c3ce8af17d9b77d0d1"
}
]
}
},
{
"script_hash": "00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae",
"creation_tx_hash": "e252be4c7e40d35919f741c9649ff207c3e49d53bb819e5c1cb458055fd363ed",
"type": "timelock",
"script": {
"type": "all",
"scripts": [
{
"slot": 24285375,
"type": "before"
},
{
"type": "sig",
"keyHash": "e97316c52c85eab276fd40feacf78bc5eff74e225e744567140070c3"
}
]
}
},
...
]
```
#### get_plutus_script_list
List of all existing native script hashes along with their creation
transaction hashes\
Parameters: none\
Returns: The list of all plutus scripts dictionaries\
Example:\
`plutus_script_list = get_plutus_script_list()`\
Example response:
```json
[
{
"script_hash": "c916b3d14a51087cc967223aad3f2e4e5c01993f5429719c32c2061e",
"creation_tx_hash": "ed96d6ee90c6e8e5828b0b4f5fbdcbefc28d8b7e689ac4605da56c9c58a7cd96"
},
{
"script_hash": "c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261",
"creation_tx_hash": "fa36280a65610f0171bcfdb3812bc0f0f6312c08cfb39c3419287bc1d654a4ae"
},
{
"script_hash": "2161af28e544066081a36a85857f8894910984ea50f5a7a1d7a345e2",
"creation_tx_hash": "21aabf5a3f1b9162ea12d49c94c110a89c5702f0ebdb3390b40110b22a750326"
},
...
]
```
#### get_script_redeemers
List of all redeemers for a given script hash\
Parameters: Script hash\
Returns: Redeemers list as dictionary\
Example:\
`script_redeemers = get_script_redeemers('c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261')`\
Example response:
```json
[
{
"script_hash": "c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261",
"redeemers": [
{
"tx_hash": "fa36280a65610f0171bcfdb3812bc0f0f6312c08cfb39c3419287bc1d654a4ae",
"tx_index": 0,
"unit_mem": 1197950,
"unit_steps": 491845099,
"fee": "104584",
"purpose": "mint",
"datum_hash": "45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0",
"datum_value": {
"list": []
}
}
]
}
]
```
#### get_script_utxos
List of all UTxOs for a given script hash\
Parameters:\
Script hash: The script hash\
Extended: Boolean which controls whether certain optional fields supported\
by a given endpoint are populated as a part of the request\
Returns: The list of UTxOs for a given script hash\
Example:\
`script_utxos = get_script_utxos('2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9')`\
Example response:
```json
[
{
"tx_hash": "2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28",
"tx_index": 0,
"address": "addr1zy7z86jxa4dyflaf3rwpt5jlnrdahkt2r4737khf7huv9q5nc4gwrvu5dcuccayqddwpx0l492czzxp7929792qv4grqnc0lf0",
"value": "200000000",
"stake_address": "stake1uxfu258pkw2xuwvvwjqxkhqn8l6j4vpprqlz4zlz4qx25ps4mt0qn",
"payment_cred": "3c23ea46ed5a44ffa988dc15d25f98dbdbd96a1d7d1f5ae9f5f8c282",
"epoch_no": 449,
"block_height": 9564735,
"block_time": 1700347692,
"datum_hash": "51fa1feba19dd159a13098a686ad8eb7c273012fc4f64497d474cc322d3578cf",
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": false
},
{
"tx_hash": "2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28",
"tx_index": 2,
"address": "addr1qxxedmtge6np74z5nd9hu72fak9zntc6zu2434u82pnvjmcr378a5cgtgsn6ktj22vew8z9rtrxddfkrh574q28kek0qrtfjqq",
"value": "263206568",
"stake_address": "stake1uypclr76vy95gfat9e99xvhr3z343nxk5mpm602s9rmvm8synpexp",
"payment_cred": "8d96ed68cea61f54549b4b7e7949ed8a29af1a171558d7875066c96f",
"epoch_no": 449,
"block_height": 9564735,
"block_time": 1700347692,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": true
},
{
"tx_hash": "2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28",
"tx_index": 1,
"address": "addr1qxxedmtge6np74z5nd9hu72fak9zntc6zu2434u82pnvjmcr378a5cgtgsn6ktj22vew8z9rtrxddfkrh574q28kek0qrtfjqq",
"value": "1262830",
"stake_address": "stake1uypclr76vy95gfat9e99xvhr3z343nxk5mpm602s9rmvm8synpexp",
"payment_cred": "8d96ed68cea61f54549b4b7e7949ed8a29af1a171558d7875066c96f",
"epoch_no": 449,
"block_height": 9564735,
"block_time": 1700347692,
"datum_hash": null,
"inline_datum": null,
"reference_script": null,
"asset_list": null,
"is_spent": true
}
]
```
#### get_datum_info
List of datum information for given datum hashes\
Parameters: Datum hash(es) as string (for one datum hash) or list
(for a list of datum hashes)\
Returns Datum information as list of dictionaries\
Example:\
`datum_info = get_datum_info('45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0')`\
Example response:
```json
[
{
"hash": "45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0",
"value": {
"list": []
},
"bytes": "80"
}
]
```
### Ogmios
#### ogmios
Multiple ogmios queries are supported, you can read about them\
[here](https://api.koios.rest/#tag--Ogmios).
Query Examples
Query the current tip of the Network\
Example:\
`tip = get_ogmios("2.0", "queryNetwork/tip")`\
Example response:
```json
{
"jsonrpc": "2.0",
"method": "queryNetwork/tip",
"result": {
"slot": 109429505,
"id": "d7d8b03d8f2def0b2239f17374900e281bbe548fbaaa45b014baac8c8a1bd48b"
},
"id": null
}
```
Query the current block height\
Example:\
`block_height = get_ogmios("2.0", "queryNetwork/blockHeight")`\
Example response:\
```json
{
"jsonrpc": "2.0",
"method": "queryNetwork/blockHeight",
"result": 9596049,
"id": null
}
```
Raw data
{
"_id": null,
"home_page": "",
"name": "koios-api",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "koios,cardano,blockchain,REST,API",
"author": "",
"author_email": "APEX Stake Pool <cardanoapexpool@gmail.com>",
"download_url": "",
"platform": null,
"description": "\n# koios-api-python\n\nA python package for the Cardano Blockchain [Koios API](https://api.koios.rest/).\n\n## Install\n\nTo install the module, type the following command:\n\n```bash\npip3 install koios_api\n```\n\n## Environment\n\nBy default, koios_api works with mainnet, but it can also work with the preview\nand preprod testnets, and even with custom Api URLs (because anyone can install\nan own Koios Api). To use a testnet you can set the environment variable:\n\n```bash\n#preprod\nexport CARDANO_NET=preprod\n```\n\n```bash\n#preview\nexport CARDANO_NET=preview\n```\n\nTo work with a custom Api URL, set the environment variable:\n\n```bash\nexport API_BASE_URL=https://custom.url/api/v1\n```\n\nBy default, the requests are unauthenticated (public tier),\nand there is a low limit of requests you can make. In order to increase the\nnumber of requests, you can authenticate using an API Token that you can obtain\nfrom the [pricing](https://koios.rest/pricing/Pricing.html) page after\nconnecting your wallet and signing a message to prove the ownership on the\nwallet. There is also a free tier with 10x more requests than the public tier.\nYou need to set the API Token in the KOIOS_API_TOKEN environment variable\nin order to use it, otherwise the public tier is used.\n\n```bash\nexport KOIOS_API_TOKEN=\"your Koios API Token here\"\n```\n\nOther environment variables that can be set, and their default versions, are:\n\n```bash\nSLEEP_TIME=1\nAPI_RESP_COUNT=1000\nREQUEST_TIMEOUT=60\n```\n\nSLEEP_TIME is the time between retries after an API errors. API_RESP_COUNT\nis the maximum number of records the API should return (1000 is the absolute\nmaximum supported by the Koios API). REQUEST_TIMEOUT is the timeout for get\nand post requests to the Koios API.\n\n## Using the module\n\nImporting the complete module:\n\n```python\nimport koios_api\nkoios_api.get_tip()\n```\n\nThe result will be like this:\n\n```json\n[\n {\n \"hash\": \"442765ab5660346a6af3ba7667bbd35934e6219a52f0f53a80f28d27a70309c1\",\n \"epoch_no\": 381,\n \"abs_slot\": 79265882,\n \"epoch_slot\": 37082,\n \"block_no\": 8129347,\n \"block_time\": 1670832173\n }\n]\n```\n\nImport only specific functions:\n\n```python\nfrom koios_api.network import get_tip\nget_tip()\n```\n\nThe result will be identical.\n\n## Modules\n\n[Network](#Network)\\\n[get_tip](#get_tip) Get the tip info about the latest block seen by chain\\\n[get_genesis](#get_genesis) Get the Genesis parameters used to start specific\\\nera on chain\\\n[get_totals](#get_totals) Get the circulating utxo, treasury, rewards, supply\nand reserves in lovelace for specified epoch, all epochs if empty\\\n[get_param_updates](#get_param_updates) Get all parameter update proposals\nsubmitted to the chain starting Shelley era\\\n[get_reserve_withdrawals](#get_reserve_withdrawals) List of all withdrawals\nfrom reserves against stake accounts\\\n[get_treasury_withdrawals](#get_treasury_withdrawals) List of all withdrawals\nfrom treasury against stake accounts\n\n[Epoch](#Epoch)\\\n[get_epoch_info](#get_epoch_info) Get the epoch information, all epochs\nif no epoch specified\\\n[get_epoch_params](#get_epoch_params) Get the protocol parameters for\nspecific epoch, returns information about all epochs if no epoch specified\\\n[get_epoch_block_protocols](#get_epoch_block_protocols) Get the information\nabout block protocol distribution in epoch\n\n[Block](#Block)\\\n[get_blocks](#get_blocks) Get summarised details about all blocks (paginated,\nthe latest first)\\\n[get_block_info](#get_block_info) Get detailed information about a specific\nblock\\\n[get_block_txs](#get_block_txs) Get a list of all transactions included in\nprovided blocks\n\n[Transactions](#Transactions)\\\n[get_utxo_info](#get_utxo_info) Get UTxO set for requested UTxO references\\\n[get_tx_info](#get_tx_info) Get detailed information about transaction(s)\\\n[get_tx_metadata](#get_tx_metadata) Get metadata information (if any)\nfor given transaction(s)\\\n[get_tx_metalabels](#get_tx_metalabels) Get a list of all transaction\nmetadata labels\\\n[submit_tx](#submit_tx) Submit an already serialized transaction\nto the network\\\n[get_tx_status](#get_tx_status) Get the number of block confirmations\nfor a given transaction hash list\\\n\n[Stake Account](#Stake_Account)\\\n[get_account_list](#get_account_list) Get a list of all accounts\\\n[get_account_info](#get_account_info) Get the account information for\ngiven stake addresses (accounts)\\\n[get_account_info_cached](#get_account_info_cached) Get the cached account\ninformation for given stake addresses (accounts)\\\n[get_account_utxos](#get_account_utxos) Get a list of all Txs for a\ngiven stake address (account)\\\n[get_account_txs](#get_account_txs) Get a list of all UTxOs for a\ngiven stake address (account)\\\n[get_account_rewards](#get_account_rewards) Get the full rewards history\n(including MIR) for given stake addresses (accounts)\\\n[get_account_updates](#get_account_updates) Get the account updates\n(registration, deregistration, delegation and withdrawals) for\ngiven stake addresses (accounts)\\\n[get_account_addresses](#get_account_addresses) Get all addresses associated\nwith given staking accounts\\\n[get_account_assets](#get_account_assets) Get the native asset balance of\ngiven accounts\\\n[get_account_history](#get_account_history) Get the staking history of\ngiven stake addresses (accounts)\n\n[Address](#Address)\\\n[get_address_info](#get_address_info) Get the transaction hash list of input\naddress array, optionally filtering after specified block height (inclusive)\\\n[get_address_utxos](#get_address_utxos) Get UTxO set for given addresses\\\n[get_credential_utxos](#get_credential_utxos) Get a list of UTxO against input\npayment credential array including their balances\\\n[get_address_txs](#get_address_txs) Get the transaction hash list of input\naddress array, optionally filtering after specified block height (inclusive)\\\n[get_credential_txs](#get_credential_txs) Get the transaction hash list\nof input payment credential array, optionally filtering after specified block\nheight (inclusive)\\\n[get_address_assets](#get_address_assets) Get the list of all the assets\n(policy, name and quantity) for given addresses\n\n[Asset](#Asset)\\\n[get_asset_list](#get_asset_list) Get the list of all native assets\n(paginated)\\\n[get_policy_asset_list](#get_policy_asset_list) Get the list of asset under\nthe given policy (including balances)\\\n[get_asset_token_registry](#get_asset_token_registry) Get a list of assets\nregistered via token registry on github\\\n[get_asset_info](#get_asset_info) Get the information of a list of assets\nincluding first minting & token registry metadata\\\n[get_asset_utxos](#get_asset_utxos) Get the UTXO information of a list of\nassets\\\n[get_asset_history](#get_asset_history) Get the mint/burn history\nof an asset\\\n[get_asset_addresses](#get_asset_addresses) Get the list of all addresses\nholding a given asset\\\n[get_asset_nft_address](#get_asset_nft_address) Get the address where specified\nNFT currently reside on.\\\n[get_policy_asset_addresses](#get_policy_asset_addresses) Get the list of\naddresses with quantity for each asset on the given policy\\\n[get_policy_asset_info](#get_policy_asset_info) Get the information for\nall assets under the same policy\\\n[get_asset_summary](#get_asset_summary) Get the summary of an asset\n(total transactions exclude minting/total wallets include only wallets\nwith asset balance)\\\n[get_asset_txs](#get_asset_txs) Get the list of all asset transaction\nhashes (the newest first)\\\n\n[Pool](#Pool)\\\n[get_pool_list](#get_pool_list) A list of all currently registered/retiring\n(not retired) pools\\\n[get_pool_info](#get_pool_info) Current pool statuses and details for\na specified list of pool ids\\\n[get_pool_stake_snapshot](#get_pool_stake_snapshot) Returns Mark, Set and Go\nstake snapshots for the selected pool, useful for leaderlog calculation\\\n[get_pool_delegators](#get_pool_delegators) Returns information about live\ndelegators for a given pool\\\n[get_pool_delegators_history](#get_pool_delegators_history) Returns information\nabout active delegators (incl. history) for a given pool and epoch number\n(all epochs if not specified)\\\n[get_pool_blocks](#get_pool_blocks) Returns information about blocks minted\nby a given pool for all epochs (or _epoch_no if provided)\\\n[get_pool_history](#get_pool_history) Returns information about pool stake,\nblock and reward history in a given epoch (or all epochs that pool existed for,\nin descending order if no epoch number was provided)\\\n[get_pool_updates](#get_pool_updates) Returns all pool updates for all pools\nor only updates for specific pool if specified\\\n[get_pool_registrations](#get_pool_registrations) Return all pool registrations\ninitiated in the requested epoch\\\n[get_pool_retirements](#get_pool_retirements) Return all pool retirements\ninitiated in the requested epoch\\\n[get_pool_relays](#get_pool_relays) A list of registered relays for all\ncurrently registered/retiring (not retired) pools\\\n[get_pool_metadata](#get_pool_metadata) A list of registered relays for all\ncurrently registered/retiring (not retired) pools\\\n[get_retiring_pools](#get_retiring_pools) Get the retiring stake pools list\n\n[Script](#Script)\\\n[get_script_info](#get_script_info) List of script information for given\nscript hashes\\\n[get_native_script_list](#get_native_script_list) The list of all existing\nnative script hashes along with their creation transaction hashes\\\n[get_plutus_script_list](#get_plutus_script_list) The list of all existing\nnative script hashes along with their creation transaction hashes\\\n[get_script_redeemers](#get_script_redeemers) The list of all redeemers\nfor a given script hash\\\n[get_script_utxos](#get_script_utxos) List of all UTXOs for a given script hash\\\n[get_datum_info](#get_datum_info) The list of datum information for\ngiven datum hashes\n\n### Stake_Account\n\n#### get_account_list\n\nGet a list of all accounts\\\nParameters:\\\nThe offset (optional) to start from, default 0\\\nThe maximum number of accounts to return (optional), default 0 (no limit)\\\nReturns: The list of accounts dictionaries\\\nThis takes a very long time to execute (about one hour), because the total\nnumber of accounts is in the millions range.\\\nExample:\\\n`account_list = get_account_list()`\\\nExample response:\n\n```json\n[\n {\n \"id\": \"stake1uyfmzu5qqy70a8kq4c8rw09q0w0ktfcxppwujejnsh6tyrg5c774g\"\n },\n {\n \"id\": \"stake1uydhlh7f2kkw9eazct5zyzlrvj32gjnkmt2v5qf6t8rut4qwch8ey\"\n },\n {\n \"id\": \"stake1uxsgkz6fvgws5wn80vckwvghzapnhfmf0672nmmkm2tt9fcaau5sw\"\n },\n ...\n]\n```\n\n#### get_account_info\n\nGet the account information for given stake addresses (accounts)\\\nParameters: Stake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nReturns: The list of account information dictionaries\\\nExample:\\\n`account_info = get_account_info('stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"status\": \"registered\",\n \"delegated_pool\": \"pool18r2y72aue5nmv489xtnfxl36vzusq95qst6urd87yd5hgzms04c\",\n \"total_balance\": \"20418617\",\n \"utxo\": \"20418617\",\n \"rewards\": \"0\",\n \"withdrawals\": \"0\",\n \"rewards_available\": \"0\",\n \"reserves\": \"0\",\n \"treasury\": \"0\"\n }\n]\n```\n\n#### get_account_info_cached\n\nGet the cached account information for given stake addresses (accounts)\\\nParameters: Stake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nReturns: The list of account information dictionaries\\\nExample:\\\n`account_info_cached = get_account_info_cached('stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"status\": \"registered\",\n \"delegated_pool\": \"pool18r2y72aue5nmv489xtnfxl36vzusq95qst6urd87yd5hgzms04c\",\n \"total_balance\": \"20418617\",\n \"utxo\": \"20418617\",\n \"rewards\": \"0\",\n \"withdrawals\": \"0\",\n \"rewards_available\": \"0\",\n \"reserves\": \"0\",\n \"treasury\": \"0\"\n }\n]\n```\n\n#### get_account_utxos\n\nGet a list of all UTxOs for given stake addresses (account)s\\\nParameters: Stake address\\\nReturns: The list of all UTxOs at all payment addresses associated with\nthe stake address\\\nExample:\\\n`account_utxos = get_account_utxos('stake1ux5r7myfhycj234wpqyhh3h8skgwvq0hsstpw52f66857uq95cas6')`\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"215bcaa7b13c491db28d5525d9b2a13a7d8ddabd563da8113a449ab33a6a60be\",\n \"tx_index\": 2,\n \"address\": \"addr1q9dwzug2qzdsqvpvrn886nqdtwr02n9kxtwqsxce2gacvedg8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqeuerev\",\n \"value\": \"85813474\",\n \"block_height\": 8214437,\n \"block_time\": 1672580966\n },\n {\n \"tx_hash\": \"1eb26dce2f471fbe32aa8cb303f5e8d8078d1da4dbbb78a7bc135036bb3f2f9c\",\n \"tx_index\": 0,\n \"address\": \"addr1q88u9gz83nhs9p5pud9kyucx8sg0ygae2p9a4g2p2y55c4ag8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqqyd2n7\",\n \"value\": \"110094569\",\n \"block_height\": 8406870,\n \"block_time\": 1676555396\n },\n {\n \"tx_hash\": \"d530de851c2f867f2174c1073b04bdb9f2e2d16029fcfb488e8150ba66976d43\",\n \"tx_index\": 0,\n \"address\": \"addr1qxyp2wsafavj47dpc6uqgqx8se3969jn4crfk7y4zwd7vfag8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqlyvudm\",\n \"value\": \"1249900\",\n \"block_height\": 8489290,\n \"block_time\": 1678248733\n },\n ...\n {\n \"tx_hash\": \"d8e3ca8b36f9a785ff33f01aa5460f9248ea94acd621ea187093206b04aa6e30\",\n \"tx_index\": 0,\n \"address\": \"addr1q8txa88kt6rpdv3zzn8ghx7u4udf6rpj690rfdvlqn35fldg8akgnwf3y4r2uzqf00rw0pvsucql0pqkzag5n450facqplx97u\",\n \"value\": \"54000000\",\n \"block_height\": 8759577,\n \"block_time\": 1683809438\n }\n]\n```\n\n#### get_account_txs\n\nGet a list of all Txs for a given stake address (account)\\\nParameters: Stake address\\\nReturns: The list of all transaction hashes for all payment addresses associated with\nthe stake address\\\nExample:\\\n`account_txs = get_account_txs('stake1uyrx65wjqjgeeksd8hptmcgl5jfyrqkfq0xe8xlp367kphsckq250')`\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"5e209eee15637645198ddf22f84f905d50b6103661da98597eb6da0ef7245fa1\",\n \"epoch_no\": 251,\n \"block_height\": 5427308,\n \"block_time\": 1615051845\n },\n {\n \"tx_hash\": \"a6981b394e5cf9b801d2c81b81b5aecaf556abd8eca5a00067e2d53c2f6eebab\",\n \"epoch_no\": 251,\n \"block_height\": 5427334,\n \"block_time\": 1615052248\n },\n {\n \"tx_hash\": \"e9504ad3c28120abb0fab3504f09a4f9f203c62159a53d74eb8e206fda2cd4b5\",\n \"epoch_no\": 252,\n \"block_height\": 5431176,\n \"block_time\": 1615130928\n },\n {\n \"tx_hash\": \"7605d6442d46bb2de29f251f893b8ddccd424ad107240e787dda0bfcb552713c\",\n \"epoch_no\": 252,\n \"block_height\": 5433510,\n \"block_time\": 1615179291\n },\n {\n \"tx_hash\": \"645ed2e34370b0d8c1385c07d3a85b337ef6982e2686528c4b90ecaef6b3c35b\",\n \"epoch_no\": 252,\n \"block_height\": 5436849,\n \"block_time\": 1615247429\n },\n ...\n]\n```\n\n#### get_account_rewards\n\nGet the full rewards history (including MIR) for given stake addresses\n(accounts)\\\nParameters:\\\nStake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nEpoch (optional), default: current epoch\\\nReturns: The list of rewards dictionaries by account (stake address)\\\nExample:\\\n`account_rewards = get_account_rewards('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z\",\n \"rewards\": [\n {\n \"earned_epoch\": 233,\n \"spendable_epoch\": 235,\n \"amount\": \"3990414\",\n \"type\": \"member\",\n \"pool_id\": \"pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy\"\n },\n {\n \"earned_epoch\": 234,\n \"spendable_epoch\": 236,\n \"amount\": \"2792902\",\n \"type\": \"member\",\n \"pool_id\": \"pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy\"\n },\n ...\n {\n \"earned_epoch\": 379,\n \"spendable_epoch\": 381,\n \"amount\": \"6496870\",\n \"type\": \"member\",\n \"pool_id\": \"pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd\"\n }\n ]\n }\n]\n```\n\n#### get_account_updates\n\nGet the account updates (registration, deregistration, delegation and\nwithdrawals) for given stake addresses (accounts)\\\nParameters: Stake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nReturns: The list of account updates dictionaries by account (stake address)\\\nExample:\\\n`account_updates = get_account_updates('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z\",\n \"updates\": [\n {\n \"action_type\": \"withdrawal\",\n \"tx_hash\": \"487bc75f00fe934dad33683271cca8540fe868eef7025962678f179a1a111ecc\",\n \"epoch_no\": 324,\n \"epoch_slot\": 70687,\n \"absolute_slot\": 54675487,\n \"block_time\": 1646241778\n },\n {\n \"action_type\": \"withdrawal\",\n \"tx_hash\": \"eb3ffa01f434e210716151fd9001af82529e371a91c20af02512942f988a2119\",\n \"epoch_no\": 269,\n \"epoch_slot\": 339679,\n \"absolute_slot\": 31184479,\n \"block_time\": 1622750770\n },\n ...\n {\n \"action_type\": \"withdrawal\",\n \"tx_hash\": \"b056dcbff9b908e1bd3ed015466f64486538058ba3553dbf885b216d88343370\",\n \"epoch_no\": 252,\n \"epoch_slot\": 58375,\n \"absolute_slot\": 23559175,\n \"block_time\": 1615125466\n }\n ]\n }\n]\n```\n\n#### get_account_addresses\n\nGet all addresses associated with given staking accounts\\\nParameters: \\\nStake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nFirst Only boolean (optional): Only return the first result (default False)\\\nEmpty boolean (optional): Include zero quantity entries (default True)\\\nReturns: The list of addresses dictionaries by account (stake address)\\\nExample:\\\n`account_addresses = get_account_addresses('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z\",\n \"addresses\": [\n \"addr1qxwjxvzv8rmyutcjp0647w4n05wv7aez9jdmqcxn8a9sshll0qre4udr9ny9sj8020uxher08k44ssl9pxlk3w5f4x2qjyz9yf\"\n ]\n }\n]\n```\n\n#### get_account_assets\n\nGet the native asset balance of given accounts\\\nParameters: Stake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nReturns: The list of account assets dictionaries by account (stake address)\\\nExample:\\\n`account_assets = get_account_assets('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z\",\n \"asset_list\": [\n {\n \"policy_id\": \"0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913\",\n \"asset_name\": \"6c70202302\",\n \"fingerprint\": \"asset1awuysx8hc686uz0dykmvmc7jfut2ulceucf6yc\",\n \"quantity\": \"418089787\"\n },\n {\n \"policy_id\": \"0029cb7c88c7567b63d1a512c0ed626aa169688ec980730c0473b913\",\n \"asset_name\": \"6c7020f302\",\n \"fingerprint\": \"asset1mcq0awl6awlaqg0ywukf94q0mnau263l9rght5\",\n \"quantity\": \"586811406\"\n },\n ...\n {\n \"policy_id\": \"ea2d23f1fa631b414252824c153f2d6ba833506477a929770a4dd9c2\",\n \"asset_name\": \"4d414442554c\",\n \"fingerprint\": \"asset1q0kwjy669gmsqpvxp4lr0sp26pdm0dafme3qp2\",\n \"quantity\": \"500\"\n }\n ]\n }\n]\n```\n\n#### get_account_history\n\nGet the staking history of given stake addresses (accounts)\\\nParameters: Stake address(es), as a string (for one address) or a list\n(for multiple addresses)\\\nReturns: The list of staking history dictionaries by account (stake address)\\\nExample:\\\n`account_history = get_account_history('stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u8lhspu67x3jejzcfrh487rtu3hnm26cg0jsn0mgh2y6n9q9ve26z\",\n \"history\": [\n {\n \"pool_id\": \"pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy\",\n \"epoch_no\": 233,\n \"active_stake\": \"4655706122\"\n },\n {\n \"pool_id\": \"pool1jdhjfcu34lq88rypdtslzwyf27uh0h3apcr9mjd68zhc69r29fy\",\n \"epoch_no\": 234,\n \"active_stake\": \"5020706122\"\n },\n ...\n {\n \"pool_id\": \"pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd\",\n \"epoch_no\": 381,\n \"active_stake\": \"10247851319\"\n }\n ]\n }\n]\n```\n\n### Network\n\n#### get_tip\n\nGet the tip info about the latest block seen by chain\\\nParameters: none\\\nReturns: The tip information as a list of one dictionary\\\nExample:\\\n`tip = get_tip()`\\\nExample response:\n\n```json\n[\n {\n \"hash\": \"442765ab5660346a6af3ba7667bbd35934e6219a52f0f53a80f28d27a70309c1\",\n \"epoch_no\": 381,\n \"abs_slot\": 79265882,\n \"epoch_slot\": 37082,\n \"block_no\": 8129347,\n \"block_time\": 1670832173\n }\n]\n```\n\n#### get_genesis\n\nGet the Genesis parameters used to start specific era on chain\\\nParameters: none\\\nReturns: Genesis parameters used to start each era on chain as a list of\none dictionary\\\nExample:\\\n`genesis = get_genesis()`\\\nExample response:\n\n```json\n[\n {\n \"networkmagic\": \"764824073\",\n \"networkid\": \"Mainnet\",\n \"activeslotcoeff\": \"0.05\",\n \"updatequorum\": \"5\",\n \"maxlovelacesupply\": \"45000000000000000\",\n \"epochlength\": \"432000\",\n \"systemstart\": 1506203091,\n \"slotsperkesperiod\": \"129600\",\n \"slotlength\": \"1\",\n \"maxkesrevolutions\": \"62\",\n \"securityparam\": \"2160\",\n \"alonzogenesis\": \"{\\\"lovelacePerUTxOWord\\\":34482,\\\"executionPrices\\\":{\\\"prSteps\\\":{\\\"numerator\\\":721,\\\"denominator\\\":10000000},\\\"prMem\\\":{\\\"numerator\\\":577,\\\"denominator\\\":10000}},\\\"maxTxExUnits\\\":{\\\"exUnitsMem\\\":10000000,\\\"exUnitsSteps\\\":10000000000},\\\"maxBlockExUnits\\\":{\\\"exUnitsMem\\\":50000000,\\\"exUnitsSteps\\\":40000000000},\\\"maxValueSize\\\":5000,\\\"collateralPercentage\\\":150,\\\"maxCollateralInputs\\\":3,\\\"costModels\\\":{\\\"PlutusV1\\\":{\\\"sha2_256-memory-arguments\\\":4,\\\"equalsString-cpu-arguments-constant\\\":1000,\\\"cekDelayCost-exBudgetMemory\\\":100,\\\"lessThanEqualsByteString-cpu-arguments-intercept\\\":103599,\\\"divideInteger-memory-arguments-minimum\\\":1,\\\"appendByteString-cpu-arguments-slope\\\":621,\\\"blake2b-cpu-arguments-slope\\\":29175,\\\"iData-cpu-arguments\\\":150000,\\\"encodeUtf8-cpu-arguments-slope\\\":1000,\\\"unBData-cpu-arguments\\\":150000,\\\"multiplyInteger-cpu-arguments-intercept\\\":61516,\\\"cekConstCost-exBudgetMemory\\\":100,\\\"nullList-cpu-arguments\\\":150000,\\\"equalsString-cpu-arguments-intercept\\\":150000,\\\"trace-cpu-arguments\\\":150000,\\\"mkNilData-memory-arguments\\\":32,\\\"lengthOfByteString-cpu-arguments\\\":150000,\\\"cekBuiltinCost-exBudgetCPU\\\":29773,\\\"bData-cpu-arguments\\\":150000,\\\"subtractInteger-cpu-arguments-slope\\\":0,\\\"unIData-cpu-arguments\\\":150000,\\\"consByteString-memory-arguments-intercept\\\":0,\\\"divideInteger-memory-arguments-slope\\\":1,\\\"divideInteger-cpu-arguments-model-arguments-slope\\\":118,\\\"listData-cpu-arguments\\\":150000,\\\"headList-cpu-arguments\\\":150000,\\\"chooseData-memory-arguments\\\":32,\\\"equalsInteger-cpu-arguments-intercept\\\":136542,\\\"sha3_256-cpu-arguments-slope\\\":82363,\\\"sliceByteString-cpu-arguments-slope\\\":5000,\\\"unMapData-cpu-arguments\\\":150000,\\\"lessThanInteger-cpu-arguments-intercept\\\":179690,\\\"mkCons-cpu-arguments\\\":150000,\\\"appendString-memory-arguments-intercept\\\":0,\\\"modInteger-cpu-arguments-model-arguments-slope\\\":118,\\\"ifThenElse-cpu-arguments\\\":1,\\\"mkNilPairData-cpu-arguments\\\":150000,\\\"lessThanEqualsInteger-cpu-arguments-intercept\\\":145276,\\\"addInteger-memory-arguments-slope\\\":1,\\\"chooseList-memory-arguments\\\":32,\\\"constrData-memory-arguments\\\":32,\\\"decodeUtf8-cpu-arguments-intercept\\\":150000,\\\"equalsData-memory-arguments\\\":1,\\\"subtractInteger-memory-arguments-slope\\\":1,\\\"appendByteString-memory-arguments-intercept\\\":0,\\\"lengthOfByteString-memory-arguments\\\":4,\\\"headList-memory-arguments\\\":32,\\\"listData-memory-arguments\\\":32,\\\"consByteString-cpu-arguments-intercept\\\":150000,\\\"unIData-memory-arguments\\\":32,\\\"remainderInteger-memory-arguments-minimum\\\":1,\\\"bData-memory-arguments\\\":32,\\\"lessThanByteString-cpu-arguments-slope\\\":248,\\\"encodeUtf8-memory-arguments-intercept\\\":0,\\\"cekStartupCost-exBudgetCPU\\\":100,\\\"multiplyInteger-memory-arguments-intercept\\\":0,\\\"unListData-memory-arguments\\\":32,\\\"remainderInteger-cpu-arguments-model-arguments-slope\\\":118,\\\"cekVarCost-exBudgetCPU\\\":29773,\\\"remainderInteger-memory-arguments-slope\\\":1,\\\"cekForceCost-exBudgetCPU\\\":29773,\\\"sha2_256-cpu-arguments-slope\\\":29175,\\\"equalsInteger-memory-arguments\\\":1,\\\"indexByteString-memory-arguments\\\":1,\\\"addInteger-memory-arguments-intercept\\\":1,\\\"chooseUnit-cpu-arguments\\\":150000,\\\"sndPair-cpu-arguments\\\":150000,\\\"cekLamCost-exBudgetCPU\\\":29773,\\\"fstPair-cpu-arguments\\\":150000,\\\"quotientInteger-memory-arguments-minimum\\\":1,\\\"decodeUtf8-cpu-arguments-slope\\\":1000,\\\"lessThanInteger-memory-arguments\\\":1,\\\"lessThanEqualsInteger-cpu-arguments-slope\\\":1366,\\\"fstPair-memory-arguments\\\":32,\\\"modInteger-memory-arguments-intercept\\\":0,\\\"unConstrData-cpu-arguments\\\":150000,\\\"lessThanEqualsInteger-memory-arguments\\\":1,\\\"chooseUnit-memory-arguments\\\":32,\\\"sndPair-memory-arguments\\\":32,\\\"addInteger-cpu-arguments-intercept\\\":197209,\\\"decodeUtf8-memory-arguments-slope\\\":8,\\\"equalsData-cpu-arguments-intercept\\\":150000,\\\"mapData-cpu-arguments\\\":150000,\\\"mkPairData-cpu-arguments\\\":150000,\\\"quotientInteger-cpu-arguments-constant\\\":148000,\\\"consByteString-memory-arguments-slope\\\":1,\\\"cekVarCost-exBudgetMemory\\\":100,\\\"indexByteString-cpu-arguments\\\":150000,\\\"unListData-cpu-arguments\\\":150000,\\\"equalsInteger-cpu-arguments-slope\\\":1326,\\\"cekStartupCost-exBudgetMemory\\\":100,\\\"subtractInteger-cpu-arguments-intercept\\\":197209,\\\"divideInteger-cpu-arguments-model-arguments-intercept\\\":425507,\\\"divideInteger-memory-arguments-intercept\\\":0,\\\"cekForceCost-exBudgetMemory\\\":100,\\\"blake2b-cpu-arguments-intercept\\\":2477736,\\\"remainderInteger-cpu-arguments-constant\\\":148000,\\\"tailList-cpu-arguments\\\":150000,\\\"encodeUtf8-cpu-arguments-intercept\\\":150000,\\\"equalsString-cpu-arguments-slope\\\":1000,\\\"lessThanByteString-memory-arguments\\\":1,\\\"multiplyInteger-cpu-arguments-slope\\\":11218,\\\"appendByteString-cpu-arguments-intercept\\\":396231,\\\"lessThanEqualsByteString-cpu-arguments-slope\\\":248,\\\"modInteger-memory-arguments-slope\\\":1,\\\"addInteger-cpu-arguments-slope\\\":0,\\\"equalsData-cpu-arguments-slope\\\":10000,\\\"decodeUtf8-memory-arguments-intercept\\\":0,\\\"chooseList-cpu-arguments\\\":150000,\\\"constrData-cpu-arguments\\\":150000,\\\"equalsByteString-memory-arguments\\\":1,\\\"cekApplyCost-exBudgetCPU\\\":29773,\\\"quotientInteger-memory-arguments-slope\\\":1,\\\"verifySignature-cpu-arguments-intercept\\\":3345831,\\\"unMapData-memory-arguments\\\":32,\\\"mkCons-memory-arguments\\\":32,\\\"sliceByteString-memory-arguments-slope\\\":1,\\\"sha3_256-memory-arguments\\\":4,\\\"ifThenElse-memory-arguments\\\":1,\\\"mkNilPairData-memory-arguments\\\":32,\\\"equalsByteString-cpu-arguments-slope\\\":247,\\\"appendString-cpu-arguments-intercept\\\":150000,\\\"quotientInteger-cpu-arguments-model-arguments-slope\\\":118,\\\"cekApplyCost-exBudgetMemory\\\":100,\\\"equalsString-memory-arguments\\\":1,\\\"multiplyInteger-memory-arguments-slope\\\":1,\\\"cekBuiltinCost-exBudgetMemory\\\":100,\\\"remainderInteger-memory-arguments-intercept\\\":0,\\\"sha2_256-cpu-arguments-intercept\\\":2477736,\\\"remainderInteger-cpu-arguments-model-arguments-intercept\\\":425507,\\\"lessThanEqualsByteString-memory-arguments\\\":1,\\\"tailList-memory-arguments\\\":32,\\\"mkNilData-cpu-arguments\\\":150000,\\\"chooseData-cpu-arguments\\\":150000,\\\"unBData-memory-arguments\\\":32,\\\"blake2b-memory-arguments\\\":4,\\\"iData-memory-arguments\\\":32,\\\"nullList-memory-arguments\\\":32,\\\"cekDelayCost-exBudgetCPU\\\":29773,\\\"subtractInteger-memory-arguments-intercept\\\":1,\\\"lessThanByteString-cpu-arguments-intercept\\\":103599,\\\"consByteString-cpu-arguments-slope\\\":1000,\\\"appendByteString-memory-arguments-slope\\\":1,\\\"trace-memory-arguments\\\":32,\\\"divideInteger-cpu-arguments-constant\\\":148000,\\\"cekConstCost-exBudgetCPU\\\":29773,\\\"encodeUtf8-memory-arguments-slope\\\":8,\\\"quotientInteger-cpu-arguments-model-arguments-intercept\\\":425507,\\\"mapData-memory-arguments\\\":32,\\\"appendString-cpu-arguments-slope\\\":1000,\\\"modInteger-cpu-arguments-constant\\\":148000,\\\"verifySignature-cpu-arguments-slope\\\":1,\\\"unConstrData-memory-arguments\\\":32,\\\"quotientInteger-memory-arguments-intercept\\\":0,\\\"equalsByteString-cpu-arguments-constant\\\":150000,\\\"sliceByteString-memory-arguments-intercept\\\":0,\\\"mkPairData-memory-arguments\\\":32,\\\"equalsByteString-cpu-arguments-intercept\\\":112536,\\\"appendString-memory-arguments-slope\\\":1,\\\"lessThanInteger-cpu-arguments-slope\\\":497,\\\"modInteger-cpu-arguments-model-arguments-intercept\\\":425507,\\\"modInteger-memory-arguments-minimum\\\":1,\\\"sha3_256-cpu-arguments-intercept\\\":0,\\\"verifySignature-memory-arguments\\\":1,\\\"cekLamCost-exBudgetMemory\\\":100,\\\"sliceByteString-cpu-arguments-intercept\\\":150000}}}\"\n }\n]\n```\n\n#### get_totals\n\nGet the circulating utxo, treasury, rewards, supply and reserves in lovelace\nfor specified epoch, all epochs if empty\\\nParameters: Epoch (optional)\\\nReturns: Supply/reserves/utxo/fees/treasury stats as a list of one dictionary\n(if the epoch is specified) or a list of all available epochs\n(if the epoch parameter is not specified)\\\nExample:\\\n`totals = get_totals(380)`\\\nExample response:\n\n```json\n[\n {\n \"epoch_no\": 380,\n \"circulation\": \"33505907705011256\",\n \"treasury\": \"1085266054287657\",\n \"reward\": \"635180192555825\",\n \"supply\": \"35230640457275590\",\n \"reserves\": \"9769359542724410\"\n }\n]\n```\n\n#### get_param_updates\n\nGet all parameter update proposals submitted to the chain starting\nShelley era\\\nParameters: none\\\nReturns: All parameter update proposals\\\nExample:\\\n`param_updates = get_param_updates()`\n\n```json\n[\n {\n \"tx_hash\": \"b516588da34b58b7d32b6a057f513e16ea8c87de46615631be3316d8a8847d46\",\n \"block_height\": 4533644,\n \"block_time\": 1596923351,\n \"epoch_no\": 210,\n \"data\": {\n \"decentralisation\": 0.9\n }\n },\n {\n \"tx_hash\": \"784902982af484f78d10f1587072f5a6b888ed0c1296d4ecf1e21c0251696ca1\",\n \"block_height\": 4558648,\n \"block_time\": 1597425824,\n \"epoch_no\": 211,\n \"data\": {\n \"decentralisation\": 0.8\n }\n },\n ...\n]\n```\n\n#### get_reserve_withdrawals\n\nList of all withdrawals from reserves against stake accounts\\\nParameters: none\\\nReturns: The list of withdrawals from reserves against stake accounts\\\nExample:\\\n\n`reserve_withdrawals = get_reserve_withdrawals()`\n\n```json\n[\n {\n \"epoch_no\": 298,\n \"epoch_slot\": 60492,\n \"tx_hash\": \"03b02cff29a5f2dfc827e00345eaab8b29a3d740e9878aa6e5dd2b52da0763c5\",\n \"block_hash\": \"7650ae0c9508fd236f370f1ac329b2d4ae0f8bcf583f2878dbb568c311d08c7c\",\n \"block_height\": 6407962,\n \"amount\": \"66000000000000\",\n \"stake_address\": \"stake1uykws5pmwjxktdhlkz0pac3cu2guw6fjys2zaanmdew6xrs5lgv4n\"\n }\n]\n```\n\n#### get_treasury_withdrawals\n\nList of all withdrawals from treasury against stake accounts\\\nParameters: none\\\nReturns: The list of withdrawals from treasury against stake accounts\\\nExample:\\\n\n`treasury_withdrawals = get_treasury_withdrawals()`\n\n```json\n[\n {\n \"epoch_no\": 441,\n \"epoch_slot\": 152858,\n \"tx_hash\": \"d689bee077e69269ea7e9e8f5b09f5f93af887c117cd7a1157d09bec209900dd\",\n \"block_hash\": \"18add9785eeaacbe0534cf362cd49e78170f23a3a91b862ef5ba2ad444bc2766\",\n \"block_height\": 9394726,\n \"amount\": \"50000000000000\",\n \"stake_address\": \"stake1uxv9hwk8523p3asgnnjv0t49qvmlj96j22dw434j2gyks2qn9x52u\"\n }\n]\n```\n\n### Epoch\n\n#### get_epoch_info\n\nGet the epoch information, all epochs if no epoch specified\\\nParameters: Epoch (optional)\\\nReturns: The list of epoch info dictionaries\\\nExample:\\\n`epoch_info = get_epoch_info(448)`\\\nExample response:\n\n```json\n[\n {\n \"epoch_no\": 448,\n \"out_sum\": \"118059162440190062\",\n \"fees\": \"102026957711\",\n \"tx_count\": 293835,\n \"blk_count\": 21134,\n \"start_time\": 1699739091,\n \"end_time\": 1700171091,\n \"first_block_time\": 1699739174,\n \"last_block_time\": 1700171052,\n \"active_stake\": \"22973647281453944\",\n \"total_rewards\": \"10027944051413\",\n \"avg_blk_reward\": \"474493425\"\n }\n]\n```\n\n#### get_epoch_params\n\nGet the protocol parameters for specific epoch, returns information\nabout all epochs if no epoch specified\\\nParameters: Epoch (optional)\\\nReturns: The list of epoch protocol parameters dictionaries\\\nExample:\\\n`epoch_params = get_epoch_params(448)`\\\nExample response:\n\n```json\n[\n {\n \"epoch_no\": 448,\n \"min_fee_a\": 44,\n \"min_fee_b\": 155381,\n \"max_block_size\": 90112,\n \"max_tx_size\": 16384,\n \"max_bh_size\": 1100,\n \"key_deposit\": \"2000000\",\n \"pool_deposit\": \"500000000\",\n \"max_epoch\": 18,\n \"optimal_pool_count\": 500,\n \"influence\": 0.3,\n \"monetary_expand_rate\": 0.003,\n \"treasury_growth_rate\": 0.2,\n \"decentralisation\": 0,\n \"extra_entropy\": null,\n \"protocol_major\": 8,\n \"protocol_minor\": 0,\n \"min_utxo_value\": \"0\",\n \"min_pool_cost\": \"170000000\",\n \"nonce\": \"d58c8fdf57a9d20b4e72fce94056ad2ed2b62e40a7b0b35e1f37f267f9546c07\",\n \"block_hash\": \"a74c031d215542d19fdafee6a28fde865c5961d296759e0ae9d19d50aa6f8a12\",\n \"cost_models\": {\n \"PlutusV1\": [\n 205665,\n 812,\n 1,\n 1,\n 1000,\n 571,\n 0,\n 1,\n 1000,\n 24177,\n 4,\n 1,\n 1000,\n 32,\n 117366,\n 10475,\n 4,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 100,\n 100,\n 23000,\n 100,\n 19537,\n 32,\n 175354,\n 32,\n 46417,\n 4,\n 221973,\n 511,\n 0,\n 1,\n 89141,\n 32,\n 497525,\n 14068,\n 4,\n 2,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 1000,\n 28662,\n 4,\n 2,\n 245000,\n 216773,\n 62,\n 1,\n 1060367,\n 12586,\n 1,\n 208512,\n 421,\n 1,\n 187000,\n 1000,\n 52998,\n 1,\n 80436,\n 32,\n 43249,\n 32,\n 1000,\n 32,\n 80556,\n 1,\n 57667,\n 4,\n 1000,\n 10,\n 197145,\n 156,\n 1,\n 197145,\n 156,\n 1,\n 204924,\n 473,\n 1,\n 208896,\n 511,\n 1,\n 52467,\n 32,\n 64832,\n 32,\n 65493,\n 32,\n 22558,\n 32,\n 16563,\n 32,\n 76511,\n 32,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 69522,\n 11687,\n 0,\n 1,\n 60091,\n 32,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 806990,\n 30482,\n 4,\n 1927926,\n 82523,\n 4,\n 265318,\n 0,\n 4,\n 0,\n 85931,\n 32,\n 205665,\n 812,\n 1,\n 1,\n 41182,\n 32,\n 212342,\n 32,\n 31220,\n 32,\n 32696,\n 32,\n 43357,\n 32,\n 32247,\n 32,\n 38314,\n 32,\n 57996947,\n 18975,\n 10\n ],\n \"PlutusV2\": [\n 205665,\n 812,\n 1,\n 1,\n 1000,\n 571,\n 0,\n 1,\n 1000,\n 24177,\n 4,\n 1,\n 1000,\n 32,\n 117366,\n 10475,\n 4,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 23000,\n 100,\n 100,\n 100,\n 23000,\n 100,\n 19537,\n 32,\n 175354,\n 32,\n 46417,\n 4,\n 221973,\n 511,\n 0,\n 1,\n 89141,\n 32,\n 497525,\n 14068,\n 4,\n 2,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 1000,\n 28662,\n 4,\n 2,\n 245000,\n 216773,\n 62,\n 1,\n 1060367,\n 12586,\n 1,\n 208512,\n 421,\n 1,\n 187000,\n 1000,\n 52998,\n 1,\n 80436,\n 32,\n 43249,\n 32,\n 1000,\n 32,\n 80556,\n 1,\n 57667,\n 4,\n 1000,\n 10,\n 197145,\n 156,\n 1,\n 197145,\n 156,\n 1,\n 204924,\n 473,\n 1,\n 208896,\n 511,\n 1,\n 52467,\n 32,\n 64832,\n 32,\n 65493,\n 32,\n 22558,\n 32,\n 16563,\n 32,\n 76511,\n 32,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 69522,\n 11687,\n 0,\n 1,\n 60091,\n 32,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 196500,\n 453240,\n 220,\n 0,\n 1,\n 1,\n 1159724,\n 392670,\n 0,\n 2,\n 806990,\n 30482,\n 4,\n 1927926,\n 82523,\n 4,\n 265318,\n 0,\n 4,\n 0,\n 85931,\n 32,\n 205665,\n 812,\n 1,\n 1,\n 41182,\n 32,\n 212342,\n 32,\n 31220,\n 32,\n 32696,\n 32,\n 43357,\n 32,\n 32247,\n 32,\n 38314,\n 32,\n 35892428,\n 10,\n 57996947,\n 18975,\n 10,\n 38887044,\n 32947,\n 10\n ]\n },\n \"price_mem\": 0.0577,\n \"price_step\": 7.21e-05,\n \"max_tx_ex_mem\": 14000000,\n \"max_tx_ex_steps\": 10000000000,\n \"max_block_ex_mem\": 62000000,\n \"max_block_ex_steps\": 20000000000,\n \"max_val_size\": 5000,\n \"collateral_percent\": 150,\n \"max_collateral_inputs\": 3,\n \"coins_per_utxo_size\": \"4310\"\n }\n]\n```\n\n#### get_epoch_block_protocols\n\nGet the information about block protocol distribution in epoch\\\nParameters: Epoch (optional)\\\nReturns: The list of epoch protocol distribution dictionaries\\\nExample:\\\n`epoch_block_protocols = get_epoch_block_protocols(380)`\\\nExample response:\n\n```json\n[\n {\n \"proto_major\": 7,\n \"proto_minor\": 0,\n \"blocks\": 8930\n },\n {\n \"proto_major\": 8,\n \"proto_minor\": 0,\n \"blocks\": 12340\n }\n]\n```\n\n### Block\n\n#### get_blocks\n\nGet summarised details about all blocks (paginated - latest first)\\\nParameters: The maximum number of blocks to return\\\nReturns: The list of block dictionaries (the newest first)\\\nExample:\\\n`blocks = get_blocks(3)`\\\nExample response:\n\n```json\n[\n {\n \"hash\": \"8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6\",\n \"epoch_no\": 381,\n \"abs_slot\": 79266935,\n \"epoch_slot\": 38135,\n \"block_height\": 8129401,\n \"block_size\": 49025,\n \"block_time\": 1670833226,\n \"tx_count\": 19,\n \"vrf_key\": \"vrf_vk1pj8n7cv07gn4s83vnxgnh3l4m0uqunud2hfmn6d203v6gjvn6jfq9yanjy\",\n \"pool\": \"pool1qqq6qqa0hpzvumv5p87ynczfmdj557xuwlc3289ke42g72z7f74\",\n \"proto_major\": 8,\n \"proto_minor\": 0,\n \"op_cert_counter\": 10\n },\n {\n \"hash\": \"6464132c9227e39f2a9bca27d738a28d9cd64aba37f55277d75e7e8e0aa5d892\",\n \"epoch_no\": 381,\n \"abs_slot\": 79266917,\n \"epoch_slot\": 38117,\n \"block_height\": 8129400,\n \"block_size\": 88807,\n \"block_time\": 1670833208,\n \"tx_count\": 52,\n \"vrf_key\": \"vrf_vk1hnkdcm6y67amyfnhu4gv2n77496wxmnznke6fqdan53j20mc6jjq7q98e6\",\n \"pool\": \"pool1nhd907krga9dh69kf0jg4tl0764rravepy337gptvsknxyyx94k\",\n \"proto_major\": 8,\n \"proto_minor\": 0,\n \"op_cert_counter\": 20\n },\n {\n \"hash\": \"7ba6d760e576d3b078dedd931284e0f818306fd71bdba47a0fc6b8b9b7c22dbc\",\n \"epoch_no\": 381,\n \"abs_slot\": 79266839,\n \"epoch_slot\": 38039,\n \"block_height\": 8129399,\n \"block_size\": 10031,\n \"block_time\": 1670833130,\n \"tx_count\": 7,\n \"vrf_key\": \"vrf_vk1kchxdfjqfew7vt88e7l6q2eg3nylf5arahhp8pzfn5z2eyy0z4tsg7sr5k\",\n \"pool\": \"pool15yyxtkhz64p7a8cnax9l7u82s9t9hdhyxsa3tdm977qhgpnsuhq\",\n \"proto_major\": 7,\n \"proto_minor\": 0,\n \"op_cert_counter\": 30\n }\n]\n```\n\n#### get_block_info\n\nGet detailed information about a specific block\\\nParameters: Block hash as string (for one block) or list of block hashes\n(for multiple blocks)\\\nReturns: The list of block dictionaries\\\nExample:\\\n`block_info = get_block_info('8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6')`\\\nExample response:\n\n```json\n[\n {\n \"hash\": \"8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6\",\n \"epoch_no\": 381,\n \"abs_slot\": 79266935,\n \"epoch_slot\": 38135,\n \"block_height\": 8129401,\n \"block_size\": 49025,\n \"block_time\": 1670833226,\n \"tx_count\": 19,\n \"vrf_key\": \"vrf_vk1pj8n7cv07gn4s83vnxgnh3l4m0uqunud2hfmn6d203v6gjvn6jfq9yanjy\",\n \"op_cert\": \"9dac36a4e413be97bcc4d34341023d3ee9d825e27a45beac739270f6e344d478\",\n \"op_cert_counter\": 10,\n \"pool\": \"pool1qqq6qqa0hpzvumv5p87ynczfmdj557xuwlc3289ke42g72z7f74\",\n \"proto_major\": 8,\n \"proto_minor\": 0,\n \"total_output\": \"45569728258134\",\n \"total_fees\": \"5966381\",\n \"num_confirmations\": 10,\n \"parent_hash\": null,\n \"child_hash\": null\n }\n]\n```\n\n#### get_block_txs\n\nGet a list of all transactions included in provided blocks\\\nParameters: Block(s) hash(es) as string (for one block) or list of block hashes\n(for multiple blocks)\\\nReturns: The list of transaction dictionaries by block\\\nExample:\\\n`block_txs = get_block_txs('8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6')`\\\nExample response:\n\n```json\n[\n {\n \"block_hash\": \"8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6\",\n \"tx_hashes\": [\n \"d1c7496398b02cb2833c3e164947e1ec171819b7ec056fc6b798e2ee122af862\",\n \"6fe4152a34ee23ccdb5b42e9397ec1c960e51eb28d101b7a59645ce8299fa553\",\n \"2982bdebe8425c19a275416331cdb54d71409e9107e0add51784a37735fc2316\",\n \"bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef\",\n \"291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937\",\n \"505057f2ce7e9cc2442c6dd2339e476e916f1d7b03888110c455082a808e47f5\",\n \"1b4cab1352b8f5b91f97a05c05244ad654282ece5b5f118a0302bc90c86e7476\",\n \"9f38998d3ef516f3150a1dc1f8a3f96ca8aa98636b63d835b4f480712d010474\",\n \"99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6\",\n \"0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060\",\n \"a42ee1a5685ff6953464c32af6221b43732a8550d40f2b7f67f6d2250dfdcbb2\",\n \"63f99851ff566f801552aed538f8edd2eb4d20b9b66d475f2d51b075595443e7\",\n \"ecc46903435f89dde0e65865404a1c3a3af0ec78e08ff6e771e410539037f35e\",\n \"1515e444851c9c7d3abe85ff275c5fd5af8d4844da04f1472d343bcc27f7e58c\",\n \"12ad9fd5bb7482ee08de25d748288c41df4b05ac079d307a36b6159980fa4b03\",\n \"c99ed71da7c20d34ceba491c68e60a94c898db0c4b4360f54da09f7ae09370f0\",\n \"a061003549062114645dfd5d7a353189edb2b6d0f9049f8b1a52ee42d5397247\",\n \"57619d9198ac449cda755e255ed639d43c82a0e38ec001194f373a151d05a159\",\n \"6a4adc1e4ef496dc5fadb01641cc849633a13524ac63800a1e1c2e4e87238777\"\n ]\n }\n]\n```\n\n### Transactions\n\n#### get_utxo_info\n\nGet UTxO set for requested UTxO references\\\nParameters: UTxO(s) hash(es) and index(es) as a string (for one transaction)\nor list (for multiple transactions), with \"#\" between the UTxO hash\nand the index\\\nReturns: The list of complete UTxO information\\\nExample:\\\n`utxo_info = get_utxo_info('99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6#0')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6\",\n \"tx_index\": 0,\n \"address\": \"addr1qy59gr3ylt0us3xj7tawpxfn6ccauxa2upwv04m8mg5jehujfkxey5y9v6huj69rp39fk8zh3gpvrmc0mc4fr0j379kqp865ns\",\n \"value\": \"4817999\",\n \"stake_address\": \"stake1uxfymrvj2zzkdt7fdz3scj5mr3tc5qkpau8au253heglzmqjatts0\",\n \"payment_cred\": \"28540e24fadfc844d2f2fae09933d631de1baae05cc7d767da292cdf\",\n \"epoch_no\": 381,\n \"block_height\": 8129401,\n \"block_time\": 1670833226,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": true\n }\n]\n```\n\n#### get_tx_info\n\nGet detailed information about transaction(s)\\\nParameters: Transaction(s) hash(es) as a string (for one transaction)\nor list (for multiple transactions)\\\nReturns: The list of transactions details dictionaries\\\nExample:\\\n`tx_info = get_tx_info('99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6\",\n \"block_hash\": \"8e33bb588feff6414469779d724923064688615535280f8982c9981410cd06f6\",\n \"block_height\": 8129401,\n \"epoch_no\": 381,\n \"epoch_slot\": 38135,\n \"absolute_slot\": 79266935,\n \"tx_timestamp\": 1670833226,\n \"tx_block_index\": 8,\n \"tx_size\": 436,\n \"total_output\": \"4817999\",\n \"fee\": \"182001\",\n \"deposit\": \"0\",\n \"invalid_before\": null,\n \"invalid_after\": null,\n \"collateral_inputs\": [],\n \"collateral_output\": null,\n \"reference_inputs\": [],\n \"inputs\": [\n {\n \"value\": \"5000000\",\n \"tx_hash\": \"1d6776a3a1bed38f6705bc8c861c2a49d65423ecac9409f4a532a085901e29f8\",\n \"tx_index\": 0,\n \"asset_list\": [\n {\n \"quantity\": \"2\",\n \"policy_id\": \"27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357\",\n \"asset_name\": \"414952\",\n \"fingerprint\": \"asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25\"\n },\n {\n \"quantity\": \"2\",\n \"policy_id\": \"27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357\",\n \"asset_name\": \"4541525448\",\n \"fingerprint\": \"asset1udwewa3sp34ukmeddhkwf8msqd6dq6frhy2j9s\"\n }\n ],\n \"datum_hash\": null,\n \"stake_addr\": null,\n \"inline_datum\": null,\n \"payment_addr\": {\n \"cred\": \"48edbef119f1330e0faa124f623054ab5e2e4464e9f6c9b8ebf0afaf\",\n \"bech32\": \"addr1v9ywm0h3r8cnxrs04gfy7c3s2j44utjyvn5ldjdca0c2ltccgqdes\"\n },\n \"reference_script\": null\n }\n ],\n \"outputs\": [\n {\n \"value\": \"4817999\",\n \"tx_hash\": \"99f2aefba2a4a5a550aeed9d91d3adabe77a286ec45c345c7980a208364f76c6\",\n \"tx_index\": 0,\n \"asset_list\": [\n {\n \"quantity\": \"1\",\n \"policy_id\": \"27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357\",\n \"asset_name\": \"414952\",\n \"fingerprint\": \"asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25\"\n }\n ],\n \"datum_hash\": null,\n \"stake_addr\": \"stake1uxfymrvj2zzkdt7fdz3scj5mr3tc5qkpau8au253heglzmqjatts0\",\n \"inline_datum\": null,\n \"payment_addr\": {\n \"cred\": \"28540e24fadfc844d2f2fae09933d631de1baae05cc7d767da292cdf\",\n \"bech32\": \"addr1qy59gr3ylt0us3xj7tawpxfn6ccauxa2upwv04m8mg5jehujfkxey5y9v6huj69rp39fk8zh3gpvrmc0mc4fr0j379kqp865ns\"\n },\n \"reference_script\": null\n }\n ],\n \"withdrawals\": [],\n \"assets_minted\": [\n {\n \"quantity\": \"-1\",\n \"policy_id\": \"27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357\",\n \"asset_name\": \"414952\",\n \"fingerprint\": \"asset1cl5pvxah2ckvdfax3uzsk57ffxw67m98da5v25\"\n },\n {\n \"quantity\": \"-2\",\n \"policy_id\": \"27eee19588c997ca54d3137f64afe55a18dfcf9062fa83a724bf2357\",\n \"asset_name\": \"4541525448\",\n \"fingerprint\": \"asset1udwewa3sp34ukmeddhkwf8msqd6dq6frhy2j9s\"\n }\n ],\n \"metadata\": null,\n \"certificates\": [],\n \"native_scripts\": [],\n \"plutus_contracts\": []\n }\n]\n```\n\n#### get_tx_metadata\n\nGet metadata information (if any) for given transaction(s)\\\nParameters: Transaction(s) hash(es) as a string (for one transaction)\nor list (for multiple transactions)\\\nReturns: The list of transactions metadata dictionaries\\\nExample:\\\n`tx_metadata = get_tx_metadata('291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"291b5533227331999eca2e63934c1061e5f85993e77747a90d9901413d7bb937\",\n \"metadata\": {\n \"0\": \"d8799f581c078075595cc992a8d99eaad00a118e59303f1dae095601a05dec15\",\n \"1\": \"9a9fd8799fd8799fd8799f581c07279c6cb6238c73c6ef7429894d7906a5b326\",\n \"2\": \"39faa311af8f56f884ffd87a80ffa140d8799f00a1401a069db9c0ffffd8799f\",\n \"3\": \"d8799fd8799f581c70e60f3b5ea7153e0acc7a803e4401d44b8ed1bae1c7baaa\",\n \"4\": \"d1a62a72ffd8799fd8799fd8799f581c1e78aae7c90cc36d624f7b3bb6d86b52\",\n \"5\": \"696dc84e490f343eba89005fffffffffa140d8799f00a1401a00a95f60ffffd8\",\n \"6\": \"799fd8799fd8799f581c078075595cc992a8d99eaad00a118e59303f1dae0956\",\n \"7\": \"01a05dec159affd8799fd8799fd8799f581c6921c483c2ba3451072c5f90058d\",\n \"8\": \"c40c7b35af88238dd105f82570d2ffffffffa140d8799f00a1401a19cd87a0ff\",\n \"9\": \"ffffff\",\n \"30\": \"4\"\n }\n }\n]\n```\n\n#### get_tx_metalabels\n\nGet a list of all transaction metadata labels\\\nParameters: none\\\nReturns: The list of transaction metadata labels dictionaries\\\nExample:\\\n`tx_metalabels = get_tx_metalabels()`\\\nExample response:\n\n```json\n[\n {\n \"key\": \"0\"\n },\n {\n \"key\": \"1\"\n },\n {\n \"key\": \"2\"\n },\n {\n \"key\": \"3\"\n },\n {\n \"key\": \"4\"\n },\n {\n \"key\": \"5\"\n },\n ...\n {\n \"key\": \"1657732524678\"\n },\n {\n \"key\": \"1657905239358\"\n }\n]\n```\n\n#### submit_tx\n\nSubmit an already serialized transaction to the network\\\nParameters: Transaction in cbor format\\\nReturns: Transaction hash\\\nExample:\\\n`response = submit_tx(tx)`\\\nExample response:\n\n```text\n0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060\n```\n\n#### get_tx_status\n\nGet the number of block confirmations for a given transaction hash list\\\nParameters: Transaction(s) hash(es) as a string (for one transaction)\nor list (for multiple transactions)\\\nReturns: The list of transactions block confirmations dictionaries\\\nExample:\\\n`tx_status = get_tx_status('0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"0eec38dc1d2d021f477a890d754e66c49fe74a9fd972793076587496c9850060\",\n \"num_confirmations\": 228\n }\n]\n```\n\n### Address\n\n#### get_address_info\n\nGet the transaction hash list of input address array, optionally filtering\nafter specified block height (inclusive)\\\nParameters: Payment address(es) as string (for one address) or list\n(for multiple addresses)\\\nReturns: The list of transactions dictionaries\\\nExample:\\\n`address_info = get_address_info('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\\\nExample response:\n\n```json\n[\n {\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"balance\": \"15418617\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"script_address\": false,\n \"utxo_set\": [\n {\n \"tx_hash\": \"c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973\",\n \"tx_index\": 1,\n \"block_height\": 8129403,\n \"block_time\": 1670833300,\n \"value\": \"15418617\",\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": []\n }\n ]\n }\n]\n```\n\n#### get_address_utxos\n\nGet UTxO set for given addresses\\\nParameters: \\\nAddress(es): Payment address(es) as string (for one address) or list\n(for multiple addresses)\\\nExtended: Boolean which controls whether certain optional fields supported\\\nby a given endpoint are populated as a part of the request\\\nReturns: The list of transactions dictionaries\\\nExample:\\\n`address_utxos = get_address_utxos('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"eb9fc5848297ac94903164519dc9955acc5645b831ed48ad03c67edefec9b50d\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"5459647\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 439,\n \"block_height\": 9356379,\n \"block_time\": 1696084155,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"67f7b1240deff9bafd7d5f9da199d40f1072519edfc21592485a583f31a8a966\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"12740897\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 447,\n \"block_height\": 9532358,\n \"block_time\": 1699686385,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"cb3646d0739dd1884b2cf16fbc8fc768763103ddcdd3a3f9fc7fd6a0ea75fa63\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"19778509\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 448,\n \"block_height\": 9537064,\n \"block_time\": 1699782852,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"1fc61d4f02f170554e06b2608fc021a5c6910faa125c8baebbaa66d16dadec44\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"25618819\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 448,\n \"block_height\": 9538689,\n \"block_time\": 1699816992,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"f38eb43c9c5d899ad9d5a727a6cd64fce34e5ddb0b3cc29a3241931ba323f2d9\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"16173935\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 449,\n \"block_height\": 9564511,\n \"block_time\": 1700343086,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"1c00a4087c594c4453c8c3a8f51663d0a9ba59f3e3e02cf961c01d8cc80edd44\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"15633446\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 450,\n \"block_height\": 9587376,\n \"block_time\": 1700814155,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"40e3609e2d1c3ea38601d119dbf6711a448defaadc4fa1d1590c0d48f29c240e\",\n \"tx_index\": 1,\n \"address\": \"addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7\",\n \"value\": \"12308427\",\n \"stake_address\": \"stake1uy4jj73pfyejl4d2rs6nc70eykkhhu56p3y2rj2tdayfzeqnjyh0j\",\n \"payment_cred\": \"dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39\",\n \"epoch_no\": 450,\n \"block_height\": 9592563,\n \"block_time\": 1700923481,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n }\n]\n```\n\n#### get_credential_utxos\n\nGet a list of UTxO against input payment credential array including their\nbalances\\\nParameters: Payment credential(s) as string (for one credential) or list\n(for multiple credentials)\\\nReturns: The list of UTxO against input payment credential array including\ntheir balances\\\nExample:\\\n`credential_utxos = get_credential_utxos('0c35748e147183cd784875e78a5b372fa6975e9ac6406d6015c09bac')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"8e9b85284f92ad85416d4fb0a3ff5d3bbd9b57c4a4d97a8d39dc99316eace0cf\",\n \"tx_index\": 0,\n \"value\": \"5000000\"\n },\n {\n \"tx_hash\": \"e7333c01d3c2887767aca13e5c74fb858fbf0119cd90d944869ee72b8b81f523\",\n \"tx_index\": 1,\n \"value\": \"20432286\"\n },\n {\n \"tx_hash\": \"ecfbbc335ec203b10ee65faddf06fb0ceac27c36ef3a76047fbf820f6e9ed7f2\",\n \"tx_index\": 2,\n \"value\": \"2301540\"\n },\n {\n \"tx_hash\": \"b70a9107a38e776c0b1d94a1578c393a1ce01ea8e28ed56c5c724a2639e31bfe\",\n \"tx_index\": 2,\n \"value\": \"1150770\"\n },\n {\n \"tx_hash\": \"1107afdada22f259aa798de57ca3839e212e977467628c85315326917a13dd3b\",\n \"tx_index\": 2,\n \"value\": \"1150770\"\n },\n ...\n {\n \"tx_hash\": \"b9d519ff9309dd78a7e8031aef2fa6b21358478efed5f0bdf234fa10c83eede7\",\n \"tx_index\": 1,\n \"value\": \"137666866\"\n }\n]\n```\n\n#### get_address_txs\n\nGet the transaction hash list of input address array, optionally filtering\nafter specified block height (inclusive)\\\nParameters: Payment address(es) as string (for one address) or list\n(for multiple addresses)\\\nReturns: The list of transactions dictionaries\\\nExample:\\\n`address_txs = get_address_txs('addr1q8wv876ptu0qhujmh2awdcnpcc0ctgdz8e8qvv29k8hucwft99azzjfn9l2658p483uljfdd00ef5rzg58y5km6gj9jqcp0ws7')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973\",\n \"epoch_no\": 381,\n \"block_height\": 8129403,\n \"block_time\": 1670833300\n },\n {\n \"tx_hash\": \"bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef\",\n \"epoch_no\": 381,\n \"block_height\": 8129401,\n \"block_time\": 1670833226\n },\n {\n \"tx_hash\": \"2534b92a1d04ef39f9915bef8d7c5246cc4db880ac01f3499fe9aa83ac155a19\",\n \"epoch_no\": 380,\n \"block_height\": 8127226,\n \"block_time\": 1670787767\n },\n ...\n {\n \"tx_hash\": \"3c16d642fc92012a8808446b29fe89028a2bc37508048a9eb465265d30a24386\",\n \"epoch_no\": 373,\n \"block_height\": 7971352,\n \"block_time\": 1667570778\n }\n]\n```\n\n#### get_credential_txs\n\nGet the transaction hash list of input payment credential array,\noptionally filtering after specified block height (inclusive)\\\nParameters: \\\nCredential(s) as string (for one credential) or list\n(for multiple credentials)\\\nAfter block height (optional): Only fetch information after\nspecific block height\\\nReturns: The list of address information dictionaries\\\nExample:\\\n`credential_txs = get_credential_txs('dcc3fb415f1e0bf25bbabae6e261c61f85a1a23e4e063145b1efcc39')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"c626fe027d09db2b6c63ba67e3638911ff70e3b691a7e5c03e75c0d3a168c973\",\n \"epoch_no\": 381,\n \"block_height\": 8129403,\n \"block_time\": 1670833300\n },\n {\n \"tx_hash\": \"bf685dde61d36b8acd259b2bd00a69a2e8359d2a69b75aa3a0eff9d38ca1f2ef\",\n \"epoch_no\": 381,\n \"block_height\": 8129401,\n \"block_time\": 1670833226\n },\n ...\n {\n \"tx_hash\": \"3c16d642fc92012a8808446b29fe89028a2bc37508048a9eb465265d30a24386\",\n \"epoch_no\": 373,\n \"block_height\": 7971352,\n \"block_time\": 1667570778\n }\n]\n```\n\n#### get_address_assets\n\nGet the list of all the assets (policy, name and quantity) for given\naddresses\\\nParameters: Payment address(es) as string (for one address) or list\n(for multiple addresses)\\\nReturns: The list of assets dictionaries by address\\\nExample:\\\n`address_assets = get_address_assets('addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh')`\\\nExample response:\n\n```json\n[\n {\n \"address\": \"addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh\",\n \"asset_list\": [\n {\n \"policy_id\": \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\",\n \"asset_name\": \"4379626572696130363936\",\n \"fingerprint\": \"asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70\",\n \"quantity\": \"1\"\n },\n {\n \"policy_id\": \"14a95b2a4a863c8074d6a78a6a445150223e867999a90295dc1d0cf6\",\n \"asset_name\": \"50726f6a65637456656e757330303536\",\n \"fingerprint\": \"asset1pdz0dvugfezf6evgyvvyl5zda8mhdfhef8d3fd\",\n \"quantity\": \"1\"\n },\n ...\n {\n \"policy_id\": \"ffff5571ecec795284f04ad6e6852ed2d46d924535ed68ad97fa1e70\",\n \"asset_name\": \"634e4654636f6e486f70706572363935\",\n \"fingerprint\": \"asset1dcn7mx0ccelvmweef6wjcuhur9a2hpg8des4pl\",\n \"quantity\": \"1\"\n }\n ]\n }\n]\n```\n\n### Asset\n\n#### get_asset_list\n\nGet the list of all native assets (paginated)\\\nParameters:\\\nAsset Policy (optional), default: all policies\\\nThe offset (optional) to start from, default 0\\\nThe maximum number of accounts to return (optional), default 0 (no limit)\\\nReturns: The list of assets dictionaries by policy\\\nExample:\\\n`asset_list = get_asset_list()`\\\nExample response:\n\n```json\n[\n {\n \"policy_id\": \"00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae\",\n \"asset_name\": \"6e7574636f696e\",\n \"fingerprint\": \"asset12h3p5l3nd5y26lr22am7y7ga3vxghkhf57zkhd\"\n },\n {\n \"policy_id\": \"000000adf8fcbdf03a5c154123aff674edf287fb13532a343b617fb2\",\n \"asset_name\": \"5853534e4654\",\n \"fingerprint\": \"asset1ke42k9ug86yr535qwkq5edlvfdvlpfuslrmfup\"\n },\n ...\n {\n \"policy_id\": \"00255c245861e1e15ef8aced64d44dd20682ee7c2bb42b7941e199dd\",\n \"asset_name\": \"43726565707942616c6c7a57316231303137\",\n \"fingerprint\": \"asset12dvnasghksl5k7w696nd5t692j6myexapwjh0d\"\n },\n ...\n]\n```\n\n#### get_policy_asset_list\n\nGet the list of asset under the given policy (including balances)\\\nParameters: Asset Policy\\\nReturns: List of dictionaries with the asset under the given policy\\\nExample:\\\n`asset_policy_list = get_policy_asset_list('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\\\nExample response:\n\n```json\n[\n {\n \"asset_name\": \"\",\n \"asset_name_ascii\": \"\",\n \"fingerprint\": \"asset1pht97cylpt7azuu9mwhmd9c9zdgmumwrrm5yrc\",\n \"minting_tx_hash\": \"90415fda215ff5098d7fa1385c7358c589066332068b720380726e3ef0b26de4\",\n \"total_supply\": \"0\",\n \"mint_cnt\": 1,\n \"burn_cnt\": 1,\n \"creation_time\": 1665100800,\n \"minting_tx_metadata\": {\n \"777\": {\n \"addr\": [\n \"addr1qy36jns6h4w4f80u6xed49k6qn9c7tk4x4us5kaxztjq8x3un2me8nvc5ke\",\n \"gvll0gnwlj2ypzfhhqpns47u76gafttmq208x4d\"\n ],\n \"rate\": \"0.05\"\n }\n },\n \"token_registry_metadata\": null\n },\n ...\n {\n \"asset_name\": \"4379626572696130333939\",\n \"asset_name_ascii\": \"Cyberia0399\",\n \"fingerprint\": \"asset1g7tgq2ly8uhtzcz79uhay8tq46h9rq62arfm8s\",\n \"minting_tx_hash\": \"98db0a36106a92149b256887f6300f2b228e14d24d488e4b1614920083cd64ff\",\n \"total_supply\": \"1\",\n \"mint_cnt\": 1,\n \"burn_cnt\": 0,\n \"creation_time\": 1665187200,\n \"minting_tx_metadata\": {\n \"721\": {\n \"nonce\": \"c966f455d3e03537\",\n \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\": {\n \"Cyberia0399\": {\n \"Pose\": \"Lunge pose - Anjaneyasana\",\n \"Skin\": \"Gold\",\n \"name\": \"Cyberia Chakra Planet #0399\",\n \"files\": [\n {\n \"src\": \"ipfs://QmVsMggcQE3da9xuZv7uvJRH84gs5ebGQ8kxVPSQw52XRf\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmSHyNm11PrqyrUXszKtsz52ADH6A934c3gw41H7CMCj7D\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmVsMggcQE3da9xuZv7uvJRH84gs5ebGQ8kxVPSQw52XRf\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Male\",\n \"Chakra\": \"Sacral - Svadhisthana\",\n \"Mantra\": \"VAM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Sexual and Creative Energy\",\n \"Location\": \"Below the Belly Button\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Orange\"\n },\n \"Cyberia2795\": {\n \"Pose\": \"Headstand - Sirsasana\",\n \"Skin\": \"Gold\",\n \"name\": \"Cyberia Chakra Planet #2795\",\n \"files\": [\n {\n \"src\": \"ipfs://QmZ4TGY2Jzy5JGaD3S7RLsrP9K8jbp44e7463iHAGitM5a\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmcEqKkAcxeGNZimSiQZ2duZA4sx4xJawh35VwuJoS3A9m\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmZ4TGY2Jzy5JGaD3S7RLsrP9K8jbp44e7463iHAGitM5a\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Female\",\n \"Chakra\": \"Crown - Sahasrara\",\n \"Mantra\": \"OM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Spiritual Connection\",\n \"Location\": \"Top of the Head\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Purple\"\n }\n }\n }\n },\n \"token_registry_metadata\": null\n }\n]\n```\n\n#### get_asset_token_registry\n\nGet a list of assets registered via token registry on github\\\nParameters: logo (bool) - include the logo in the response or not, default: True\\\nReturns: The list of assets registered via token registry on github\\\nExample:\\\n`asset_token_registry = get_asset_token_registry()`\\\nExample response:\n\n```json\n[\n {\n \"policy_id\": \"00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae\",\n \"asset_name\": \"6e7574636f696e\",\n \"asset_name_ascii\": \"nutcoin\",\n \"ticker\": \"NUT\",\n \"description\": \"The legendary Nutcoin, the first native asset minted on Cardano.\",\n \"url\": \"https://fivebinaries.com/nutcoin\",\n \"decimals\": 0,\n \"logo\": \"iVBORw0KGgoAAAANSUhEUgAAAGQA....2rCPgau2EAAAAASUVORK5CYII=\"\n },\n {\n \"policy_id\": \"00109530994ea381c0bfe0936c85ea01bfe2765c24ef6dad5740c33e\",\n \"asset_name\": \"486f646c657220436f616c6974696f6e20436f696e\",\n \"asset_name_ascii\": \"Hodler Coalition Coin\",\n \"ticker\": \"HODLR\",\n \"description\": \"Stake \u20b3DA with the Hodler Coalition. Save the World.\",\n \"url\": \"https://www.hodlerstaking.com/\",\n \"decimals\": 4,\n \"logo\": \"iVBORw0KGgoAAAANSUhEUgAAARAAA...4RtRz5t2G8zAAAAAElFTkSuQmCC\"\n },\n {\n \"policy_id\": \"0011fbab202151eca9e9ef7680569d9419d12e51e693cb05a2edd2ed\",\n \"asset_name\": \"4341524b\",\n \"asset_name_ascii\": \"Cardano Ark Token\",\n \"ticker\": \"CARK\",\n \"description\": \"Utility token for the Cardano Ark\",\n \"url\": \"https://www.cardanoark.com/\",\n \"decimals\": 0,\n \"logo\": \"\"\n },\n ...\n]\n```\n\n#### get_asset_info\n\nGet the information of a list of assets including first minting &\\\ntoken registry metadata\\\nParameters: Asset(s) as policy id and asset name (hex)\\\n(\"asset_policy.asset_name\"), separated by dot (\".\"), as a string \\\n(for one) asset or as a list for multiple assets\\\nReturns: The list of assets including first minting & token registry metadata\\\nExample:\\\n`asset_info = get_asset_info('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd.4379626572696130363936')`\\\nExample response:\n\n```json\n[\n {\n \"policy_id\": \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\",\n \"asset_name\": \"4379626572696130363936\",\n \"asset_name_ascii\": \"Cyberia0696\",\n \"fingerprint\": \"asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70\",\n \"minting_tx_hash\": \"f17b6fafbd1760d5d9defc0334c6a74926fd61a126842ac640b40ffb9c551a31\",\n \"total_supply\": \"1\",\n \"mint_cnt\": 1,\n \"burn_cnt\": 0,\n \"creation_time\": 1665182000,\n \"minting_tx_metadata\": {\n \"721\": {\n \"nonce\": \"4f0b0a78bc757e05\",\n \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\": {\n \"Cyberia0696\": {\n \"Pose\": \"Warrior II Pose - Virabhadrasana II\",\n \"Skin\": \"Red\",\n \"name\": \"Cyberia Chakra Planet #0696\",\n \"files\": [\n {\n \"src\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Male\",\n \"Chakra\": \"Root - Muladhara\",\n \"Mantra\": \"LAM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Grounding\",\n \"Location\": \"Base of Spine\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Red\"\n }\n }\n }\n },\n \"token_registry_metadata\": null\n }\n]\n```\n\n#### get_asset_utxos\n\nGet the UTXO information of a list of assets\\\nParameters:\\\nAsset(s) as policy id and asset name (hex)\\\n(\"asset_policy.asset_name\"), separated by dot (\".\"), as a string \\\n(for one) asset or as a list for multiple assets\\\nExtended: Controls whether certain optional fields supported\\\nby a given endpoint are populated\\\nReturns: List of UTxO information for the requested assets\\\nExample:\\\n`asset_utxos = get_asset_utxos('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd.4379626572696130363936')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"0cfaa1a897dcac81d8faf7227f34654532a4b40b82694fe29e68af9bfa300cf8\",\n \"tx_index\": 3,\n \"address\": \"addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh\",\n \"value\": \"22424930\",\n \"stake_address\": \"stake1uy679wem7a6nv4hadzfvdrfrvzd7fxx805mermr5ryl4fkgylfnyv\",\n \"payment_cred\": \"1c1578b4e5abce42d30c33c8a70e21f2ea79b3e773c5ccdded25ae7c\",\n \"epoch_no\": 447,\n \"block_height\": 9523865,\n \"block_time\": 1699513130,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n }\n]\n```\n\n#### get_asset_history\n\nGet the mint/burn history of an asset\\\nParameters:\\\nAsset Policy\\\nAsset Name in hexadecimal format (optional), default: all policy assets\\\nReturns: List of dictionaries with the mint/burn history of an asset\\\nExample:\\\n`asset_history = get_asset_history('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\\\nExample response:\n\n```json\n[\n {\n \"policy_id\": \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\",\n \"asset_name\": \"4379626572696130363936\",\n \"fingerprint\": \"asset1hf3u704jz0ranfa2ygnq4028ht4vgqz8gsgw70\",\n \"minting_txs\": [\n {\n \"tx_hash\": \"f17b6fafbd1760d5d9defc0334c6a74926fd61a126842ac640b40ffb9c551a31\",\n \"block_time\": 1665182000,\n \"quantity\": \"1\",\n \"metadata\": [\n {\n \"key\": \"721\",\n \"json\": {\n \"nonce\": \"4f0b0a78bc757e05\",\n \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\": {\n \"Cyberia0696\": {\n \"Pose\": \"Warrior II Pose - Virabhadrasana II\",\n \"Skin\": \"Red\",\n \"name\": \"Cyberia Chakra Planet #0696\",\n \"files\": [\n {\n \"src\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Male\",\n \"Chakra\": \"Root - Muladhara\",\n \"Mantra\": \"LAM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Grounding\",\n \"Location\": \"Base of Spine\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Red\"\n }\n }\n }\n }\n ]\n }\n ]\n }\n]\n```\n\n#### get_asset_addresses\n\nGet the list of all addresses holding a given asset\\\nParameters:\\\nAsset Policy\\\nAsset Name in hexadecimal format (optional), default: all policy assets\\\nReturns: List of dictionaries with the wallets holding the asset and the\namount of assets per wallet\\\nExample:\\\n`asset_addresses = get_asset_addresses('07697e6ca1e21777ac76f26d0779c\n53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\\\nExample response:\n\n```json\n[\n {\n \"payment_address\": \"addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh\",\n \"quantity\": \"1\"\n }\n]\n```\n\n#### get_asset_nft_address\n\nGet the address where specified NFT currently reside on.\\\nParameters:\\\nAsset Policy\\\nAsset Name in hexadecimal format\\\nReturns: The wallet address holding the NFT as a list of one dictionary\\\nExample:\\\n`asset_nft_address = get_asset_nft_address('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696130363936')`\\\nExample response:\n\n```json\n[\n {\n \"payment_address\": \"addr1qywp2795uk4uusknpseu3fcwy8ew57dnuaeutnxaa5j6ulp4u2anham4xet066yjc6xjxcymujvvwlfhj8k8gxfl2nvs73rvzh\"\n }\n]\n```\n\n#### get_policy_asset_addresses\n\nGet the list of addresses with quantity for each asset on the given policy\\\nParameters: Asset Policy\\\nReturns: List of addresses with quantity for each asset on the given policy\\\nExample:\\\n`asset_policy_info = get_policy_asset_addresses('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\\\nExample response:\n\n```json\n[\n {\n \"asset_name\": \"4379626572696130303233\",\n \"payment_address\": \"addr1qxu5vk5xafdp39d95ya06d6uya8ldua7crpdzd2an07uw8mrtndmfr0d4qarvgj2wasdwlvrnlqt262jn5asnws7aekssq73gf\",\n \"quantity\": \"1\"\n },\n {\n \"asset_name\": \"4379626572696130303330\",\n \"payment_address\": \"addr1q9wj7ylly5nz2kel6huy966tcsw2l3ct9at7m3euhfxyv246nlp3dj9pda2rphtzycwexsaapyk73k25y3j5neyhg45s879sk4\",\n \"quantity\": \"1\"\n },\n ...\n {\n \"asset_name\": \"4379626572696132383338\",\n \"payment_address\": \"addr1qxg2l50ryn6z23543v6nujvkql9zwj7f7hvsjwalw6jvf25n5k332a42ge9w5en95g9af59fft32g0la0qtfr9vfyyesccney2\",\n \"quantity\": \"1\"\n }\n]\n```\n\n#### get_policy_asset_info\n\nGet the list of asset under the given policy (including balances)\\\nParameters: Asset Policy\\\nReturns: List of dictionaries with the policy assets\\\nExample:\\\n`asset_policy_info = get_policy_asset_info('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd')`\\\nExample response:\n\n```json\n[\n {\n \"asset_name\": \"\",\n \"asset_name_ascii\": \"\",\n \"fingerprint\": \"asset1pht97cylpt7azuu9mwhmd9c9zdgmumwrrm5yrc\",\n \"minting_tx_metadata\": {\n \"key\": \"777\",\n \"json\": {\n \"addr\": [\n \"addr1qy36jns6h4w4f80u6xed49k6qn9c7tk4x4us5kaxztjq8x3un2me8nvc5ke\",\n \"gvll0gnwlj2ypzfhhqpns47u76gafttmq208x4d\"\n ],\n \"rate\": \"0.05\"\n }\n },\n \"token_registry_metadata\": null,\n \"total_supply\": \"0\",\n \"creation_time\": 1665161713\n },\n {\n \"asset_name\": \"4379626572696130353930\",\n \"asset_name_ascii\": \"Cyberia0590\",\n \"fingerprint\": \"asset1dzurenp8f6n8zu3lwglrs0g54xnmd5xwqe9yqp\",\n \"minting_tx_metadata\": {\n \"key\": \"721\",\n \"json\": {\n \"nonce\": \"ac2834e7b5707c30\",\n \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\": {\n \"Cyberia0590\": {\n \"Pose\": \"Warrior II Pose - Virabhadrasana II\",\n \"Skin\": \"Red\",\n \"name\": \"Cyberia Chakra Planet #0590\",\n \"files\": [\n {\n \"src\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmXQSmnRVL4TH4h5YYxZr2m6rfDe65hyv1J4An9znKJr9d\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmZR6VJJ1hWx2bqKo1o8AUzoMxwrUiqGZMzZv8uHXt7MJX\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Male\",\n \"Chakra\": \"Root - Muladhara\",\n \"Mantra\": \"LAM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Grounding\",\n \"Location\": \"Base of Spine\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Red\"\n }\n }\n }\n },\n \"token_registry_metadata\": null,\n \"total_supply\": \"1\",\n \"creation_time\": 1665180305\n },\n ...\n {\n \"asset_name\": \"4379626572696131313535\",\n \"asset_name_ascii\": \"Cyberia1155\",\n \"fingerprint\": \"asset1c7ymj2plmz9dddyx80axrpwy8uhm8q4hzdg3g7\",\n \"minting_tx_metadata\": {\n \"key\": \"721\",\n \"json\": {\n \"nonce\": \"18501ab3c76e955b\",\n \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\": {\n \"Cyberia0921\": {\n \"Pose\": \"Headstand - Sirsasana\",\n \"Skin\": \"Gold\",\n \"name\": \"Cyberia Chakra Planet #0921\",\n \"files\": [\n {\n \"src\": \"ipfs://QmaNEfYXpqFM3vRdvhUkccFpSHUc6MpA6D1Jriefz5oaZr\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmT22qfNW8Ts3FcfbLTe1jx2L7XfJaxzuqKLZ9Qiw45srk\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmaNEfYXpqFM3vRdvhUkccFpSHUc6MpA6D1Jriefz5oaZr\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Male\",\n \"Chakra\": \"Crown - Sahasrara\",\n \"Mantra\": \"OM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Spiritual Connection\",\n \"Location\": \"Top of the Head\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Purple\"\n },\n \"Cyberia1155\": {\n \"Pose\": \"Headstand - Sirsasana\",\n \"Skin\": \"Purple\",\n \"name\": \"Cyberia Chakra Planet #1155\",\n \"files\": [\n {\n \"src\": \"ipfs://QmdRbAZpWvrXQ1wDqWL7fhifJfd6dowx4oZpufdWFiG5Qo\",\n \"name\": \"Please wait while your experience below loads.\",\n \"mediaType\": \"image/jpg\"\n },\n {\n \"src\": \"ipfs://QmfC6r68AzrQyN17Yns4fhtVY4HE9FCPdtv5bsBgfac1qD\",\n \"mediaType\": \"text/html\"\n }\n ],\n \"image\": \"ipfs://QmdRbAZpWvrXQ1wDqWL7fhifJfd6dowx4oZpufdWFiG5Qo\",\n \"Artist\": \"Shrink\",\n \"Avatar\": \"Female\",\n \"Chakra\": \"Crown - Sahasrara\",\n \"Mantra\": \"OM\",\n \"Discord\": \"https://dsc.gg/cyberiacnft\",\n \"Twitter\": \"https://twitter.com/cyberiaCNFT\",\n \"Website\": \"https://cyberia.gg/\",\n \"Function\": \"Spiritual Connection\",\n \"Location\": \"Top of the Head\",\n \"Collection\": \"Chakra Planets\",\n \"Planet colour\": \"Purple\"\n }\n }\n }\n },\n \"token_registry_metadata\": null,\n \"total_supply\": \"1\",\n \"creation_time\": 1670493734\n }\n]\n```\n\n#### get_asset_summary\n\nGet the summary of an asset (total transactions exclude minting/total wallets\ninclude only wallets with asset balance)\\\nParameters:\\\nAsset Policy\\\nAsset Name in hexadecimal format (optional), default: all policy assets\\\nReturns: List of dictionaries with the mint/burn history of an asset\\\nExample:\\\n`asset_summary = get_asset_summary('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696131313535')`\\\nExample response:\n\n```json\n[\n {\n \"policy_id\": \"07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd\",\n \"asset_name\": \"4379626572696131313535\",\n \"fingerprint\": \"asset1c7ymj2plmz9dddyx80axrpwy8uhm8q4hzdg3g7\",\n \"total_transactions\": 1,\n \"staked_wallets\": 0,\n \"unstaked_addresses\": 0\n }\n]\n```\n\n#### get_asset_txs\n\nGet the list of all asset transaction hashes (the newest first)\\\nParameters:\\\nAsset Policy\\\nAsset Name in hexadecimal format (optional), default: all policy assets\\\nBlock number (optional) - return only the transactions after this block\\\nHistory boolean (optional) - include all historical transactions, setting to\nfalse includes only the non-empty ones\\\nReturns: List of dictionaries with the mint/burn history of an asset\\\nExample:\\\n`asset_txs = get_asset_txs('07697e6ca1e21777ac76f26d0779c53f7d08e47b9e32d23bd8fed9cd', '4379626572696131313535')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"d4ac560398b95e6435bd6657e39fe5638f7c5bfaa6ffa6b8fa9bfae0b4882666\",\n \"epoch_no\": 380,\n \"block_height\": 8112717,,\n \"block_time\": 1670493734\n }\n]\n```\n\n### Pool\n\n#### get_pool_list\n\nA list of all currently registered/retiring (not retired) pools\\\nParameters: none\\\nReturns: The list of stake pool dictionaries\\\nExample:\\\n`pool_list = get_pool_list()`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool100wj94uzf54vup2hdzk0afng4dhjaqggt7j434mtgm8v2gfvfgp\",\n \"ticker\": \"JFLD\"\n },\n {\n \"pool_id_bech32\": \"pool102s2nqtea2hf5q0s4amj0evysmfnhrn4apyyhd4azcmsclzm96m\",\n \"ticker\": \"YULI\"\n },\n ...\n {\n \"pool_id_bech32\": \"pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd\",\n \"ticker\": \"APEX\"\n },\n ...\n]\n```\n\n#### get_pool_info\n\nCurrent pool statuses and details for a specified list of pool ids\\\nParameters: Stake pool bech32 ID as string (for one stake pool) or list of\nstake pool bech32 IDs (for multiple stake pools)\\\nReturns: Current pool(s) status(es) and details\\\nExample:\\\n`pool_info = get_pool_info('pool10ljdn3zwsh7vjkxf6t250423l5qy487x83st7m8a53jxznrkw5g')`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool10ljdn3zwsh7vjkxf6t250423l5qy487x83st7m8a53jxznrkw5g\",\n \"pool_id_hex\": \"7fe4d9c44e85fcc958c9d2d547d551fd004a9fc63c60bf6cfda46461\",\n \"active_epoch_no\": 214,\n \"vrf_key_hash\": \"d163c63c5d8d668942542926945f19b89264d4d3ed469dc7fa2741c52f102aec\",\n \"margin\": 0.005,\n \"fixed_cost\": \"340000000\",\n \"pledge\": \"1200000000000\",\n \"reward_addr\": \"stake1u9ea9tc86xqvg6jqafhk8gz2j36csqe6gqtsd0yq7usr0eg4y2625\",\n \"owners\": [\n \"stake1u9sfwmw28cmv5c7fg60jygjk3035ssh893ece9y7qph5cpcy9xwk2\",\n \"stake1uxlxz7gsrmxnfa23eg7n08t9dw3lk9kmhvpunc32ascazls0xyq8s\"\n ],\n \"relays\": [\n {\n \"dns\": \"rl1.fortunepool.net\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n },\n {\n \"dns\": \"rl2.fortunepool.net\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n },\n ...\n {\n \"dns\": \"rl12.fortunepool.net\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n }\n ],\n \"meta_url\": \"http://poolpros.tech/poolMetaData.json\",\n \"meta_hash\": \"1b085d187182cc78f3e9755c8b40b21050e710fe4a1067f9a2dbda8cadf342ba\",\n \"meta_json\": {\n \"name\": \"FORTUNE Pool\",\n \"ticker\": \"FORT\",\n \"homepage\": \"http://fortunepool.net\",\n \"description\": \"FORTUNE Pool - A secure Cardano (ADA) stakepool with reliable uptime, high pledge and great rewards for delegators. Delegate with us and make your ADA FORTUNE\"\n },\n \"pool_status\": \"registered\",\n \"retiring_epoch\": null,\n \"op_cert\": \"1c6b83ff17b31a05046cf660c2a02c852e50eacfa60d89b89ab16aafa7797fc2\",\n \"op_cert_counter\": 9,\n \"active_stake\": \"4942731898587\",\n \"sigma\": 0.00019699539760911983,\n \"block_count\": 722,\n \"live_pledge\": \"1255022000000\",\n \"live_stake\": \"4939842959490\",\n \"live_delegators\": 89,\n \"live_saturation\": 7.01\n }\n]\n```\n\n#### get_pool_stake_snapshot\n\nReturns Mark, Set and Go stake snapshots for the selected pool, useful for\nleaderlog calculation\\\nParameters: Stake pool bech32 id\\\nReturns: Pool snapshot as list of dictionaries by epoch (current and\nprevious 2)\\\nExample:\\\n`pool_stake_snapshot = get_pool_stake_snapshot('pool155efqn9xpcf73pphkk88cmlkdwx4ulkg606tne970qswczg3asc')`\\\nExample response:\n\n```json\n[\n {\n \"snapshot\": \"Go\",\n \"epoch_no\": 380,\n \"nonce\": \"3950677ef48bb212ad335f253ad1998be4e9fe4ae2a26d402607850461398125\",\n \"pool_stake\": \"64328594406327\",\n \"active_stake\": \"25065309972207037\"\n },\n {\n \"snapshot\": \"Set\",\n \"epoch_no\": 381,\n \"nonce\": \"4d617a9da289e6ff2574cc737ac22b337c6d2766847d3422db519f137dee7c43\",\n \"pool_stake\": \"64328594406327\",\n \"active_stake\": \"25090595813788584\"\n },\n {\n \"snapshot\": \"Mark\",\n \"epoch_no\": 382,\n \"nonce\": null,\n \"pool_stake\": \"64328594406327\",\n \"active_stake\": \"25079111896910089\"\n }\n]\n```\n\n#### get_pool_delegators\n\nReturns information about live delegators for a given pool\\\nParameters Stake pool bech32 id\\\nReturns: The list of pool delegators dictionaries\\\nExample:\\\n`pool_delegators = get_pool_delegators('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd')`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1u80603g5n7vtycl75c60jmv56jx3cw53v23xv0txkpcu8kcwr2k27\",\n \"amount\": \"852345\",\n \"active_epoch_no\": 328,\n \"latest_delegation_tx_hash\": \"2c91c8497df98e6a51bf8c05222af8e7b195847764e4a4407afe2504e0773fc7\"\n },\n {\n \"stake_address\": \"stake1u82mfrr9ztql37er3hy73rtpccuv5fmet2lrrudmzdrm6qgpf22jy\",\n \"amount\": \"244092618\",\n \"active_epoch_no\": 323,\n \"latest_delegation_tx_hash\": \"3594999b3aff5f33490a8ad4611f844efd305782403a8e51067f3ea4721ce821\"\n },\n ...\n {\n \"stake_address\": \"stake1uyzwh2mwjwphgs7kxvd7s8jn640plxf368wj0syftewl0nq06vlqu\",\n \"amount\": \"103417951621\",\n \"active_epoch_no\": 323,\n \"latest_delegation_tx_hash\": \"7193e5702d1cac1255c9dac8efe8368abda5b7b6c58b515467b8e2e1ca07d2be\"\n }\n]\n```\n\n#### get_pool_delegators_history\n\nReturns information about active delegators (incl. history) for a given pool\nand epoch number (all epochs if not specified)\\\nParameters:\\\nStake pool bech32 id\\\nEpoch (optional)\\\nReturns: The list of pool delegators dictionaries\\\nExample:\\\n`pool_delegators_history = get_pool_delegators_history('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 380)`\\\nExample response:\n\n```json\n[\n {\n \"stake_address\": \"stake1uyezz2wzt4rl5wug8ju8zshvfzkw2lksw8jfp0wpueq2nccnnkwxh\",\n \"amount\": \"1043563298281\",\n \"epoch_no\": 380\n },\n {\n \"stake_address\": \"stake1uxptzz4gkehxj5ht85xdjmad5qt0mc00dxmyxd84e2dgrvsla9k0u\",\n \"amount\": \"1010182386722\",\n \"epoch_no\": 380\n },\n ...\n {\n \"stake_address\": \"stake1uxkm4akqqkkt2ayqwnj5wgex4hddgq65st892cz33ez726q9lf3un\",\n \"amount\": \"45053\",\n \"epoch_no\": 380\n }\n]\n```\n\n#### get_pool_blocks\n\nReturns information about blocks minted by a given pool for all epochs\n(or _epoch_no if provided)\\\nParameters:\\\nStake pool bech32 id\\\nEpoch (optional)\\\nReturns: The list of pool blocks dictionaries\\\nExample:\\\n`pool_blocks = get_pool_blocks('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 380)`\\\nExample response:\n\n```json\n[\n {\n \"epoch_no\": 380,\n \"epoch_slot\": 98385,\n \"abs_slot\": 78895185,\n \"block_height\": 8111118,\n \"block_hash\": \"043b2d7b5d125d9f891aa12ad04976be4c3f1ce862b71aff3352dd76be943ae5\",\n \"block_time\": 1670461476\n },\n {\n \"epoch_no\": 380,\n \"epoch_slot\": 381300,\n \"abs_slot\": 79178100,\n \"block_height\": 8125194,\n \"block_hash\": \"c6c811e01decdf241465e5b63684917f48fa11556ff04b22ae46d112703a19dc\",\n \"block_time\": 1670744391\n }\n]\n```\n\n#### get_pool_history\n\nReturns information about pool stake, block and reward history in a given epoch\n(or all epochs that pool existed for, in descending order if no epoch number\nwas provided)\\\nParameters:\\\nStake pool bech32 id\\\nEpoch (optional)\\\nReturns: Information about pool stake, block and reward history as a list\ndictionaries by epoch (descending)\\\nExample:\\\n`pool_history = get_pool_history('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd', 379)`\\\nExample response:\n\n```json\n[\n {\n \"epoch_no\": 379,\n \"active_stake\": \"3158165931346\",\n \"active_stake_pct\": 0.012602983456573744,\n \"saturation_pct\": 4.48,\n \"block_cnt\": 4,\n \"delegator_cnt\": 200,\n \"margin\": 0.0199,\n \"fixed_cost\": \"340000000\",\n \"pool_fees\": \"380697027\",\n \"deleg_rewards\": \"2004379694\",\n \"epoch_ros\": 4.74052366\n }\n]\n```\n\n#### get_pool_updates\n\nReturns all pool updates for all pools or only updates for specific pool\nif specified\\\nParameters: Stake pool bech32 id (optional)\\\nReturns: pool updates as a list of dictionaries\\\nExample:\\\n`pool_updates = get_pool_updates('pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"6358622ef9c7a395aaf1590661330a17095fef3c39caa2ae319c737c85bfacb9\",\n \"block_time\": 1665138387,\n \"pool_id_bech32\": \"pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd\",\n \"pool_id_hex\": \"538299a358e79a289c8de779f8cd09dd6a6bb286de717d1f744bb357\",\n \"active_epoch_no\": 370,\n \"vrf_key_hash\": \"d32b8a284fb259478909aebb4d465d0e2c214ab187d905006da624de023cff7a\",\n \"margin\": 0.0199,\n \"fixed_cost\": \"340000000\",\n \"pledge\": \"25000000000\",\n \"reward_addr\": \"stake1u8mpqafgs22r32cfmkwey9ypjuyl0q0wj2qycxadcjrk0kqu7qh8n\",\n \"owners\": [\n \"stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy\",\n \"stake1uxey9c4w4dlrym6yayltuwmgzucm6068y3spmvan43t2zhs4l9r7f\",\n \"stake1u87djlkkkfehdmxq5zu4nwg7np065kyrr3j38wagcsr56pqc3u0zj\"\n ],\n \"relays\": [\n {\n \"dns\": \"relay1.apexpool.info\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n },\n {\n \"dns\": \"relay2.apexpool.info\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n }\n ],\n \"meta_url\": \"https://apexpool.info/poolmetadata.json\",\n \"meta_hash\": \"82e5f297f2145badd7b03f02a215fc4478772d0df3818e21e36738be48ccc55c\",\n \"meta_json\": null,\n \"pool_status\": \"registered\",\n \"retiring_epoch\": null\n },\n {\n \"tx_hash\": \"0b8fc5e712d6232c2ce2fe64243e6a9ecdc5419a490e929914c2d31d4153e66a\",\n \"block_time\": 1649591452,\n \"pool_id_bech32\": \"pool12wpfng6cu7dz38yduaul3ngfm44xhv5xmech68m5fwe4wu77udd\",\n \"pool_id_hex\": \"538299a358e79a289c8de779f8cd09dd6a6bb286de717d1f744bb357\",\n \"active_epoch_no\": 334,\n \"vrf_key_hash\": \"d32b8a284fb259478909aebb4d465d0e2c214ab187d905006da624de023cff7a\",\n \"margin\": 0.0199,\n \"fixed_cost\": \"340000000\",\n \"pledge\": \"25000000000\",\n \"reward_addr\": \"stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy\",\n \"owners\": [\n \"stake1uxpdrerp9wrxunfh6ukyv5267j70fzxgw0fr3z8zeac5vyqhf9jhy\",\n \"stake1uxey9c4w4dlrym6yayltuwmgzucm6068y3spmvan43t2zhs4l9r7f\",\n \"stake1u87djlkkkfehdmxq5zu4nwg7np065kyrr3j38wagcsr56pqc3u0zj\"\n ],\n \"relays\": [\n {\n \"dns\": \"relay1.apexpool.info\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n },\n {\n \"dns\": \"relay2.apexpool.info\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 6000\n }\n ],\n \"meta_url\": \"https://apexpool.info/poolmetadata.json\",\n \"meta_hash\": \"82e5f297f2145badd7b03f02a215fc4478772d0df3818e21e36738be48ccc55c\",\n \"meta_json\": null,\n \"pool_status\": \"registered\",\n \"retiring_epoch\": null\n },\n ...\n]\n```\n\n#### get_pool_registrations\n\nA list all pool registrations initiated in the requested epoch\\\nParameters: Epoch\\\nReturns: The list of pool registrations\\\nExample:\\\n`pool_registrations = get_pool_registrations(450)`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool1newmccddazerzanrdeeelvzk6vzh9stxn5n8ravshqa05n0t83u\",\n \"tx_hash\": \"02e3644f9bc23e7f0d04addfee80b4f36ba1da774da3c26ec76a7c8ea43a44ac\",\n \"block_hash\": \"8aaec0f14cf462e4fa6e7a3340c85f94c746f4397b027d55202f667bf36843fc\",\n \"block_height\": 9577227,\n \"epoch_no\": 450,\n \"epoch_slot\": 2118,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1q9kwa675j2z53jecrs6pn3fqsc9ypxrsypu5dgu6hammqkagy22\",\n \"tx_hash\": \"56a2a1d4cbb28b09f075a8c1db67f7ad721f003703a1d33aa1b9d9784f1fbccf\",\n \"block_hash\": \"2b3f126ce6381437e9968a6a928a49cd4d1fe09c1cf63648c0fae2bcb4038805\",\n \"block_height\": 9578008,\n \"epoch_no\": 450,\n \"epoch_slot\": 17681,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1yc6f3cqsc7jfh07hcns64v5cp8720mve870pgxf2wkr3u8l7tse\",\n \"tx_hash\": \"5b99ddca8dda03fe9f21be8f36ece2fa22ec97df84d5257f322b948b73e92adb\",\n \"block_hash\": \"2c15575b2ad41a337e375fed103b11eb8f42c086b7cbba23a126c84f24721554\",\n \"block_height\": 9578511,\n \"epoch_no\": 450,\n \"epoch_slot\": 28254,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1m83drqwlugdt9jn7jkz8hx3pne53acfkd539d9cj8yr92dr4k9y\",\n \"tx_hash\": \"42e10b531d571b9a750425c722e8093e6c447e5c5ba5d1ac9357aea179e597c0\",\n \"block_hash\": \"272e94bab3c3a15c440e1e1bf9e430ad3d52d6c536bf60f5ba7ac56a16183d89\",\n \"block_height\": 9578947,\n \"epoch_no\": 450,\n \"epoch_slot\": 36901,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1cuhcw4dhj577rzz847q5swfvrnthj2vn62hry6ljzp6g6v3ag77\",\n \"tx_hash\": \"7c49f3d0360a10526c709b4bcddb33f31e1f74b005b5238eaddde2e4021f9630\",\n \"block_hash\": \"3419666414394246cc24469409acd82f28995fcf3c58f860f7195dbcc1fe266a\",\n \"block_height\": 9580008,\n \"epoch_no\": 450,\n \"epoch_slot\": 58006,\n \"active_epoch_no\": 452\n },\n {\n \"pool_id_bech32\": \"pool1l6aeyn35nkqkn9lqqlwqnpraakdzuukjrqprcrj3sctk6hhe32k\",\n \"tx_hash\": \"d2a105e8c0822cbd22748c4aa18c28dfd0418709a98c316c32eb44c0d9c7e6d4\",\n \"block_hash\": \"608fb2ebef32d8b10858c726c0a277b627423357eb2f79d739750af80b181131\",\n \"block_height\": 9580897,\n \"epoch_no\": 450,\n \"epoch_slot\": 76704,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1uct8k7ruvu3dgl9hws4pj3tk9stzpls4evnys4r8q5vj2p9w92w\",\n \"tx_hash\": \"27b530a2a786a127277786acf831096b0f1b1f5ae83ce91dfabdb0f7c65b1aa7\",\n \"block_hash\": \"9552a30577df9acad319e2684b850f74f3f559df137b70efe670822bb1834607\",\n \"block_height\": 9581443,\n \"epoch_no\": 450,\n \"epoch_slot\": 88553,\n \"active_epoch_no\": 452\n },\n {\n \"pool_id_bech32\": \"pool1n940lfxkd7z73qzj5y554yrletrmgg5x2eya9tpglh3uwcqfnud\",\n \"tx_hash\": \"4d389be4801cc2b434913eaec34f21aa1cf531db390c63efa57fe3989cefa70b\",\n \"block_hash\": \"f1867fe6bcd19fd6b01f25c9b1c976c16d4b5be7ba8b195c8ccb2e80f959c1e7\",\n \"block_height\": 9583181,\n \"epoch_no\": 450,\n \"epoch_slot\": 125441,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool13hxlxd6qa68fmfhrvvmasa0mjg30tj9p5v2lmgmgsmrp2rgzkfp\",\n \"tx_hash\": \"cdf6afa4b2937f3cd66cceedbeb21fddccea4d05502e5081009d5aba3503002b\",\n \"block_hash\": \"bd4b98742aba98ff82271b3652609ecb85a3ded9320f0f64a66aed436f58ebd9\",\n \"block_height\": 9587487,\n \"epoch_no\": 450,\n \"epoch_slot\": 213334,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment\",\n \"tx_hash\": \"44994b6b060e4e80e16bc698de63379d0097db856184d989cc0795d87ad9b7fe\",\n \"block_hash\": \"e05cd9b36fb762a58d72d18618b491586afe29360f76740d55ea757a09411795\",\n \"block_height\": 9588831,\n \"epoch_no\": 450,\n \"epoch_slot\": 242054,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment\",\n \"tx_hash\": \"09cb3e784b8ee4173645b1e11fc8bd2d713d7fc1b364c9611eef673be4eae582\",\n \"block_hash\": \"7aeec2cdc64e5cd1c61c173a84986e50f511637d3fe22822c34212e26f8c6210\",\n \"block_height\": 9588884,\n \"epoch_no\": 450,\n \"epoch_slot\": 243186,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1nrmlaqy77txzd4lrayx92x76hmv97sldqgntqc49a820sf4ment\",\n \"tx_hash\": \"7aa6b0d94d87783d73176a39238a3cabc62a27df43cd2762c229c51fa602660d\",\n \"block_hash\": \"42a01085d4f264829f11019bfe3fb670e7e61935dd30b63a5c4ebb7093ee4fd1\",\n \"block_height\": 9589567,\n \"epoch_no\": 450,\n \"epoch_slot\": 256996,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool18qahj5ggudguk69g9aaztf5dvapmazql4hdvd7v0947j7gy4wqf\",\n \"tx_hash\": \"1179715221bc784df721c194602029a6a62085766bbc16db622cbd2d0d974faf\",\n \"block_hash\": \"eb9cd7d9566d497f6376971ba7c4d95fa428b1be586b66c89c694a0775d7de4c\",\n \"block_height\": 9591466,\n \"epoch_no\": 450,\n \"epoch_slot\": 297514,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool15zn2lqq4849ujttuthaycpamnyr8ae9k2pn2fkrlfzzsx4ek0tc\",\n \"tx_hash\": \"175bf0a069d8e0346218adf9cee275587e7e84a46e9675f6fca38869accd94d4\",\n \"block_hash\": \"ab68b679dc821c949b93732add66c4971939c24396f1b2399a17932e9b250811\",\n \"block_height\": 9591954,\n \"epoch_no\": 450,\n \"epoch_slot\": 308121,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1c2utlagkpht4zj0jetsf245c258geuxnjqp9kf4f2z9rutx9dz4\",\n \"tx_hash\": \"3be74ebb172cfc2ac41082f3a3c8973f02c6cb9799bf6f67959bd694626747b2\",\n \"block_hash\": \"1b1166be3f20cd632babf0bd93e4c5a83be0593de0da713d042ee1eddf1ae9ba\",\n \"block_height\": 9593244,\n \"epoch_no\": 450,\n \"epoch_slot\": 334101,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool12jnulzs7j8lsku4r2a7q6tee6tt66872vwhqh8jxvgzn6837jtl\",\n \"tx_hash\": \"016e41bb64e7035476dff7d9dcace3bb6b16ae51e4b3c6da2674be590cd93ac7\",\n \"block_hash\": \"2c654e3fb4175ae986959511b35523d5a2ff4efb67a13a0ff37a97000f86950c\",\n \"block_height\": 9593277,\n \"epoch_no\": 450,\n \"epoch_slot\": 334984,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool18a8vhtlcz7t0mahmfdlgtpsspvae62egz936j3dt7f9ykr4j2av\",\n \"tx_hash\": \"7f96bfaca34138de9655119b41b3f34c43adbd4718c0a2d54c3616b546a0ffc8\",\n \"block_hash\": \"0c8e16208e52471e358580e200a9821ef96a44a9bdf93cd8a5e7a958b90388a9\",\n \"block_height\": 9593628,\n \"epoch_no\": 450,\n \"epoch_slot\": 342344,\n \"active_epoch_no\": 452\n },\n {\n \"pool_id_bech32\": \"pool1vz59e00250xfjck8qd04kns89j56430wjzpdf37zfjnnyxttm37\",\n \"tx_hash\": \"75f3103f3f8d403eb304591d798ae3e3f50f06bd666daa821ebc09e9b945d635\",\n \"block_hash\": \"bc0f759ecd13ca14806186a6a51efc055c62b0cb58133c1dfb0d85ed4133b894\",\n \"block_height\": 9593801,\n \"epoch_no\": 450,\n \"epoch_slot\": 345816,\n \"active_epoch_no\": 453\n },\n {\n \"pool_id_bech32\": \"pool1vz59e00250xfjck8qd04kns89j56430wjzpdf37zfjnnyxttm37\",\n \"tx_hash\": \"d2da61083e80d53d965df6a7cd15ab951668bb1b813ab5b24066b37e9a98540b\",\n \"block_hash\": \"a98dcc8c557d4e09a41aa2188bd0ea0f25339924c41c408bcdc394b5b2b863a3\",\n \"block_height\": 9593950,\n \"epoch_no\": 450,\n \"epoch_slot\": 349251,\n \"active_epoch_no\": 453\n }\n]\n```\n\n#### get_pool_retirements\n\nA list all pool retirements initiated in the requested epoch\\\nParameters: Epoch\\\nReturns: The list of pool retirements\\\nExample:\\\n`pool_retirements = get_pool_retirements(450)`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool1xzfrmeux886ckdm2ekk3t3xe2ch5666m7zxa6dt0zrfm5mq2ksm\",\n \"tx_hash\": \"5f3bd9d5f64a198536ac02b13e45f24732cca0c818fc10313995763890e5976a\",\n \"block_hash\": \"aee6a51b81927d692e98e461ab70fe0c3b0474dfaafba50d94031e4359ef2d8a\",\n \"block_height\": 9579834,\n \"epoch_no\": 450,\n \"epoch_slot\": 54556,\n \"active_epoch_no\": 451\n },\n {\n \"pool_id_bech32\": \"pool1m7rvxkzc6rseh8axp7ckk7kwlqzctnvqc4lqq5w84sn4g4j4e90\",\n \"tx_hash\": \"a90f15070843765554f380636101eab57eb41c1055d099d13fd940715081eb04\",\n \"block_hash\": \"2d0843e1fcb595a98efa7d63db61b9756a474a15d090841b73e0e66d3df20e55\",\n \"block_height\": 9584807,\n \"epoch_no\": 450,\n \"epoch_slot\": 158485,\n \"active_epoch_no\": 451\n },\n {\n \"pool_id_bech32\": \"pool1g3wjq2yyg7hxteky9eym8fhc9xdtut63ss46a96gxndhqjgerqv\",\n \"tx_hash\": \"26cdc11b9fd7412758c8dad42a4b0bd76776fb9d711e3d649a5152441555e8b9\",\n \"block_hash\": \"aef604b4f652b6e276f206c204e30e38c2c17894f6e5e388b75cbeba5f88e784\",\n \"block_height\": 9593197,\n \"epoch_no\": 450,\n \"epoch_slot\": 332983,\n \"active_epoch_no\": 451\n }\n]\n```\n\n#### get_pool_relays\n\nA list of registered relays for all currently registered/retiring\n(not retired) pools\\\nParameters: none\\\nReturns: The list of relays dictionaries by stake pool\\\nExample:\\\n`pool_relays = get_pool_relays()`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool100wj94uzf54vup2hdzk0afng4dhjaqggt7j434mtgm8v2gfvfgp\",\n \"relays\": [\n {\n \"dns\": null,\n \"srv\": null,\n \"ipv4\": \"165.232.146.185\",\n \"ipv6\": null,\n \"port\": 3000\n }\n ]\n },\n {\n \"pool_id_bech32\": \"pool102s2nqtea2hf5q0s4amj0evysmfnhrn4apyyhd4azcmsclzm96m\",\n \"relays\": []\n },\n ...\n {\n \"pool_id_bech32\": \"pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6\",\n \"relays\": [\n {\n \"dns\": null,\n \"srv\": null,\n \"ipv4\": \"45.13.59.72\",\n \"ipv6\": null,\n \"port\": 6000\n },\n {\n \"dns\": null,\n \"srv\": null,\n \"ipv4\": \"45.13.59.73\",\n \"ipv6\": null,\n \"port\": 6000\n }\n ]\n },\n ...\n]\n```\n\n#### get_pool_metadata\n\nA list of registered relays for all currently registered/retiring\n(not retired) pools\\\nParameters: Stake pool bech32 ID(s) as string (for one stake pool)\nor list of stake pool bech32 IDs (for multiple stake pools)\\\nReturns: The list of pool metadata dictionaries\\\nExample:\\\n`pool_metadata = get_pool_metadata('pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6')`\\\nExample response:\n\n```json\n[\n {\n \"pool_id_bech32\": \"pool1auvwj75q70s7jce63nvptujs6460kvyxqn0wjegkz4mhja7g5t6\",\n \"meta_url\": \"https://git.io/J1yfm\",\n \"meta_hash\": \"e123e7e59922deab90ff06642500c69cafe03933f0854b1534a829cbae2cf472\",\n \"meta_json\": {\n \"name\": \"Innovatio\",\n \"ticker\": \"INNV\",\n \"homepage\": \"https://www.innovatiofounder.com/\",\n \"description\": \"Pool focused on the expansion of the Innovatio brand and its financial services and to the support of the community of entrepreneurs and freelancers of the blockchain ecosystem\"\n }\n }\n]\n```\n\n#### get_retiring_pools\n\nGet the retiring stake pools list\\\nParameters: none\\\nReturns: The list of retiring pools dictionaries\\\nExample:\\\n`retiring_pools = get_retiring_pools()`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"39a046ef9b5b9e149d24bae8c86f6fb93b08d57312615d22b6a3e73279198e73\",\n \"block_time\": 1667610905,\n \"pool_id_bech32\": \"pool1a8z4kxgsul7u4nedkxlx7g86mlcwt45dv4ntygmfsqc6kdse5c7\",\n \"pool_id_hex\": \"e9c55b1910e7fdcacf2db1be6f20fadff0e5d68d6566b223698031ab\",\n \"active_epoch_no\": 375,\n \"vrf_key_hash\": \"8ad95d9965ca817e7d7d5d6985ba4c92b77a206250fa59f52acb6ab36507c79b\",\n \"margin\": 0,\n \"fixed_cost\": \"340000000\",\n \"pledge\": \"2000000\",\n \"reward_addr\": \"stake1uyyyeu9dl8l8tvly08nvsdm8dwu9q94w3ywxyn84jqz2qzgm6a42u\",\n \"owners\": [\n \"stake1uyyyeu9dl8l8tvly08nvsdm8dwu9q94w3ywxyn84jqz2qzgm6a42u\"\n ],\n \"relays\": [\n {\n \"dns\": null,\n \"srv\": null,\n \"ipv4\": \"158.140.192.143\",\n \"ipv6\": null,\n \"port\": 3001\n }\n ],\n \"meta_url\": \"https://raw.githubusercontent.com/etsraphael/Cardano/p/p.json\",\n \"meta_hash\": \"dee0758d3212808f99698e96446dd9400b4455d5c44286f91f66dd6c5796d064\",\n \"meta_json\": null,\n \"pool_status\": \"retiring\",\n \"retiring_epoch\": 391\n },\n {\n \"tx_hash\": \"e91b2fe2fdd88af555ff28a4e9bc0c2cd0d7d403f84bf76095ddef9696960222\",\n \"block_time\": 1623852340,\n \"pool_id_bech32\": \"pool14y230zspjkhezehue4p2d9q87xh3p8a0vnpugzdty7gwcruepps\",\n \"pool_id_hex\": \"a915178a0195af9166fccd42a69407f1af109faf64c3c409ab2790ec\",\n \"active_epoch_no\": 275,\n \"vrf_key_hash\": \"fc9af9335415593f9c4f171aded1fd80cb69a0e1e663a978572ace376f0a4f11\",\n \"margin\": 0,\n \"fixed_cost\": \"340000000\",\n \"pledge\": \"12000000000\",\n \"reward_addr\": \"stake1uyam20k8v2azz38r2jf499udyru7qfs4flaefc05h9546cqjmjnmr\",\n \"owners\": [\n \"stake1uyam20k8v2azz38r2jf499udyru7qfs4flaefc05h9546cqjmjnmr\"\n ],\n \"relays\": [\n {\n \"dns\": \"relay1.faststakepool.com\",\n \"srv\": null,\n \"ipv4\": null,\n \"ipv6\": null,\n \"port\": 3000\n }\n ],\n \"meta_url\": \"https://raw.githubusercontent.com/FASTstakepool/meta/master/data\",\n \"meta_hash\": \"64bdb12028955b248b2d61467aedba30388a95d175636b3b042e9c69aa710dd4\",\n \"meta_json\": null,\n \"pool_status\": \"retiring\",\n \"retiring_epoch\": 392\n },\n ...\n```\n\n### Script\n\n#### get_script_info\n\nList of script information for given script hashes\\\nParameters: Script hash(es) as string (for one script hash) or list\n(for a list of script hashes)\\\nReturns The list of information for the requested scripts\\\nExample:\\\n`script_info = get_script_info('2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9')`\\\nExample response:\n\n```json\n[\n {\n \"script_hash\": \"2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9\",\n \"creation_tx_hash\": \"2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28\",\n \"type\": \"plutusV2\",\n \"value\": null,\n \"bytes\": \"5906ce010000...4980101010001\",\n \"size\": 1745\n }\n]\n```\n\n#### get_native_script_list\n\nList of all existing native script hashes along with their creation\ntransaction hashes\\\nParameters: none\\\nReturns: The list of all native scripts dictionaries\\\nExample:\\\n`native_script_list = get_native_script_list()`\\\nExample response:\n\n```json\n[\n {\n \"script_hash\": \"65c197d565e88a20885e535f93755682444d3c02fd44dd70883fe89e\",\n \"creation_tx_hash\": \"4a3f86762383f1d228542d383ae7ac89cf75cf7ff84dec8148558ea92b0b92d0\",\n \"type\": \"timelock\",\n \"script\": {\n \"type\": \"all\",\n \"scripts\": [\n {\n \"type\": \"sig\",\n \"keyHash\": \"a96da581c39549aeda81f539ac3940ac0cb53657e774ca7e68f15ed9\"\n },\n {\n \"type\": \"sig\",\n \"keyHash\": \"ccfcb3fed004562be1354c837a4a4b9f4b1c2b6705229efeedd12d4d\"\n },\n {\n \"type\": \"sig\",\n \"keyHash\": \"74fcd61aecebe36aa6b6cd4314027282fa4b41c3ce8af17d9b77d0d1\"\n }\n ]\n }\n },\n {\n \"script_hash\": \"00000002df633853f6a47465c9496721d2d5b1291b8398016c0e87ae\",\n \"creation_tx_hash\": \"e252be4c7e40d35919f741c9649ff207c3e49d53bb819e5c1cb458055fd363ed\",\n \"type\": \"timelock\",\n \"script\": {\n \"type\": \"all\",\n \"scripts\": [\n {\n \"slot\": 24285375,\n \"type\": \"before\"\n },\n {\n \"type\": \"sig\",\n \"keyHash\": \"e97316c52c85eab276fd40feacf78bc5eff74e225e744567140070c3\"\n }\n ]\n }\n },\n ...\n]\n```\n\n#### get_plutus_script_list\n\nList of all existing native script hashes along with their creation\ntransaction hashes\\\nParameters: none\\\nReturns: The list of all plutus scripts dictionaries\\\nExample:\\\n`plutus_script_list = get_plutus_script_list()`\\\nExample response:\n\n```json\n[\n {\n \"script_hash\": \"c916b3d14a51087cc967223aad3f2e4e5c01993f5429719c32c2061e\",\n \"creation_tx_hash\": \"ed96d6ee90c6e8e5828b0b4f5fbdcbefc28d8b7e689ac4605da56c9c58a7cd96\"\n },\n {\n \"script_hash\": \"c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261\",\n \"creation_tx_hash\": \"fa36280a65610f0171bcfdb3812bc0f0f6312c08cfb39c3419287bc1d654a4ae\"\n },\n {\n \"script_hash\": \"2161af28e544066081a36a85857f8894910984ea50f5a7a1d7a345e2\",\n \"creation_tx_hash\": \"21aabf5a3f1b9162ea12d49c94c110a89c5702f0ebdb3390b40110b22a750326\"\n },\n ...\n]\n```\n\n#### get_script_redeemers\n\nList of all redeemers for a given script hash\\\nParameters: Script hash\\\nReturns: Redeemers list as dictionary\\\nExample:\\\n`script_redeemers = get_script_redeemers('c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261')`\\\nExample response:\n\n```json\n[\n {\n \"script_hash\": \"c1996b36d11bf42103745844cc5ee9bf13fde475fa909809e2da7261\",\n \"redeemers\": [\n {\n \"tx_hash\": \"fa36280a65610f0171bcfdb3812bc0f0f6312c08cfb39c3419287bc1d654a4ae\",\n \"tx_index\": 0,\n \"unit_mem\": 1197950,\n \"unit_steps\": 491845099,\n \"fee\": \"104584\",\n \"purpose\": \"mint\",\n \"datum_hash\": \"45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0\",\n \"datum_value\": {\n \"list\": []\n }\n }\n ]\n }\n]\n```\n\n#### get_script_utxos\n\nList of all UTxOs for a given script hash\\\nParameters:\\\nScript hash: The script hash\\\nExtended: Boolean which controls whether certain optional fields supported\\\nby a given endpoint are populated as a part of the request\\\nReturns: The list of UTxOs for a given script hash\\\nExample:\\\n`script_utxos = get_script_utxos('2e221993d37997f1023ad2b207bf75ef0e206de840224c63e94bacc9')`\\\nExample response:\n\n```json\n[\n {\n \"tx_hash\": \"2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28\",\n \"tx_index\": 0,\n \"address\": \"addr1zy7z86jxa4dyflaf3rwpt5jlnrdahkt2r4737khf7huv9q5nc4gwrvu5dcuccayqddwpx0l492czzxp7929792qv4grqnc0lf0\",\n \"value\": \"200000000\",\n \"stake_address\": \"stake1uxfu258pkw2xuwvvwjqxkhqn8l6j4vpprqlz4zlz4qx25ps4mt0qn\",\n \"payment_cred\": \"3c23ea46ed5a44ffa988dc15d25f98dbdbd96a1d7d1f5ae9f5f8c282\",\n \"epoch_no\": 449,\n \"block_height\": 9564735,\n \"block_time\": 1700347692,\n \"datum_hash\": \"51fa1feba19dd159a13098a686ad8eb7c273012fc4f64497d474cc322d3578cf\",\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": false\n },\n {\n \"tx_hash\": \"2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28\",\n \"tx_index\": 2,\n \"address\": \"addr1qxxedmtge6np74z5nd9hu72fak9zntc6zu2434u82pnvjmcr378a5cgtgsn6ktj22vew8z9rtrxddfkrh574q28kek0qrtfjqq\",\n \"value\": \"263206568\",\n \"stake_address\": \"stake1uypclr76vy95gfat9e99xvhr3z343nxk5mpm602s9rmvm8synpexp\",\n \"payment_cred\": \"8d96ed68cea61f54549b4b7e7949ed8a29af1a171558d7875066c96f\",\n \"epoch_no\": 449,\n \"block_height\": 9564735,\n \"block_time\": 1700347692,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": true\n },\n {\n \"tx_hash\": \"2da2b7f9b5bd4961e7d347aeed9feeef23f66c1c6d9016d9f8536f8d39445e28\",\n \"tx_index\": 1,\n \"address\": \"addr1qxxedmtge6np74z5nd9hu72fak9zntc6zu2434u82pnvjmcr378a5cgtgsn6ktj22vew8z9rtrxddfkrh574q28kek0qrtfjqq\",\n \"value\": \"1262830\",\n \"stake_address\": \"stake1uypclr76vy95gfat9e99xvhr3z343nxk5mpm602s9rmvm8synpexp\",\n \"payment_cred\": \"8d96ed68cea61f54549b4b7e7949ed8a29af1a171558d7875066c96f\",\n \"epoch_no\": 449,\n \"block_height\": 9564735,\n \"block_time\": 1700347692,\n \"datum_hash\": null,\n \"inline_datum\": null,\n \"reference_script\": null,\n \"asset_list\": null,\n \"is_spent\": true\n }\n]\n```\n\n#### get_datum_info\n\nList of datum information for given datum hashes\\\nParameters: Datum hash(es) as string (for one datum hash) or list\n(for a list of datum hashes)\\\nReturns Datum information as list of dictionaries\\\nExample:\\\n`datum_info = get_datum_info('45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0')`\\\nExample response:\n\n```json\n[\n {\n \"hash\": \"45b0cfc220ceec5b7c1c62c4d4193d38e4eba48e8815729ce75f9c0ab0e4c1c0\",\n \"value\": {\n \"list\": []\n },\n \"bytes\": \"80\"\n }\n]\n```\n\n### Ogmios\n\n#### ogmios\n\nMultiple ogmios queries are supported, you can read about them\\\n[here](https://api.koios.rest/#tag--Ogmios).\n\nQuery Examples\n\nQuery the current tip of the Network\\\nExample:\\\n`tip = get_ogmios(\"2.0\", \"queryNetwork/tip\")`\\\nExample response:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"queryNetwork/tip\",\n \"result\": {\n \"slot\": 109429505,\n \"id\": \"d7d8b03d8f2def0b2239f17374900e281bbe548fbaaa45b014baac8c8a1bd48b\"\n },\n \"id\": null\n}\n```\n\nQuery the current block height\\\nExample:\\\n`block_height = get_ogmios(\"2.0\", \"queryNetwork/blockHeight\")`\\\nExample response:\\\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"queryNetwork/blockHeight\",\n \"result\": 9596049,\n \"id\": null\n}\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "A python package for the Cardano Blockchain Koios API (https://api.koios.rest/)",
"version": "1.1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/cardano-apexpool/koios-api-python/issues",
"Homepage": "https://github.com/cardano-apexpool/koios-api-python"
},
"split_keywords": [
"koios",
"cardano",
"blockchain",
"rest",
"api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f8e74a44ef10cbd4f0c4078e3eaf294c8f17cb75e5869c09bb9ffbb963e56e78",
"md5": "b1dd4aec71006e749215c18d2a7c2b65",
"sha256": "626f4ece5fdc600c1de1b1fc966f2261c9caf3a444d5f0aa87c89da367af1931"
},
"downloads": -1,
"filename": "koios_api-1.1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1dd4aec71006e749215c18d2a7c2b65",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 44926,
"upload_time": "2024-01-16T14:44:25",
"upload_time_iso_8601": "2024-01-16T14:44:25.048216Z",
"url": "https://files.pythonhosted.org/packages/f8/e7/4a44ef10cbd4f0c4078e3eaf294c8f17cb75e5869c09bb9ffbb963e56e78/koios_api-1.1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-16 14:44:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cardano-apexpool",
"github_project": "koios-api-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "koios-api"
}
