Blockfrost
API docs by Redocly

Blockfrost.io ~ API Documentation (0.1.59)

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.

Tokens

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.

Network Endpoint
Cardano mainnet https://cardano-mainnet.blockfrost.io/api/v0
Cardano preprod https://cardano-preprod.blockfrost.io/api/v0
Cardano preview https://cardano-preview.blockfrost.io/api/v0
InterPlanetary File System https://ipfs.blockfrost.io/api/v0
Milkomeda mainnet https://milkomeda-mainnet.blockfrost.io/api/v0
Milkomeda testnet https://milkomeda-testnet.blockfrost.io/api/v0

Milkomeda

For more information about how to use Milkomeda as well as the list of available endpoints, see the Milkomeda section.

Concepts

  • All endpoints return either a JSON object or an array.
  • Data is returned in ascending (oldest first, newest last) order, if not stated otherwise.
    • 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 (except server_time) are in seconds 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.
  • All values are case sensitive.
  • All hex encoded values are lower case.
  • Examples are not based on real data. Any resemblance to actual events is purely coincidental.
  • We allow to upload files up to 100MB of size to IPFS. This might increase in the future.
  • Only pinned IPFS files are counted towards the IPFS quota.
  • Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.
  • We allow maximum of 100 queued pins per IPFS user.

Errors

HTTP Status codes

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

  • HTTP 400 return code is used when the request is not valid.
  • HTTP 402 return code is used when the projects exceed their daily request limit.
  • 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 418 return code is used when the user has been auto-banned for flooding too much after previously receiving error code 402 or 429.
  • HTTP 425 return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.
  • HTTP 425 return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.
  • HTTP 429 return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.
  • 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. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow each user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another whole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed. 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.

SDKs

We support a number of SDKs that will help you in developing your application on top of Blockfrost.

Programming language SDK
JavaScript blockfrost-js
Haskell blockfrost-haskell
Python blockfrost-python
Rust blockfrost-rust
Golang blockfrost-go
Ruby blockfrost-ruby
Java blockfrost-java
Scala blockfrost-scala
Swift blockfrost-swift
Kotlin blockfrost-kotlin
Elixir blockfrost-elixir
.NET blockfrost-dotnet
Arduino blockfrost-arduino
PHP blockfrost-php
Crystal blockfrost-crystal

Health

Root endpoint

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

Authorizations:
project_id

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 clock is not out of sync.

Authorizations:
project_id

Responses

Response samples

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

Metrics

Blockfrost usage metrics

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

Authorizations:
project_id

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:
project_id

Responses

Response samples

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

Cardano » Accounts

Specific account address

Obtain information about a specific stake account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

Responses

Response samples

Content type
application/json
{
  • "stake_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
  • "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 reward history

Obtain information about the reward history of a specific account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 history

Obtain information about the history of a specific account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 delegation history

Obtain information about the delegation of a specific account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 registration history

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

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 withdrawal history

Obtain information about the withdrawals of a specific account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 MIR history

Obtain information about the MIRs of a specific account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 associated addresses

Obtain information about the addresses of a specific account. Be careful, as an account could be part of a mangled address and does not necessarily mean the addresses are owned by user as the account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Assets associated with the account addresses

Obtain information about assets associated with addresses of a specific account. Be careful, as an account could be part of a mangled address and does not necessarily mean the addresses are owned by user as the account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc

Bech32 stake address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    }
]

Detailed information about account associated addresses

Obtain summed details about all addresses associated with a given account. Be careful, as an account could be part of a mangled address and does not necessarily mean the addresses are owned by user as the account.

Authorizations:
project_id
path Parameters
stake_address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

Responses

Response samples

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

Cardano » Addresses

Specific address

Obtain information about a specific address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

Responses

Response samples

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

Extended information of a specific address

Obtain extended information about a specific address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

Responses

Response samples

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

Address details

Obtain details about an address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

Responses

Response samples

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

Address UTXOs

UTXOs of the address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Address UTXOs of a given asset

UTXOs of the address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Address txs Deprecated

Transactions on the address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of transactions per page.

page
integer [ 1 .. 21474836 ]
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"
]

Address transactions

Transactions on the address.

Authorizations:
project_id
path Parameters
address
required
string
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of addresses per page.

page
integer [ 1 .. 21474836 ]
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.

from
string
Example: from=8929261

The block number and optionally also index from which (inclusive) to start search for results, concatenated using colon. Has to be lower than or equal to to parameter.

to
string
Example: to=9999269:10

The block number and optionally also index where (inclusive) to end the search for results, concatenated using colon. Has to be higher than or equal to from parameter.

Responses

Response samples

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

Cardano » Assets

Assets

List of assets. If an asset is completely burned, it will stay on the list with quantity 0 (order of assets is immutable).

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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. Ordering in this case is based on the time of the first mint transaction.

Responses

Response samples

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

Specific asset

Information about a specific asset

Authorizations:
project_id
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

Responses

Response samples

Content type
application/json
{
  • "asset": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e",
  • "policy_id": "b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7",
  • "asset_name": "6e7574636f696e",
  • "fingerprint": "asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w",
  • "quantity": "12000",
  • "initial_mint_tx_hash": "6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad",
  • "mint_or_burn_count": 1,
  • "onchain_metadata": { },
  • "onchain_metadata_standard": "CIP25v1",
  • "onchain_metadata_extra": "string",
  • "metadata": {
    }
}

Asset history

History of a specific asset

Authorizations:
project_id
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Asset txs Deprecated

List of a specific asset transactions

Authorizations:
project_id
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • "8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b",
  • "52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f",
  • "e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"
]

Asset transactions

List of a specific asset transactions

Authorizations:
project_id
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Asset addresses

List of a addresses containing a specific asset

Authorizations:
project_id
path Parameters
asset
required
string
Example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e

Concatenation of the policy_id and hex-encoded asset_name

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Assets of a specific policy

List of asset minted under a specific policy

Authorizations:
project_id
path Parameters
policy_id
required
string
Example: 476039a0949cf0b22f6a800f56780184c44533887ca6e821007840c3

Specific policy_id

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Cardano » Blocks

Latest block

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

Authorizations:
project_id

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",
  • "op_cert": "da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c",
  • "op_cert_counter": "18",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Latest block transactions

Return the transactions within the latest block.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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"
]

Specific block

Return the content of a requested block.

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

Hash or number 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",
  • "op_cert": "da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c",
  • "op_cert_counter": "18",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Listing of next blocks

Return the list of blocks following a specific block.

Authorizations:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
Default: 1

The page number for listing the results.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Specific block in a slot

Return the content of a requested block for a specific slot.

Authorizations:
project_id
path Parameters
slot_number
required
integer <slot number>
Example: 30895909

Slot position for 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",
  • "op_cert": "da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c",
  • "op_cert_counter": "18",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Specific block in a slot in an epoch

Return the content of a requested block for a specific slot in an epoch.

Authorizations:
project_id
path Parameters
epoch_number
required
integer <slot number>
Example: 219

Epoch for specific epoch slot.

slot_number
required
integer <slot number>
Example: 30895909

Slot position for 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",
  • "op_cert": "da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c",
  • "op_cert_counter": "18",
  • "previous_block": "43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05",
  • "next_block": "8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa",
  • "confirmations": 4698
}

Block transactions

Return the transactions within the block.

Authorizations:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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"
]

Addresses affected in a specific block

Return list of addresses affected in the specified block with additional information, sorted by the bech32 address, ascending.

Authorizations:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
Default: 1

The page number for listing the results.

Responses

Response samples

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

Cardano » Epochs

Latest epoch

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

Authorizations:
project_id

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

Latest epoch protocol parameters

Return the protocol parameters for the latest epoch.

Authorizations:
project_id

Responses

Response samples

Content type
application/json
{
  • "epoch": 225,
  • "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",
  • "cost_models": {
    },
  • "price_mem": 0.0577,
  • "price_step": 0.0000721,
  • "max_tx_ex_mem": "10000000",
  • "max_tx_ex_steps": "10000000000",
  • "max_block_ex_mem": "50000000",
  • "max_block_ex_steps": "40000000000",
  • "max_val_size": "5000",
  • "collateral_percent": 150,
  • "max_collateral_inputs": 3,
  • "coins_per_utxo_size": "34482",
  • "coins_per_utxo_word": "34482"
}

Specific epoch

Return the content of the requested epoch.

Authorizations:
project_id
path Parameters
number
required
integer
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:
project_id
path Parameters
number
required
integer
Example: 225

Number of the requested epoch.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 specified epoch.

Authorizations:
project_id
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
number
required
integer
Example: 225

Number of the epoch

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 by pool

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

Authorizations:
project_id
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 [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
number
required
integer
Example: 225

Number of the epoch

Responses

Response samples

Content type
application/json
{
  • "epoch": 225,
  • "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",
  • "cost_models": {
    },
  • "price_mem": 0.0577,
  • "price_step": 0.0000721,
  • "max_tx_ex_mem": "10000000",
  • "max_tx_ex_steps": "10000000000",
  • "max_block_ex_mem": "50000000",
  • "max_block_ex_steps": "40000000000",
  • "max_val_size": "5000",
  • "collateral_percent": 150,
  • "max_collateral_inputs": 3,
  • "coins_per_utxo_size": "34482",
  • "coins_per_utxo_word": "34482"
}

Cardano » Ledger

Blockchain genesis

Return the information about blockchain genesis.

Authorizations:
project_id

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
}

Cardano » Mempool

Mempool

Return transactions that are currently stored in Blockfrost mempool, waiting to be included in a newly minted block. Shows only transactions submitted via Blockfrost.io.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
Default: 1

The page number for listing the results.

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

Ordered by the time of transaction submission. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Specific transaction in the mempool

Return content of the requested transaction.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
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
{
  • "tx": {
    },
  • "inputs": [
    ],
  • "outputs": [
    ],
  • "redeemers": [
    ]
}

Mempool by address

List of mempool transactions where at least one of the transaction inputs or outputs belongs to the address. Shows only transactions submitted via Blockfrost.io.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
path Parameters
address
required
string <64-character case-sensitive hexadecimal string.>
Example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz

Bech32 address.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
Default: 1

The page number for listing the results.

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

Ordered by the time of transaction submission. By default, we return oldest first, newest last.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Cardano » Metadata

Transaction metadata labels

List of all used transaction metadata labels.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
label
required
string
Example: 1990

Metadata label

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
label
required
string
Example: 1990

Metadata label

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Cardano » Network

Network information

Return detailed network information.

Authorizations:
project_id

Responses

Response samples

Content type
application/json
{
  • "supply": {
    },
  • "stake": {
    }
}

Query summary of blockchain eras

Returns start and end of each era along with parameters that can vary between hard forks.

Authorizations:
project_id

Responses

Response samples

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

Cardano » Pools

List of stake pools

List of registered stake pools.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of pools per page.

page
integer [ 1 .. 21474836 ]
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 stake pools with additional information

List of registered stake pools with additional information.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of pools per page.

page
integer [ 1 .. 21474836 ]
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 retired stake pools

List of already retired pools.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of pools per page.

page
integer [ 1 .. 21474836 ]
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:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

Responses

Response samples

Content type
application/json
{
  • "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
  • "hex": "0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735",
  • "vrf_key": "0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233",
  • "blocks_minted": 69,
  • "blocks_epoch": 4,
  • "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_account": "stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f",
  • "owners": [
    ],
  • "registration": [
    ],
  • "retirement": [
    ]
}

Stake pool history

History of stake pool parameters over epochs.

Authorizations:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

Responses

Response samples

Content type
application/json
Example
{
  • "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
  • "hex": "0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735",
  • "url": "https://stakenuts.com/mainnet.json",
  • "hash": "47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c",
  • "ticker": "NUTS",
  • "name": "Stake Nuts",
  • "description": "The best pool ever",
  • "homepage": "https://stakentus.com/"
}

Stake pool relays

Relays of a stake pool.

Authorizations:
project_id
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:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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:
project_id
path Parameters
pool_id
required
string
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy

Bech32 or hexadecimal pool ID.

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    },
  • {
    },
  • {
    }
]

Cardano » Scripts

Scripts

List of scripts.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 script

Information about a specific script

Authorizations:
project_id
path Parameters
script_hash
required
string
Example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e

Hash of the script

Responses

Response samples

Content type
application/json
{
  • "script_hash": "13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1",
  • "type": "plutusV1",
  • "serialised_size": 3119
}

Script JSON

JSON representation of a timelock script

Authorizations:
project_id
path Parameters
script_hash
required
string
Example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e

Hash of the script

Responses

Response samples

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

Script CBOR

CBOR representation of a plutus script

Authorizations:
project_id
path Parameters
script_hash
required
string
Example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e

Hash of the script

Responses

Response samples

Content type
application/json
{
  • "cbor": "4e4d01000033222220051200120011"
}

Redeemers of a specific script

List of redeemers of a specific script

Authorizations:
project_id
path Parameters
script_hash
required
string
Example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e

Hash of the script

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    }
]

Datum value

Query JSON value of a datum by its hash

Authorizations:
project_id
path Parameters
datum_hash
required
string
Example: db583ad85881a96c73fbb26ab9e24d1120bb38f45385664bb9c797a2ea8d9a2d

Hash of the datum

Responses

Response samples

Content type
application/json
{
  • "json_value": {
    }
}

Datum CBOR value

Query CBOR serialised datum by its hash

Authorizations:
project_id
path Parameters
datum_hash
required
string
Example: db583ad85881a96c73fbb26ab9e24d1120bb38f45385664bb9c797a2ea8d9a2d

Hash of the datum

Responses

Response samples

Content type
application/json
{
  • "cbor": "19a6aa"
}

Cardano » Transactions

Specific transaction

Return content of the requested transaction.

Authorizations:
project_id
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
{
  • "hash": "1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477",
  • "block": "356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940",
  • "block_height": 123456,
  • "block_time": 1635505891,
  • "slot": 42000000,
  • "index": 1,
  • "output_amount": [
    ],
  • "fees": "182485",
  • "deposit": "0",
  • "size": 433,
  • "invalid_before": null,
  • "invalid_hereafter": "13885913",
  • "utxo_count": 4,
  • "withdrawal_count": 0,
  • "mir_cert_count": 0,
  • "delegation_count": 0,
  • "stake_cert_count": 0,
  • "pool_update_count": 0,
  • "pool_retire_count": 0,
  • "asset_mint_or_burn_count": 0,
  • "redeemer_count": 0,
  • "valid_contract": true
}

Transaction UTXOs

Return the inputs and UTXOs of the specific transaction.

Authorizations:
project_id
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
{
  • "hash": "1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477",
  • "inputs": [
    ],
  • "outputs": [
    ]
}

Transaction stake addresses certificates

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

Authorizations:
project_id
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 delegation certificates

Obtain information about delegation certificates of a specific transaction.

Authorizations:
project_id
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 withdrawal

Obtain information about withdrawals of a specific transaction.

Authorizations:
project_id
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 MIRs

Obtain information about Move Instantaneous Rewards (MIRs) of a specific transaction.

Authorizations:
project_id
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 stake pool registration and update certificates

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

Authorizations:
project_id
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 stake pool retirement certificates

Obtain information about stake pool retirements within a specific transaction.

Authorizations:
project_id
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 metadata

Obtain the transaction metadata.

Authorizations:
project_id
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 metadata in CBOR

Obtain the transaction metadata in CBOR.

Authorizations:
project_id
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 redeemers

Obtain the transaction redeemers.

Authorizations:
project_id
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 an already serialized transaction to the network.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
Request Body schema: application/cbor

The transaction to submit, serialized in CBOR.

string

The transaction to submit, serialized in CBOR.

Responses

Request samples

Content type
application/cbor
83a400818258208911f640d452c3be4ff3d89db63b41ce048c056951286e2e28bbf8a51588ab44000181825839009493315cd92eb5d8c4304e67b7e16ae36d61d34502694657811a2c8e32c728d3861e164cab28cb8f006448139c8f1740ffb8e7aa9e5232dc1a10b2531f021a00029519075820cb798b0bce50604eaf2e0dc89367896b18f0a6ef6b32b57e3c9f83f8ee71e608a1008182582073fea80d424276ad0978d4fe5310e8bc2d485f5f6bb3bf87612989f112ad5a7d5840c40425229749a9434763cf01b492057fd56d7091a6372eaa777a1c9b1ca508c914e6a4ee9c0d40fc10952ed668e9ad65378a28b149de6bd4204bd9f095b0a902a11907b0a1667469636b657281a266736f757263656b736f757263655f6e616d656576616c7565736675676961742076656e69616d206d696e7573

Response samples

Content type
application/json
"d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"

Cardano » Utilities

Derive an address

Derive Shelley address from an xpub

Authorizations:
project_id
path Parameters
xpub
required
string
Example: d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a

Hex xpub

role
required
integer

Account role

index
required
integer
Example: 2

Address index

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Submit a transaction for execution units evaluation

Submit an already serialized transaction to evaluate how much execution units it requires.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
header Parameters
Content-Type
required
string
Value: "application/cbor"

Responses

Request samples 

# Assuming `tx.data` is a CBOR serialized transaction on the file-system.
# (encoded using base16 or base64)
curl "https://cardano-mainnet.blockfrost.io/api/v0/utils/txs/evaluate" \
  -X POST \
  -H "Content-Type: application/cbor" \
  -H "project_id: $PROJECT_ID" \
  --data @./tx.data

Response samples

Content type
application/json
{ }

Submit a transaction for execution units evaluation (additional UTXO set)

Submit a JSON payload with transaction CBOR and additional UTXO set to evaluate how much execution units it requires.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
header Parameters
Content-Type
required
string
Value: "application/json"
Request Body schema: application/json

JSON payload

cbor
required
string

Transaction CBOR (encoded using base64 or base16).

Array of objects or objects[ items = 2 items ]

Additional UTXO as an array of tuples [TxIn, TxOut]. See https://ogmios.dev/mini-protocols/local-tx-submission/#additional-utxo-set.

Responses

Request samples

Content type
application/json
{
  • "cbor": "string",
  • "additionalUtxoSet": [
    ]
}

Response samples

Content type
application/json
{ }

IPFS » Add

Add a file to IPFS

You need to /ipfs/pin/add an object to avoid it being garbage collected. This usage is being counted in your user account quota.

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
Request Body schema: multipart/form-data
file
string <binary>

Responses

Request samples 

curl "https://ipfs.blockfrost.io/api/v0/ipfs/add" \
  -X POST \
  -H "project_id: $PROJECT_ID" \
  -F "file=@./README.md"

Response samples

Content type
application/json
{
  • "name": "README.md",
  • "ipfs_hash": "QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr",
  • "size": "125297"
}

IPFS » Gateway

Relay to an IPFS gateway

Retrieve an object from the IPFS gateway (useful if you do not want to rely on a public gateway, such as ipfs.blockfrost.dev).

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
path Parameters
IPFS_path
required
string

Path to the IPFS object

Responses

Response samples

Content type
application/json
{
  • "status_code": 400,
  • "error": "Bad Request",
  • "message": "Backend did not understand your request."
}

IPFS » Pins

Pin an object

Pinning is necessary to avoid regular garbage collection (deletion) of IPFS objects. Non-pinned objects are regularly being removed without prior notice. Pinned objects are counted in your user storage quota.

Authorizations:
project_id
path Parameters
IPFS_path
required
string

Path to the IPFS object

Responses

Response samples

Content type
application/json
{
  • "ipfs_hash": "QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8",
  • "state": "queued"
}

List pinned objects

List objects pinned to local storage

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    }
]

Get details about pinned object

Get information about locally pinned IPFS object

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
path Parameters
IPFS_path
required
string

The path to the IPFS object

Responses

Response samples

Content type
application/json
{
  • "time_created": 1615551024,
  • "time_pinned": 1615551024,
  • "ipfs_hash": "QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx",
  • "size": "1615551024",
  • "state": "pinned"
}

Remove a IPFS pin

Remove pinned objects from local storage

Hosted Endpoint only available for hosted variant.

Authorizations:
project_id
path Parameters
IPFS_path
required
string

The path to the IPFS object

Responses

Response samples

Content type
application/json
{
  • "ipfs_hash": "QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8",
  • "state": "unpinned"
}

Specific nut.link address

List metadata about specific address

Authorizations:
project_id
path Parameters
address
required
string

Address of a metadata oracle

Responses

Response samples

Content type
application/json
{
  • "address": "addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz",
  • "metadata_url": "https://nut.link/metadata.json",
  • "metadata_hash": "6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af",
  • "metadata": { }
}

List of tickers of an oracle

List of records of a specific oracle

Authorizations:
project_id
path Parameters
address
required
string

Address of a metadata oracle

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 ticker for an address

List of records of a specific ticker

Authorizations:
project_id
path Parameters
address
required
string

Address of a metadata oracle

ticker
required
string

Ticker for the pool record

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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 ticker

List of records of a specific ticker

Authorizations:
project_id
path Parameters
ticker
required
string

Ticker for the pool record

query Parameters
count
integer [ 1 .. 100 ]
Default: 100

The number of results displayed on one page.

page
integer [ 1 .. 21474836 ]
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
[
  • {
    }
]