Blockfrost
Documentation Powered by ReDoc

Blockfrost.io ~ API Documentation (0.1.3)

Download OpenAPI specification:Download

Blockfrost Team: contact@blockfrost.io URL: https://blockfrost.io License: MIT Terms of Service

Blockfrost is an API as a service that allows users to interact with the Cardano blockchain and parts of its ecosystem.

Authentication

After signing up on https://blockfrost.io, a project_id token is automatically generated for each project. HTTP header of your request MUST include this project_id in order to authenticate against Blockfrost servers.

Available networks

At the moment, you can use the following networks. Please, note that each network has its own project_id.

NetworkEndpoint
Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano testnethttps://cardano-testnet.blockfrost.io/api/v0

Concepts

  • All endpoints return either a JSON object or an array.
  • Data is returned in ascending (oldest first, newest last) order.
    • You might use the ?order=desc query parameter to reverse this order.
  • By default, we return 100 results at a time. You have to use ?page=2 to list through the results.
  • All time and timestamp related fields are in milliseconds of UNIX time.
  • All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces
  • Addresses, accounts and pool IDs are in Bech32 format
  • Examples are not based on real data. Any resemblance to actual events is purely coincidental.

Errors

HTTP Status codes

The following are HTTP status code your application might receive when reaching Blockfrost's endpoints and it should handle all of these cases.

  • HTTP 400 return code is used when the request is not valid.
  • HTTP 403 return code is used when the request is not authenticated.
  • HTTP 404 return code is used when the resource doesn't exist.
  • HTTP 429 return code is used when the project exceeded its request rate limit.
  • HTTP 418 return code is used when the IP has been auto-banned for flooding too much after previously receiving error code 429.
  • HTTP 500 return code is used when our endpoints are having a problem.

Error codes

An internal error code number is used for better indication of the error in question. It is passed using the following payload.

{
  "status_code": 403,
  "error": "Forbidden",
  "message": "Invalid project token."
}

Limits

There are two types of limits we are enforcing. The first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time. The second is rate limiting, where we limit an end user to 10 requests per second after a period of 5 second burst. We believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and we will make sure to take it into account as much as we can.

Authentication

ApiKeyAuth

Security Scheme Type API Key
Header parameter name: project_id

Health

Root endpoint

Root endpoint has no other function than to point end users to documentation.

Responses

Response samples

Content type
application/json
{}

Backend health status

Return backend status as a boolean. Your application should handle situations when backend for the given chain is unavailable.

Responses

Response samples

Content type
application/json
{
  • "is_healthy": true
}

Current backend time

This endpoint provides the current UNIX time. Your application might use this to verify if the client's clock is not out of sync.

Responses

Response samples

Content type
application/json
{
  • "server_time": 1603400958947
}

Blocks

Latest block

Return the latest block available to the backends, also known as the tip of the blockchain.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "time": 1641338934,
  • "height": 15243593,
  • "hash": "4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a",
  • "slot": 412162133,
  • "epoch": 425,
  • "epoch_slot": 12,
  • "slot_leader": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy",
  • "size": 3,
  • "tx_count": 1,
  • "output": "128314491794",
  • "fees": "592661",
  • "block_vrf": "vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Specific block

Return the content of a requested block.

Authorizations:
ApiKeyAuth
path Parameters
hash_or_number
required
string <64-character case-sensitive hexadecimal string or block number.>
Example: 4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a

Hash of the requested block.

Responses

Response samples

Content type
application/json
{
  • "time": 1641338934,
  • "height": 15243593,
  • "hash": "4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a",
  • "slot": 412162133,
  • "epoch": 425,
  • "epoch_slot": 12,
  • "slot_leader": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy",
  • "size": 3,
  • "tx_count": 1,
  • "output": "128314491794",
  • "fees": "592661",
  • "block_vrf": "vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Listing of next blocks

Return the list of blocks following a specific block.

Authorizations:
ApiKeyAuth
path Parameters
hash_or_number
required
string <64-character case-sensitive hexadecimal string or block number.>
Example: 5ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a

Hash of the requested block.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Listing of previous blocks

Return the list of blocks preceding a specific block.

Authorizations:
ApiKeyAuth
path Parameters
hash_or_number
required
string <64-character case-sensitive hexadecimal string or block number.>
Example: 4873401

Hash of the requested block

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Block's transactions

Return the transactions within the block.

Authorizations:
ApiKeyAuth
path Parameters
hash_or_number
required
string <64-character case-sensitive hexadecimal string or block number.>
Example: 4873401

Hash of the requested block.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

Ordered by tx index in the block. The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b",
  • "4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036",
  • "52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f",
  • "e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"
]

Epochs

Latest epoch

Return the information about the latest, therefore current, epoch.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "epoch": 225,
  • "start_time": 1603403091,
  • "end_time": 1603835086,
  • "first_block_time": 1603403092,
  • "last_block_time": 1603835084,
  • "block_count": 21298,
  • "tx_count": 17856,
  • "output": "7849943934049314",
  • "fees": "4203312194",
  • "active_stake": "784953934049314"
}

Specific epoch

Return the content of the requested epoch.

Authorizations:
ApiKeyAuth
path Parameters
number
required
string
Example: 225

Number of the epoch

Responses

Response samples

Content type
application/json
{
  • "epoch": 225,
  • "start_time": 1603403091,
  • "end_time": 1603835086,
  • "first_block_time": 1603403092,
  • "last_block_time": 1603835084,
  • "block_count": 21298,
  • "tx_count": 17856,
  • "output": "7849943934049314",
  • "fees": "4203312194",
  • "active_stake": "784953934049314"
}

Listing of next epochs

Return the list of epochs following a specific epoch.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the requested epoch.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Listing of previous epochs

Return the list of epochs preceding a specific epoch.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Stake distribution

Return the active stake distribution for the epoch specified.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Stake distribution by pool

Return the active stake distribution for the epoch specified by stake pool.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Stake pool ID to filter

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Block distribution

Return the blocks minted for the epoch specified.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e",
  • "38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878",
  • "f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"
]

Block distribution

Return the block minted for the epoch specified by stake pool.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Stake pool ID to filter

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e",
  • "38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878",
  • "f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"
]

Protocol parameters

Return the protocol parameters for the epoch specified.

Authorizations:
ApiKeyAuth
path Parameters
number
required
integer
Example: 225

Number of the epoch

Responses

Response samples

Content type
application/json
{
  • "min_fee_a": 44,
  • "min_fee_b": 155381,
  • "max_block_size": 65536,
  • "max_tx_size": 16384,
  • "max_block_header_size": 1100,
  • "key_deposit": "2000000",
  • "pool_deposit": "500000000",
  • "e_max": 18,
  • "n_opt": 150,
  • "a0": 0.3,
  • "rho": 0.003,
  • "tau": 0.2,
  • "decentralisation_param": 0.5,
  • "extra_entropy": null,
  • "protocol_major_ver": 2,
  • "protocol_minor_ver": 0,
  • "min_utxo": "1000000",
  • "min_pool_cost": "340000000",
  • "nonce": "1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81"
}

Transactions

Specific transaction

Return content of the requested transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string.>
Example: 6e5f825c42c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
{
  • "block": "356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940",
  • "index": 1,
  • "output_amount": [
    ],
  • "fees": "182485",
  • "deposit": "0",
  • "size": 433,
  • "invalid_before": null,
  • "invalid_hereafter": 13885913,
  • "utxo_count": 4,
  • "withdrawal_count": 0,
  • "delegation_count": 0,
  • "stake_cert_count": 0,
  • "pool_update_count": 0,
  • "pool_retire_count": 0
}

Transaction's UTXOs

Return the inputs and UTXOs of the specific transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
{
  • "inputs": [
    ],
  • "outputs": [
    ]
}

Trasanction's stake addresses certificates

Obtain information about (de)registration of stake addresses within a transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string.>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Transaction's delegation certificates

Obtain information about delegation certificates of a specific transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Transaction's withdrawal

Obtain information about withdrawals of a specific transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Transaction's stake pool registration and update certificates

Obtain information about stake pool registration and update certificates of a specific transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Transaction's stake pool retirement certificates

Obtain information about stake pool retirements within a specific transaction.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string.>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Transaction's metadata

Obtain the transaction metadata.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string.>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Transaction's metadata in CBOR

Obtain the transaction metadata in CBOR.

Authorizations:
ApiKeyAuth
path Parameters
hash
required
string <64-character case-sensitive hexadecimal string.>
Example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b

Hash of the requested transaction

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Submit a transaction

Submit a signed transaction message binary blob to the network.

Authorizations:
ApiKeyAuth
header Parameters
Content-Type
required
string
Value: "application/octet-stream"

Responses

Response samples

Content type
application/json
{
  • "id": "d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"
}

Metadata

Transaction metadata labels

List of all used transaction metadata labels.

Authorizations:
ApiKeyAuth
query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Transaction metadata content in JSON

Transaction metadata per label.

Authorizations:
ApiKeyAuth
path Parameters
label
required
string
Example: 1990

Metadata label

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Transaction metadata content in CBOR

Transaction metadata per label.

Authorizations:
ApiKeyAuth
path Parameters
label
required
string
Example: 1990

Metadata label

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Pools

List of stake pools

List of registered stake pools.

Authorizations:
ApiKeyAuth
query Parameters
count
integer <= 100
Default: 100

The numbers of pools per page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
  • "pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288",
  • "pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2"
]

List of retired stake pools

List of already retired pools.

Authorizations:
ApiKeyAuth
query Parameters
count
integer <= 100
Default: 100

The numbers of pools per page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

List of retiring stake pools

List of stake pools retiring in the upcoming epochs

Authorizations:
ApiKeyAuth
query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Specific stake pool

Pool information.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

Responses

Response samples

Content type
application/json
{
  • "vrf_key": "0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233",
  • "blocks_minted": 69,
  • "live_stake": "6900000000",
  • "live_size": 0.42,
  • "live_saturation": 0.93,
  • "live_delegators": 127,
  • "active_stake": "4200000000",
  • "active_size": 0.43,
  • "declared_pledge": "5000000000",
  • "live_pledge": "5000000001",
  • "margin_cost": 0.05,
  • "fixed_cost": "340000000",
  • "reward_address": "stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f",
  • "owners": [
    ],
  • "registration": [
    ],
  • "retirement": [
    ]
}

Stake pool history

History of stake pool parameters over epochs.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Stake pool metadata

Stake pool registration metadata.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

Responses

Response samples

Content type
application/json
Example
pool_metadata
pool_metadata
empty_object
{}

Stake pool relays

Relays of a stake pool.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

Responses

Response samples

Content type
application/json
[]

Stake pool delegators

List of current stake pools delegators.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Stake pool blocks

List of stake pools blocks.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d",
  • "026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c",
  • "bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c",
  • "86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7"
]

Stake pool updates

List of certificate updates to the stake pool.

Authorizations:
ApiKeyAuth
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Accounts

Specific account address

Obtain information about a specific stake account.

Authorizations:
ApiKeyAuth
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake addresses

Responses

Response samples

Content type
application/json
{
  • "active": true,
  • "active_epoch": 412,
  • "controlled_amount": "619154618165",
  • "rewards_sum": "319154618165",
  • "withdrawals_sum": "12125369253",
  • "reserves_sum": "319154618165",
  • "treasury_sum": "12000000",
  • "withdrawable_amount": "319154618165",
  • "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"
}

Account's reward history

Obtain information about the history of a specific account.

Authorizations:
ApiKeyAuth
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake addresses

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Account's history

Obtain information about the history of a specific account.

Authorizations:
ApiKeyAuth
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake addresses

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Account's delegation history

Obtain information about the delegation of a specific account.

Authorizations:
ApiKeyAuth
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake addresses

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Account's registration history

Obtain information about the registrations and deregistrations of a specific account.

Authorizations:
ApiKeyAuth
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake addresses

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Addresses

Specific address

Obtain information about a specific address.

Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 addresses.

Responses

Response samples

Content type
application/json
{
  • "amount": [
    ],
  • "stake_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
  • "type": "shelley"
}

Address' details

Obtain details about an address.

Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 addresses.

Responses

Response samples

Content type
application/json
{
  • "received_sum": [
    ],
  • "sent_sum": [
    ],
  • "tx_count": 12
}

Address' UTXOs

UTXOs of the address.

Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 addresses

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

Ordered by tx index in the block. The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Address' transactions

Transactions on the address.

Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 addresses.

query Parameters
count
integer <= 100
Default: 100

The numbers of pools per page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • "2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531",
  • "1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0"
]

Assets

Assets

List of assets.

Authorizations:
ApiKeyAuth
query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Specific asset

Information about a specific asset

Authorizations:
ApiKeyAuth
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

Responses

Response samples

Content type
application/json
{
  • "policy_id": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7",
  • "asset_name": "6e7574636f696e",
  • "fingerprint": "asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w",
  • "quantity": "12000",
  • "initial_mint_tx_hash": "6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad",
  • "metadata": {
    }
}

Asset history

History of a specific asset

Authorizations:
ApiKeyAuth
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer <= 100
Default: 100

The number of results displayed on one page.

page
integer
Default: 1

The page number for listing the results.

order
string
Default: "asc"
Enum: "asc" "desc"

The ordering of items from the point of view of the blockchain, not the page listing itself. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Ledger

Blockchain's genesis

Return the information about blockchain's genesis.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "active_slots_coefficient": 0.05,
  • "update_quorum": 5,
  • "max_lovelace_supply": "45000000000000000",
  • "network_magic": 764824073,
  • "epoch_length": 432000,
  • "system_start": 1506203091,
  • "slots_per_kes_period": 129600,
  • "slot_length": 1,
  • "max_kes_evolutions": 62,
  • "security_param": 2160
}

Metrics

Blockfrost usage metrics

History of your Blockfrost usage metrics in the past 30 days.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
[
  • [
    ]
]

Blockfrost endpoint usage metrics

History of your Blockfrost usage metrics per endpoint in the past 30 days.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
[
  • [
    ]
]