openapi: 3.0.0 info: version: 0.1.60 title: Blockfrost.io ~ API Documentation x-logo: url: https://staging.blockfrost.io/images/logo.svg altText: Blockfrost contact: name: Blockfrost Team url: https://blockfrost.io email: contact@blockfrost.io license: name: MIT url: https://opensource.org/licenses/MIT termsOfService: https://blockfrost.io/terms description: | 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. ```json { "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
servers: - url: https://cardano-mainnet.blockfrost.io/api/v0 description: Cardano Mainnet network - url: https://cardano-preprod.blockfrost.io/api/v0 description: Cardano Preprod network - url: https://cardano-preview.blockfrost.io/api/v0 description: Cardano Preview network - url: https://localhost:3000 description: local security: - project_id: [] tags: - name: Health - name: Metrics - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets - name: Cardano » Blocks - name: Cardano » Epochs - name: Cardano » Ledger - name: Cardano » Mempool - name: Cardano » Metadata - name: Cardano » Network - name: Cardano » Pools - name: Cardano » Scripts - name: Cardano » Transactions - name: Cardano » Utilities - name: IPFS » Add - name: IPFS » Gateway - name: IPFS » Pins paths: /: get: tags: - Health summary: Root endpoint description: | Root endpoint has no other function than to point end users to documentation. responses: '200': description: Information pointing to the documentation. content: application/json: schema: type: object properties: url: type: string example: https://blockfrost.io/ version: type: string example: 0.1.0 required: - url - version '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /health: get: tags: - Health summary: Backend health status security: [] description: | Return backend status as a boolean. Your application should handle situations when backend for the given chain is unavailable. responses: '200': description: Return the boolean indicating the health of the backend. content: application/json: schema: type: object properties: is_healthy: type: boolean example: true required: - is_healthy '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /health/clock: get: tags: - Health summary: Current backend time description: | This endpoint provides the current UNIX time. Your application might use this to verify if the client clock is not out of sync. responses: '200': description: Return the current UNIX time in milliseconds. content: application/json: schema: type: object properties: server_time: type: integer format: int64 example: 1603400958947 required: - server_time '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/latest: get: tags: - Cardano » Blocks summary: Latest block description: | Return the latest block available to the backends, also known as the tip of the blockchain. responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/latest/txs: get: tags: - Cardano » Blocks summary: Latest block transactions description: Return the transactions within the latest block. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content_txs' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/{hash_or_number}: get: tags: - Cardano » Blocks summary: Specific block description: | Return the content of a requested block. parameters: - in: path name: hash_or_number required: true schema: type: string format: 64-character case-sensitive hexadecimal string or block number. description: Hash or number of the requested block. example: 4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/{hash_or_number}/next: get: tags: - Cardano » Blocks summary: Listing of next blocks description: | Return the list of blocks following a specific block. parameters: - in: path name: hash_or_number required: true schema: type: string format: 64-character case-sensitive hexadecimal string or block number. description: Hash of the requested block. example: 5ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content_array' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/{hash_or_number}/previous: get: tags: - Cardano » Blocks summary: Listing of previous blocks description: | Return the list of blocks preceding a specific block. parameters: - in: path name: hash_or_number required: true schema: type: string format: 64-character case-sensitive hexadecimal string or block number. description: Hash of the requested block example: '4873401' - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content_array' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/slot/{slot_number}: get: tags: - Cardano » Blocks summary: Specific block in a slot description: | Return the content of a requested block for a specific slot. parameters: - in: path name: slot_number required: true schema: type: integer format: slot number description: Slot position for requested block. example: 30895909 responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/epoch/{epoch_number}/slot/{slot_number}: get: tags: - Cardano » Blocks summary: Specific block in a slot in an epoch description: | Return the content of a requested block for a specific slot in an epoch. parameters: - in: path name: epoch_number required: true schema: type: integer format: slot number description: Epoch for specific epoch slot. example: 219 - in: path name: slot_number required: true schema: type: integer format: slot number description: Slot position for requested block. example: 30895909 responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/{hash_or_number}/txs: get: tags: - Cardano » Blocks summary: Block transactions description: Return the transactions within the block. parameters: - in: path name: hash_or_number required: true schema: type: string format: 64-character case-sensitive hexadecimal string or block number. description: Hash of the requested block. example: '4873401' - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content_txs' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /blocks/{hash_or_number}/addresses: get: tags: - Cardano » Blocks summary: Addresses affected in a specific block description: Return list of addresses affected in the specified block with additional information, sorted by the bech32 address, ascending. parameters: - in: path name: hash_or_number required: true schema: type: string format: 64-character case-sensitive hexadecimal string or block number. description: Hash of the requested block. example: '4873401' - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the contents of the block content: application/json: schema: $ref: '#/components/schemas/block_content_addresses' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /genesis: get: tags: - Cardano » Ledger summary: Blockchain genesis description: Return the information about blockchain genesis. responses: '200': description: Return the genesis parameters. content: application/json: schema: $ref: '#/components/schemas/genesis_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/latest: get: tags: - Cardano » Epochs summary: Latest epoch description: Return the information about the latest, therefore current, epoch. responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/latest/parameters: get: tags: - Cardano » Epochs summary: Latest epoch protocol parameters description: Return the protocol parameters for the latest epoch. responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_param_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}: get: tags: - Cardano » Epochs summary: Specific epoch description: Return the content of the requested epoch. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 responses: '200': description: Return the epoch data. content: application/json: schema: $ref: '#/components/schemas/epoch_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/next: get: tags: - Cardano » Epochs summary: Listing of next epochs description: Return the list of epochs following a specific epoch. parameters: - in: path name: number required: true schema: type: integer description: Number of the requested epoch. example: 225 - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_content_array' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/previous: get: tags: - Cardano » Epochs summary: Listing of previous epochs description: Return the list of epochs preceding a specific epoch. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results responses: '200': description: Return the epoch data content: application/json: schema: $ref: '#/components/schemas/epoch_content_array' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/stakes: get: tags: - Cardano » Epochs summary: Stake distribution description: Return the active stake distribution for the specified epoch. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_stake_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/stakes/{pool_id}: get: tags: - Cardano » Epochs summary: Stake distribution by pool description: Return the active stake distribution for the epoch specified by stake pool. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 - in: path required: true name: pool_id schema: type: string description: Stake pool ID to filter example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_stake_pool_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/blocks: get: tags: - Cardano » Epochs summary: Block distribution description: Return the blocks minted for the epoch specified. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/blocks/{pool_id}: get: tags: - Cardano » Epochs summary: Block distribution by pool description: Return the block minted for the epoch specified by stake pool. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 - in: path required: true name: pool_id schema: type: string description: Stake pool ID to filter example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_block_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /epochs/{number}/parameters: get: tags: - Cardano » Epochs summary: Protocol parameters description: Return the protocol parameters for the epoch specified. parameters: - in: path name: number required: true schema: type: integer description: Number of the epoch example: 225 responses: '200': description: Return the data about the epoch content: application/json: schema: $ref: '#/components/schemas/epoch_param_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}: get: tags: - Cardano » Transactions summary: Specific transaction description: Return content of the requested transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c42c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Return the contents of the transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/utxos: get: tags: - Cardano » Transactions summary: Transaction UTXOs description: Return the inputs and UTXOs of the specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Return the contents of the transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_utxo' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/stakes: get: tags: - Cardano » Transactions summary: Transaction stake addresses certificates description: | Obtain information about (de)registration of stake addresses within a transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction. example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: | Obtain information about (de)registration of stake addresses within a transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_stake_addr' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/delegations: get: tags: - Cardano » Transactions summary: Transaction delegation certificates description: | Obtain information about delegation certificates of a specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string description: Hash of the requested transaction. example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain information about delegation certificates of a specific transaction content: application/json: schema: $ref: '#/components/schemas/tx_content_delegations' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/withdrawals: get: tags: - Cardano » Transactions summary: Transaction withdrawal description: Obtain information about withdrawals of a specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string description: Hash of the requested transaction. example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain information about withdrawals of a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_withdrawals' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/mirs: get: tags: - Cardano » Transactions summary: Transaction MIRs description: Obtain information about Move Instantaneous Rewards (MIRs) of a specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string description: Hash of the requested transaction. example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain information about Move Instantaneous Rewards (MIRs) of a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_mirs' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/pool_updates: get: tags: - Cardano » Transactions summary: Transaction stake pool registration and update certificates description: | Obtain information about stake pool registration and update certificates of a specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain information about stake pool certificates of a specific transaction content: application/json: schema: $ref: '#/components/schemas/tx_content_pool_certs' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/pool_retires: get: tags: - Cardano » Transactions summary: Transaction stake pool retirement certificates description: | Obtain information about stake pool retirements within a specific transaction. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: | Obtain information about stake pool retirements within a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_pool_retires' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/metadata: get: tags: - Cardano » Transactions summary: Transaction metadata description: Obtain the transaction metadata. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain metadata information associated with a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_metadata' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/metadata/cbor: get: tags: - Cardano » Transactions summary: Transaction metadata in CBOR description: Obtain the transaction metadata in CBOR. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain metadata information associated with a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_metadata_cbor' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /txs/{hash}/redeemers: get: tags: - Cardano » Transactions summary: Transaction redeemers description: Obtain the transaction redeemers. parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c82c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Obtain information about redeemers within a specific transaction. content: application/json: schema: $ref: '#/components/schemas/tx_content_redeemers' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /tx/submit: post: tags: - Cardano » Transactions summary: Submit a transaction description: | Submit an already serialized transaction to the network.

Hosted Endpoint only available for hosted variant.

x-codeSamples: - lang: Shell label: cURL source: | # Assuming `data` is a serialized transaction on the file-system. curl "https://cardano-mainnet.blockfrost.io/api/v0/tx/submit" \ -X POST \ -H "Content-Type: application/cbor" \ -H "project_id: $PROJECT_ID" \ --data-binary @./data - lang: Shell label: cardano-cli source: | # Assuming `tx.signed` is signed transaction constructed by cardano-cli xxd -r -p <<< $(jq .cborHex tx.signed) > tx.submit-api.raw curl "https://cardano-mainnet.blockfrost.io/api/v0/tx/submit" \ -X POST \ -H "Content-Type: application/cbor" \ -H "project_id: $PROJECT_ID" \ --data-binary @./tx.submit-api.raw requestBody: description: | The transaction to submit, serialized in CBOR. required: true content: application/cbor: schema: type: string description: | The transaction to submit, serialized in CBOR. example: | 83a400818258208911f640d452c3be4ff3d89db63b41ce048c056951286e2e28bbf8a51588ab44000181825839009493315cd92eb5d8c4304e67b7e16ae36d61d34502694657811a2c8e32c728d3861e164cab28cb8f006448139c8f1740ffb8e7aa9e5232dc1a10b2531f021a00029519075820cb798b0bce50604eaf2e0dc89367896b18f0a6ef6b32b57e3c9f83f8ee71e608a1008182582073fea80d424276ad0978d4fe5310e8bc2d485f5f6bb3bf87612989f112ad5a7d5840c40425229749a9434763cf01b492057fd56d7091a6372eaa777a1c9b1ca508c914e6a4ee9c0d40fc10952ed668e9ad65378a28b149de6bd4204bd9f095b0a902a11907b0a1667469636b657281a266736f757263656b736f757263655f6e616d656576616c7565736675676961742076656e69616d206d696e7573 responses: '200': description: Return the ID of the submitted transaction. content: application/json: schema: type: string format: hex minLength: 64 maxLength: 64 example: d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908 '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '425': $ref: '#/components/responses/425' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}: get: tags: - Cardano » Accounts summary: Specific account address description: | Obtain information about a specific stake account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc responses: '200': description: Return the account content. content: application/json: schema: $ref: '#/components/schemas/account_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/rewards: get: tags: - Cardano » Accounts summary: Account reward history description: | Obtain information about the reward history of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account content. content: application/json: schema: $ref: '#/components/schemas/account_reward_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/history: get: tags: - Cardano » Accounts summary: Account history description: | Obtain information about the history of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account content. content: application/json: schema: $ref: '#/components/schemas/account_history_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/delegations: get: tags: - Cardano » Accounts summary: Account delegation history description: Obtain information about the delegation of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account delegations content content: application/json: schema: $ref: '#/components/schemas/account_delegation_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/registrations: get: tags: - Cardano » Accounts summary: Account registration history description: | Obtain information about the registrations and deregistrations of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account registration content. content: application/json: schema: $ref: '#/components/schemas/account_registration_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/withdrawals: get: tags: - Cardano » Accounts summary: Account withdrawal history description: | Obtain information about the withdrawals of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account withdrawal content. content: application/json: schema: $ref: '#/components/schemas/account_withdrawal_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/mirs: get: tags: - Cardano » Accounts summary: Account MIR history description: | Obtain information about the MIRs of a specific account. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account MIR content. content: application/json: schema: $ref: '#/components/schemas/account_mir_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/addresses: get: tags: - Cardano » Accounts summary: Account associated addresses description: | 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. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account addresses content content: application/json: schema: $ref: '#/components/schemas/account_addresses_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/addresses/assets: get: tags: - Cardano » Accounts summary: Assets associated with the account addresses description: | 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. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 stake address. example: stake1u9ylzsgxaa6xctf4juup682ar3juj85n8tx3hthnljg47zctvm3rc - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account addresses content content: application/json: schema: $ref: '#/components/schemas/account_addresses_assets' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /accounts/{stake_address}/addresses/total: get: tags: - Cardano » Accounts summary: Detailed information about account associated addresses description: | 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. parameters: - in: path name: stake_address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz responses: '200': description: Return the Address details. content: application/json: schema: $ref: '#/components/schemas/account_addresses_total' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /mempool: get: tags: - Cardano » Mempool summary: Mempool description: | 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.

parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | Ordered by the time of transaction submission. By default, we return oldest first, newest last. responses: '200': description: Return the contents of the mempool content: application/json: schema: $ref: '#/components/schemas/mempool_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /mempool/{hash}: get: tags: - Cardano » Mempool summary: Specific transaction in the mempool description: | Return content of the requested transaction.

Hosted Endpoint only available for hosted variant.

parameters: - in: path name: hash required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Hash of the requested transaction example: 6e5f825c42c1c6d6b77f2a14092f3b78c8f1b66db6f4cf8caec1555b6f967b3b responses: '200': description: Return the contents of the transaction. content: application/json: schema: $ref: '#/components/schemas/mempool_tx_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /mempool/addresses/{address}: get: tags: - Cardano » Mempool summary: Mempool by address description: | 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.

parameters: - in: path name: address required: true schema: type: string format: 64-character case-sensitive hexadecimal string. description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | Ordered by the time of transaction submission. By default, we return oldest first, newest last. responses: '200': description: Return the contents of the mempool content: application/json: schema: $ref: '#/components/schemas/mempool_addresses_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /metadata/txs/labels: get: tags: - Cardano » Metadata summary: Transaction metadata labels description: | List of all used transaction metadata labels. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account metadata content in CBOR content: application/json: schema: $ref: '#/components/schemas/tx_metadata_labels' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /metadata/txs/labels/{label}: get: tags: - Cardano » Metadata summary: Transaction metadata content in JSON description: Transaction metadata per label. parameters: - in: path name: label required: true schema: type: string description: Metadata label example: '1990' - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account metadata content content: application/json: schema: $ref: '#/components/schemas/tx_metadata_label_json' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /metadata/txs/labels/{label}/cbor: get: tags: - Cardano » Metadata summary: Transaction metadata content in CBOR description: Transaction metadata per label. parameters: - in: path name: label required: true schema: type: string description: Metadata label example: '1990' - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the account metadata content in CBOR content: application/json: schema: $ref: '#/components/schemas/tx_metadata_label_cbor' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}: get: tags: - Cardano » Addresses summary: Specific address description: Obtain information about a specific address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz responses: '200': description: Return the address content. content: application/json: schema: $ref: '#/components/schemas/address_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/extended: get: tags: - Cardano » Addresses summary: Extended information of a specific address description: | Obtain extended information about a specific address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz responses: '200': description: Return the address content. content: application/json: schema: $ref: '#/components/schemas/address_content_extended' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/total: get: tags: - Cardano » Addresses summary: Address details description: Obtain details about an address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz responses: '200': description: Return the Address details. content: application/json: schema: $ref: '#/components/schemas/address_content_total' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/utxos: get: tags: - Cardano » Addresses summary: Address UTXOs description: UTXOs of the address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the address content content: application/json: schema: $ref: '#/components/schemas/address_utxo_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/utxos/{asset}: get: tags: - Cardano » Addresses summary: Address UTXOs of a given asset description: UTXOs of the address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the address content content: application/json: schema: $ref: '#/components/schemas/address_utxo_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/txs: get: deprecated: true tags: - Cardano » Addresses summary: Address txs description: Transactions on the address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of transactions per page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the address content content: application/json: schema: $ref: '#/components/schemas/address_txs_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /addresses/{address}/transactions: get: tags: - Cardano » Addresses summary: Address transactions description: Transactions on the address. parameters: - in: path name: address required: true schema: type: string description: Bech32 address. example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of addresses per page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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. - in: query name: from required: false schema: type: string description: | 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. example: '8929261' - in: query name: to required: false schema: type: string description: | 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. example: '9999269:10' responses: '200': description: Return the address content content: application/json: schema: $ref: '#/components/schemas/address_transactions_content' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools: get: tags: - Cardano » Pools summary: List of stake pools description: List of registered stake pools. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of pools per page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the list of pools. content: application/json: schema: $ref: '#/components/schemas/pool_list' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/extended: get: tags: - Cardano » Pools summary: List of stake pools with additional information description: List of registered stake pools with additional information. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of pools per page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the list of pools. content: application/json: schema: $ref: '#/components/schemas/pool_list_extended' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/retired: get: tags: - Cardano » Pools summary: List of retired stake pools description: List of already retired pools. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of pools per page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool information content content: application/json: schema: $ref: '#/components/schemas/pool_list_retire' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/retiring: get: tags: - Cardano » Pools summary: List of retiring stake pools description: List of stake pools retiring in the upcoming epochs parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool information content content: application/json: schema: $ref: '#/components/schemas/pool_list_retire' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}: get: tags: - Cardano » Pools summary: Specific stake pool description: Pool information. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy responses: '200': description: Return the pool information content content: application/json: schema: $ref: '#/components/schemas/pool' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/history: get: tags: - Cardano » Pools summary: Stake pool history description: | History of stake pool parameters over epochs. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool information content. content: application/json: schema: $ref: '#/components/schemas/pool_history' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/metadata: get: tags: - Cardano » Pools summary: Stake pool metadata description: | Stake pool registration metadata. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy responses: '200': description: Return the pool metadata content. content: application/json: schema: anyOf: - $ref: '#/components/schemas/pool_metadata' - $ref: '#/components/schemas/empty_object' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/relays: get: tags: - Cardano » Pools summary: Stake pool relays description: Relays of a stake pool. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy responses: '200': description: Return the pool relays information content. content: application/json: schema: $ref: '#/components/schemas/pool_relays' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/delegators: get: tags: - Cardano » Pools summary: Stake pool delegators description: List of current stake pools delegators. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool delegations. content: application/json: schema: $ref: '#/components/schemas/pool_delegators' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/blocks: get: tags: - Cardano » Pools summary: Stake pool blocks description: List of stake pools blocks. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool block list content: application/json: schema: $ref: '#/components/schemas/pool_blocks' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /pools/{pool_id}/updates: get: tags: - Cardano » Pools summary: Stake pool updates description: List of certificate updates to the stake pool. parameters: - in: path name: pool_id required: true schema: type: string description: Bech32 or hexadecimal pool ID. example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the pool updates history content: application/json: schema: $ref: '#/components/schemas/pool_updates' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets: get: tags: - Cardano » Assets summary: Assets description: | List of assets. If an asset is completely burned, it will stay on the list with quantity 0 (order of assets is immutable). parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return list of assets content: application/json: schema: $ref: '#/components/schemas/assets' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/{asset}: get: tags: - Cardano » Assets summary: Specific asset description: Information about a specific asset parameters: - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e responses: '200': description: Return the information about a specific asset content: application/json: schema: $ref: '#/components/schemas/asset' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/{asset}/history: get: tags: - Cardano » Assets summary: Asset history description: History of a specific asset parameters: - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about the history of a specific asset content: application/json: schema: $ref: '#/components/schemas/asset_history' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/{asset}/txs: get: deprecated: true tags: - Cardano » Assets summary: Asset txs description: List of a specific asset transactions parameters: - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about the history of a specific asset content: application/json: schema: $ref: '#/components/schemas/asset_txs' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/{asset}/transactions: get: tags: - Cardano » Assets summary: Asset transactions description: List of a specific asset transactions parameters: - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about the history of a specific asset content: application/json: schema: $ref: '#/components/schemas/asset_transactions' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/{asset}/addresses: get: tags: - Cardano » Assets summary: Asset addresses description: List of a addresses containing a specific asset parameters: - in: path name: asset required: true schema: type: string description: Concatenation of the policy_id and hex-encoded asset_name example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about the history of a specific asset content: application/json: schema: $ref: '#/components/schemas/asset_addresses' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /assets/policy/{policy_id}: get: tags: - Cardano » Assets summary: Assets of a specific policy description: List of asset minted under a specific policy parameters: - in: path name: policy_id required: true schema: type: string description: Specific policy_id example: 476039a0949cf0b22f6a800f56780184c44533887ca6e821007840c3 - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about a specific asset content: application/json: schema: $ref: '#/components/schemas/asset_policy' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts: get: tags: - Cardano » Scripts summary: Scripts description: List of scripts. parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return list of scripts content: application/json: schema: $ref: '#/components/schemas/scripts' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/{script_hash}: get: tags: - Cardano » Scripts summary: Specific script description: Information about a specific script parameters: - in: path name: script_hash required: true schema: type: string description: Hash of the script example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e responses: '200': description: Return the information about a specific script content: application/json: schema: $ref: '#/components/schemas/script' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/{script_hash}/json: get: tags: - Cardano » Scripts summary: Script JSON description: JSON representation of a `timelock` script parameters: - in: path name: script_hash required: true schema: type: string description: Hash of the script example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e responses: '200': description: Return the JSON representation of a `timelock` script content: application/json: schema: $ref: '#/components/schemas/script_json' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/{script_hash}/cbor: get: tags: - Cardano » Scripts summary: Script CBOR description: CBOR representation of a `plutus` script parameters: - in: path name: script_hash required: true schema: type: string description: Hash of the script example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e responses: '200': description: Return the CBOR representation of a `plutus` script content: application/json: schema: $ref: '#/components/schemas/script_cbor' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/{script_hash}/redeemers: get: tags: - Cardano » Scripts summary: Redeemers of a specific script description: List of redeemers of a specific script parameters: - in: path name: script_hash required: true schema: type: string description: Hash of the script example: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the information about redeemers of a specific script content: application/json: schema: $ref: '#/components/schemas/script_redeemers' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/datum/{datum_hash}: get: tags: - Cardano » Scripts summary: Datum value description: Query JSON value of a datum by its hash parameters: - in: path name: datum_hash required: true schema: type: string description: Hash of the datum example: db583ad85881a96c73fbb26ab9e24d1120bb38f45385664bb9c797a2ea8d9a2d responses: '200': description: Return the datum value content: application/json: schema: $ref: '#/components/schemas/script_datum' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /scripts/datum/{datum_hash}/cbor: get: tags: - Cardano » Scripts summary: Datum CBOR value description: Query CBOR serialised datum by its hash parameters: - in: path name: datum_hash required: true schema: type: string description: Hash of the datum example: db583ad85881a96c73fbb26ab9e24d1120bb38f45385664bb9c797a2ea8d9a2d responses: '200': description: Return the CBOR serialised datum value content: application/json: schema: $ref: '#/components/schemas/script_datum_cbor' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /utils/addresses/xpub/{xpub}/{role}/{index}: get: tags: - Cardano » Utilities summary: Derive an address description: Derive Shelley address from an xpub parameters: - in: path name: xpub required: true schema: type: string description: Hex xpub example: d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a - in: path name: role required: true schema: type: integer description: Account role example: 0 - in: path name: index required: true schema: type: integer description: Address index example: 2 responses: '200': description: Return derivated Shelley address content: application/json: schema: $ref: '#/components/schemas/utils_addresses_xpub' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /utils/txs/evaluate: post: tags: - Cardano » Utilities summary: Submit a transaction for execution units evaluation description: | Submit an already serialized transaction to evaluate how much execution units it requires.

Hosted Endpoint only available for hosted variant.

parameters: - in: header name: Content-Type required: true schema: type: string enum: - application/cbor x-codeSamples: - lang: Shell label: cURL source: | # 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 requestBody: description: | The transaction to submit, serialized in CBOR. required: true content: application/cbor: schema: type: string description: | The transaction to submit, serialized in CBOR. example: | 83a400818258208911f640d452c3be4ff3d89db63b41ce048c056951286e2e28bbf8a51588ab44000181825839009493315cd92eb5d8c4304e67b7e16ae36d61d34502694657811a2c8e32c728d3861e164cab28cb8f006448139c8f1740ffb8e7aa9e5232dc1a10b2531f021a00029519075820cb798b0bce50604eaf2e0dc89367896b18f0a6ef6b32b57e3c9f83f8ee71e608a1008182582073fea80d424276ad0978d4fe5310e8bc2d485f5f6bb3bf87612989f112ad5a7d5840c40425229749a9434763cf01b492057fd56d7091a6372eaa777a1c9b1ca508c914e6a4ee9c0d40fc10952ed668e9ad65378a28b149de6bd4204bd9f095b0a902a11907b0a1667469636b657281a266736f757263656b736f757263655f6e616d656576616c7565736675676961742076656e69616d206d696e7573 responses: '200': description: |

Returns result of EvaluateTx function from Ogmios see EvaluateTx and API reference (EvaluateTxResponse) for related errors.

content: application/json: schema: type: object additionalProperties: true '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '425': $ref: '#/components/responses/425' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /utils/txs/evaluate/utxos: post: tags: - Cardano » Utilities summary: Submit a transaction for execution units evaluation (additional UTXO set) description: | 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.

parameters: - in: header name: Content-Type required: true schema: type: string enum: - application/json requestBody: description: JSON payload required: true content: application/json: schema: type: object properties: cbor: type: string description: Transaction CBOR (encoded using base64 or base16). additionalUtxoSet: type: array description: Additional UTXO as an array of tuples [TxIn, TxOut]. See https://ogmios.dev/mini-protocols/local-tx-submission/#additional-utxo-set. items: type: array minItems: 2 maxItems: 2 items: anyOf: - type: object description: TxIn properties: txId: type: string description: Transaction hash for the input index: type: number description: Index of the output within the transaction - type: object description: TxOut properties: address: type: string description: Output address value: type: object properties: coins: type: number description: Lovelace amount assets: type: object description: Assets amount additionalProperties: type: number required: - coins datum_hash: type: string datum: type: object additionalProperties: true script: type: object additionalProperties: true required: - address - value required: - cbor x-codeSamples: - lang: Shell label: cURL source: | # Assuming TxCbor is a CBOR serialized transaction encoded using base16 or base64 # For a structure of additional UTXO set see https://ogmios.dev/mini-protocols/local-tx-submission/#additional-utxo-set curl "https://cardano-mainnet.blockfrost.io/api/v0/utils/txs/evaluate/utxos" \ -X POST \ -H "Content-Type: application/json" \ -H "project_id: $PROJECT_ID" \ -d '{"cbor":"","additionalUtxoSet":[[, ]]}' responses: '200': description: |

Returns result of EvaluateTx function from Ogmios see EvaluateTx and API reference (EvaluateTxResponse) for related errors.

content: application/json: schema: type: object additionalProperties: true '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '425': $ref: '#/components/responses/425' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/add: servers: - url: https://ipfs.blockfrost.io/api/v0 post: tags: - IPFS » Add summary: Add a file to IPFS operationId: ipfs_add description: | 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.

x-codeSamples: - lang: Shell label: cURL source: | curl "https://ipfs.blockfrost.io/api/v0/ipfs/add" \ -X POST \ -H "project_id: $PROJECT_ID" \ -F "file=@./README.md" requestBody: content: multipart/form-data: schema: type: object properties: file: type: string format: binary responses: '200': description: Returns information about added IPFS object content: application/json: schema: type: object properties: name: type: string example: README.md description: Name of the file ipfs_hash: type: string example: QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr description: IPFS hash of the file size: type: string example: '125297' description: IPFS node size in Bytes required: - name - ipfs_hash - size '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/gateway/{IPFS_path}: servers: - url: https://ipfs.blockfrost.io/api/v0 get: tags: - IPFS » Gateway summary: Relay to an IPFS gateway description: | 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.

parameters: - in: path required: true name: IPFS_path schema: type: string description: Path to the IPFS object responses: '200': description: Returns the object content content: application/octet-stream: schema: type: string format: binary '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/pin/add/{IPFS_path}: servers: - url: https://ipfs.blockfrost.io/api/v0 post: tags: - IPFS » Pins summary: Pin an object description: 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. parameters: - in: path required: true name: IPFS_path schema: type: string description: Path to the IPFS object responses: '200': description: Returns pinned object content: application/json: schema: type: object properties: ipfs_hash: type: string example: QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8 description: IPFS hash of the pinned object state: type: string enum: - queued|pinned|unpinned|failed|gc example: queued description: State of the pin action required: - ipfs_hash - state '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '425': $ref: '#/components/responses/425-2' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/pin/list: servers: - url: https://ipfs.blockfrost.io/api/v0 get: tags: - IPFS » Pins summary: List pinned objects description: | List objects pinned to local storage

Hosted Endpoint only available for hosted variant.

parameters: - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Returns pinned objects content: application/json: schema: type: array items: type: object properties: time_created: type: integer description: Creation time of the IPFS object on our backends example: 1615551024 time_pinned: type: integer description: Pin time of the IPFS object on our backends example: 1615551024 ipfs_hash: type: string description: IPFS hash of the pinned object example: QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx size: type: string description: Size of the object in Bytes example: '1615551024' state: type: string enum: - queued|pinned|unpinned|failed|gc description: | State of the pinned object, which is `queued` when we are retriving object. If this is successful the state is changed to `pinned` or `failed` if not. The state `gc` means the pinned item has been garbage collected due to account being over storage quota or after it has been moved to `unpinned` state by removing the object pin. example: pinned required: - time_created - time_pinned - ipfs_hash - size - state '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/pin/list/{IPFS_path}: servers: - url: https://ipfs.blockfrost.io/api/v0 get: tags: - IPFS » Pins summary: Get details about pinned object description: | Get information about locally pinned IPFS object

Hosted Endpoint only available for hosted variant.

parameters: - in: path required: true name: IPFS_path schema: type: string description: The path to the IPFS object responses: '200': description: Returns the pins pinned content: application/json: schema: type: object properties: time_created: type: integer description: Time of the creation of the IPFS object on our backends example: 1615551024 time_pinned: type: integer description: Time of the pin of the IPFS object on our backends example: 1615551024 ipfs_hash: type: string description: IPFS hash of the pinned object example: QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx size: type: string description: Size of the object in Bytes example: '1615551024' state: type: string enum: - queued|pinned|unpinned|failed|gc description: | State of the pinned object. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`. When the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`. If the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise. When object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection. State `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota. example: pinned required: - time_created - time_pinned - ipfs_hash - size - state '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /ipfs/pin/remove/{IPFS_path}: servers: - url: https://ipfs.blockfrost.io/api/v0 post: tags: - IPFS » Pins summary: Remove a IPFS pin description: | Remove pinned objects from local storage

Hosted Endpoint only available for hosted variant.

parameters: - in: path required: true name: IPFS_path schema: type: string description: The path to the IPFS object responses: '200': description: Returns the pins removed content: application/json: schema: type: object properties: ipfs_hash: type: string example: QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8 description: IPFS hash of the pinned object state: type: string enum: - queued|pinned|unpinned|failed|gc example: unpinned description: State of the pin action required: - ipfs_hash - state '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /metrics: get: tags: - Metrics summary: Blockfrost usage metrics description: History of your Blockfrost usage metrics in the past 30 days. responses: '200': description: Return the last 30 days of metrics content: application/json: schema: $ref: '#/components/schemas/metrics' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /metrics/endpoints: get: tags: - Metrics summary: Blockfrost endpoint usage metrics description: | History of your Blockfrost usage metrics per endpoint in the past 30 days. responses: '200': description: Return the last 30 days of metrics content: application/json: schema: $ref: '#/components/schemas/metrics_endpoints' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /network: get: tags: - Cardano » Network summary: Network information description: Return detailed network information. responses: '200': description: Return detailed network information. content: application/json: schema: $ref: '#/components/schemas/network' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /network/eras: get: tags: - Cardano » Network summary: Query summary of blockchain eras description: | Returns start and end of each era along with parameters that can vary between hard forks. responses: '200': description: Returns era summaries content. content: application/json: schema: $ref: '#/components/schemas/network-eras' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '425': $ref: '#/components/responses/425' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /nutlink/{address}: get: tags: - Nut.link summary: Specific nut.link address description: List metadata about specific address parameters: - in: path required: true name: address schema: type: string description: Address of a metadata oracle responses: '200': description: Return the metadata about metadata oracle content: application/json: schema: $ref: '#/components/schemas/nutlink_address' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /nutlink/{address}/tickers: get: tags: - Nut.link summary: List of tickers of an oracle description: List of records of a specific oracle parameters: - in: path required: true name: address schema: type: string description: Address of a metadata oracle - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the tickers provided by the metadata oracle content: application/json: schema: $ref: '#/components/schemas/nutlink_address_tickers' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /nutlink/{address}/tickers/{ticker}: get: tags: - Nut.link summary: Specific ticker for an address description: List of records of a specific ticker parameters: - in: path required: true name: address schema: type: string description: Address of a metadata oracle - in: path required: true name: ticker schema: type: string description: Ticker for the pool record - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the tickers provided by the metadata oracle content: application/json: schema: $ref: '#/components/schemas/nutlink_address_ticker' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /nutlink/tickers/{ticker}: get: tags: - Nut.link summary: Specific ticker description: List of records of a specific ticker parameters: - in: path required: true name: ticker schema: type: string description: Ticker for the pool record - in: query name: count required: false schema: type: integer minimum: 1 maximum: 100 default: 100 description: The number of results displayed on one page. - in: query name: page required: false schema: type: integer minimum: 1 maximum: 21474836 default: 1 description: The page number for listing the results. - in: query name: order required: false schema: type: string enum: - asc - desc default: asc description: | 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: '200': description: Return the tickers provided by the metadata oracle content: application/json: schema: $ref: '#/components/schemas/nutlink_tickers_ticker' '400': $ref: '#/components/responses/400' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '418': $ref: '#/components/responses/418' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' components: schemas: onchain_metadata_cip25: $ref: '#/components/schemas/asset_onchain_metadata_cip25' onchain_metadata_cip68_ft_333: $ref: '#/components/schemas/asset_onchain_metadata_cip68_ft_333' onchain_metadata_cip68_nft_222: $ref: '#/components/schemas/asset_onchain_metadata_cip68_nft_222' onchain_metadata_cip68_rft_444: $ref: '#/components/schemas/asset_onchain_metadata_cip68_rft_444' block_content: type: object properties: time: type: integer example: 1641338934 description: Block creation time in UNIX time height: type: integer nullable: true example: 15243593 description: Block number hash: type: string example: 4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a description: Hash of the block slot: type: integer nullable: true example: 412162133 description: Slot number epoch: type: integer nullable: true example: 425 description: Epoch number epoch_slot: type: integer nullable: true example: 12 description: Slot within the epoch slot_leader: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy description: Bech32 ID of the slot leader or specific block description in case there is no slot leader size: type: integer example: 3 description: Block size in Bytes tx_count: type: integer example: 1 description: Number of transactions in the block output: type: string nullable: true example: '128314491794' description: Total output within the block in Lovelaces fees: type: string nullable: true example: '592661' description: Total fees within the block in Lovelaces block_vrf: type: string nullable: true example: vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty description: VRF key of the block minLength: 65 maxLength: 65 op_cert: type: string nullable: true example: da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c description: The hash of the operational certificate of the block producer op_cert_counter: type: string nullable: true example: '18' description: The value of the counter used to produce the operational certificate previous_block: type: string nullable: true example: 43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05 description: Hash of the previous block next_block: type: string nullable: true example: 8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa description: Hash of the next block confirmations: type: integer example: 4698 description: Number of block confirmations required: - time - height - hash - slot - epoch - epoch_slot - slot_leader - size - tx_count - output - fees - block_vrf - op_cert - op_cert_counter - previous_block - next_block - confirmations block_content_txs: type: array items: type: string description: Hash of the transaction example: - 8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b - 4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036 - 52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f - e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b block_content_array: type: array items: $ref: '#/components/schemas/block_content' block_content_addresses: type: array items: type: object properties: address: type: string description: Address that was affected in the specified block transactions: type: array description: List of transactions containing the address either in their inputs or outputs. Sorted by transaction index within a block, ascending. items: type: object properties: tx_hash: type: string required: - tx_hash required: - address - transactions example: - address: addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv transactions: - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 - address: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz transactions: - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157d0 genesis_content: type: object properties: active_slots_coefficient: type: number example: 0.05 description: The proportion of slots in which blocks should be issued update_quorum: type: integer example: 5 description: Determines the quorum needed for votes on the protocol parameter updates max_lovelace_supply: type: string example: '45000000000000000' description: The total number of lovelace in the system network_magic: type: integer example: 764824073 description: Network identifier epoch_length: type: integer example: 432000 description: Number of slots in an epoch system_start: type: integer example: 1506203091 description: Time of slot 0 in UNIX time slots_per_kes_period: type: integer example: 129600 description: Number of slots in an KES period slot_length: type: integer example: 1 description: Duration of one slot in seconds max_kes_evolutions: type: integer example: 62 description: The maximum number of time a KES key can be evolved before a pool operator must create a new operational certificate security_param: type: integer example: 2160 description: Security parameter k required: - active_slots_coefficient - update_quorum - max_lovelace_supply - network_magic - epoch_length - system_start - slots_per_kes_period - slot_length - max_kes_evolutions - security_param epoch_content: type: object properties: epoch: type: integer example: 225 description: Epoch number start_time: type: integer example: 1603403091 description: Unix time of the start of the epoch end_time: type: integer example: 1603835086 description: Unix time of the end of the epoch first_block_time: type: integer example: 1603403092 description: Unix time of the first block of the epoch last_block_time: type: integer example: 1603835084 description: Unix time of the last block of the epoch block_count: type: integer example: 21298 description: Number of blocks within the epoch tx_count: type: integer example: 17856 description: Number of transactions within the epoch output: type: string example: '7849943934049314' description: Sum of all the transactions within the epoch in Lovelaces fees: type: string example: '4203312194' description: Sum of all the fees within the epoch in Lovelaces active_stake: type: string nullable: true example: '784953934049314' description: Sum of all the active stakes within the epoch in Lovelaces required: - epoch - start_time - end_time - first_block_time - last_block_time - block_count - tx_count - output - fees - active_stake epoch_param_content: type: object properties: epoch: type: integer example: 225 description: Epoch number min_fee_a: type: integer example: 44 description: The linear factor for the minimum fee calculation for given epoch min_fee_b: type: integer example: 155381 description: The constant factor for the minimum fee calculation max_block_size: type: integer example: 65536 description: Maximum block body size in Bytes max_tx_size: type: integer example: 16384 description: Maximum transaction size max_block_header_size: type: integer example: 1100 description: Maximum block header size key_deposit: type: string example: '2000000' description: The amount of a key registration deposit in Lovelaces pool_deposit: type: string example: '500000000' description: The amount of a pool registration deposit in Lovelaces e_max: type: integer example: 18 description: Epoch bound on pool retirement n_opt: type: integer example: 150 description: Desired number of pools a0: type: number example: 0.3 description: Pool pledge influence rho: type: number example: 0.003 description: Monetary expansion tau: type: number example: 0.2 description: Treasury expansion decentralisation_param: type: number example: 0.5 description: Percentage of blocks produced by federated nodes extra_entropy: type: string nullable: true example: null description: Seed for extra entropy protocol_major_ver: type: integer example: 2 description: Accepted protocol major version protocol_minor_ver: type: integer example: 0 description: Accepted protocol minor version min_utxo: type: string example: '1000000' description: Minimum UTXO value min_pool_cost: type: string example: '340000000' description: Minimum stake cost forced on the pool nonce: type: string example: 1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81 description: Epoch number only used once cost_models: additionalProperties: true type: object nullable: true example: PlutusV1: addInteger-cpu-arguments-intercept: 197209 addInteger-cpu-arguments-slope: 0 PlutusV2: addInteger-cpu-arguments-intercept: 197209 addInteger-cpu-arguments-slope: 0 description: Cost models parameters for Plutus Core scripts price_mem: type: number nullable: true example: 0.0577 description: The per word cost of script memory usage price_step: type: number nullable: true example: 0.0000721 description: The cost of script execution step usage max_tx_ex_mem: type: string nullable: true example: '10000000' description: The maximum number of execution memory allowed to be used in a single transaction max_tx_ex_steps: type: string nullable: true example: '10000000000' description: The maximum number of execution steps allowed to be used in a single transaction max_block_ex_mem: type: string nullable: true example: '50000000' description: The maximum number of execution memory allowed to be used in a single block max_block_ex_steps: type: string nullable: true example: '40000000000' description: The maximum number of execution steps allowed to be used in a single block max_val_size: type: string nullable: true example: '5000' description: The maximum Val size collateral_percent: type: integer nullable: true example: 150 description: The percentage of the transactions fee which must be provided as collateral when including non-native scripts max_collateral_inputs: type: integer nullable: true example: 3 description: The maximum number of collateral inputs allowed in a transaction coins_per_utxo_size: type: string nullable: true example: '34482' description: Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later. coins_per_utxo_word: type: string nullable: true example: '34482' description: Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later. deprecated: true required: - epoch - min_fee_a - min_fee_b - max_block_size - max_tx_size - max_block_header_size - key_deposit - pool_deposit - e_max - n_opt - a0 - rho - tau - decentralisation_param - extra_entropy - protocol_major_ver - protocol_minor_ver - min_utxo - min_pool_cost - nonce - cost_models - price_mem - price_step - max_tx_ex_mem - max_tx_ex_steps - max_block_ex_mem - max_block_ex_steps - max_val_size - collateral_percent - max_collateral_inputs - coins_per_utxo_size - coins_per_utxo_word epoch_content_array: type: array items: $ref: '#/components/schemas/epoch_content' epoch_stake_content: type: array items: type: object properties: stake_address: type: string example: stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk description: Stake address pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 prefix of the pool delegated to amount: type: string example: '4440295078' description: Amount of active delegated stake in Lovelaces required: - stake_address - pool_id - amount epoch_stake_pool_content: type: array items: properties: stake_address: type: string example: stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk description: Stake address amount: type: string example: '4440295078' description: Amount of active delegated stake in Lovelaces required: - stake_address - amount epoch_block_content: type: array items: type: string description: Hash of the block example: - d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e - 38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878 - f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d tx_content: type: object properties: hash: type: string example: 1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477 description: Transaction hash block: type: string example: 356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940 description: Block hash block_height: type: integer example: 123456 description: Block number block_time: type: integer example: 1635505891 description: Block creation time in UNIX time slot: type: integer example: 42000000 description: Slot number index: type: integer example: 1 description: Transaction index within the block output_amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' fees: type: string example: '182485' description: Fees of the transaction in Lovelaces deposit: type: string example: '0' description: Deposit within the transaction in Lovelaces size: type: integer example: 433 description: Size of the transaction in Bytes invalid_before: type: string nullable: true example: null description: Left (included) endpoint of the timelock validity intervals invalid_hereafter: type: string nullable: true example: '13885913' description: Right (excluded) endpoint of the timelock validity intervals utxo_count: type: integer example: 4 description: Count of UTXOs within the transaction withdrawal_count: type: integer example: 0 description: Count of the withdrawals within the transaction mir_cert_count: type: integer example: 0 description: Count of the MIR certificates within the transaction delegation_count: type: integer example: 0 description: Count of the delegations within the transaction stake_cert_count: type: integer example: 0 description: Count of the stake keys (de)registration within the transaction pool_update_count: type: integer example: 0 description: Count of the stake pool registration and update certificates within the transaction pool_retire_count: type: integer example: 0 description: Count of the stake pool retirement certificates within the transaction asset_mint_or_burn_count: type: integer example: 0 description: Count of asset mints and burns within the transaction redeemer_count: type: integer example: 0 description: Count of redeemers within the transaction valid_contract: type: boolean example: true description: True if contract script passed validation required: - hash - block - block_height - block_time - slot - index - output_amount - fees - deposit - size - invalid_before - invalid_hereafter - utxo_count - withdrawal_count - mir_cert_count - delegation_count - stake_cert_count - pool_update_count - pool_retire_count - asset_mint_or_burn_count - redeemer_count - valid_contract tx_content_utxo: type: object properties: hash: type: string example: 1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477 description: Transaction hash inputs: type: array items: type: object properties: address: type: string example: addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv description: Input address amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' tx_hash: type: string example: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 description: Hash of the UTXO transaction output_index: type: integer example: 0 description: UTXO index in the transaction data_hash: type: string nullable: true description: The hash of the transaction output datum example: 9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710 inline_datum: type: string nullable: true description: CBOR encoded inline datum example: 19a6aa reference_script_hash: type: string nullable: true description: The hash of the reference script of the input example: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 collateral: type: boolean example: false description: Whether the input is a collateral consumed on script validation failure reference: type: boolean example: false description: Whether the input is a reference transaction input required: - address - amount - tx_hash - output_index - data_hash - inline_datum - reference_script_hash - collateral outputs: type: array items: type: object properties: address: type: string example: addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv description: Output address amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' output_index: type: integer example: 0 description: UTXO index in the transaction data_hash: type: string nullable: true description: The hash of the transaction output datum example: 9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710 inline_datum: type: string nullable: true description: CBOR encoded inline datum example: 19a6aa collateral: type: boolean example: false description: Whether the output is a collateral output reference_script_hash: type: string nullable: true description: The hash of the reference script of the output example: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 required: - address - amount - output_index - data_hash - inline_datum - collateral - reference_script_hash required: - hash - inputs - outputs tx_content_stake_addr: type: array items: type: object properties: cert_index: type: integer example: 0 description: Index of the certificate within the transaction address: type: string example: stake1u9t3a0tcwune5xrnfjg4q7cpvjlgx9lcv0cuqf5mhfjwrvcwrulda description: Delegation stake address registration: type: boolean example: true description: Registration boolean, false if deregistration required: - cert_index - address - registration tx_content_delegations: type: array items: type: object properties: index: type: integer example: 0 description: Index of the certificate within the transaction deprecated: true cert_index: type: integer example: 0 description: Index of the certificate within the transaction address: type: string example: stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc description: Bech32 delegation stake address pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 ID of delegated stake pool active_epoch: type: integer example: 210 description: Epoch in which the delegation becomes active required: - index - cert_index - address - pool_id - active_epoch tx_content_withdrawals: type: array items: type: object properties: address: type: string example: stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc description: Bech32 withdrawal address amount: type: string example: '431833601' description: Withdrawal amount in Lovelaces required: - address - amount tx_content_mirs: type: array items: type: object properties: pot: type: string enum: - reserve - treasury example: reserve description: Source of MIR funds cert_index: type: integer example: 0 description: Index of the certificate within the transaction address: type: string example: stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc description: Bech32 stake address amount: type: string example: '431833601' description: MIR amount in Lovelaces required: - pot - cert_index - address - amount tx_content_pool_certs: type: array items: type: object properties: cert_index: type: integer example: 0 description: Index of the certificate within the transaction pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 encoded pool ID vrf_key: type: string example: 0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233 description: VRF key hash pledge: type: string example: '5000000000' description: Stake pool certificate pledge in Lovelaces margin_cost: type: number example: 0.05 description: Margin tax cost of the stake pool fixed_cost: type: string example: '340000000' description: Fixed tax cost of the stake pool in Lovelaces reward_account: type: string example: stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f description: Bech32 reward account of the stake pool owners: type: array items: type: string description: Bech32 accounts of the pool owners example: - stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v metadata: type: object nullable: true properties: url: type: string nullable: true example: https://stakenuts.com/mainnet.json description: URL to the stake pool metadata hash: type: string nullable: true example: 47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c description: Hash of the metadata file ticker: type: string nullable: true example: NUTS description: Ticker of the stake pool name: type: string nullable: true example: Stake Nuts description: Name of the stake pool description: type: string nullable: true example: The best pool ever description: Description of the stake pool homepage: type: string nullable: true example: https://stakentus.com/ description: Home page of the stake pool required: - url - hash - ticker - name - description - homepage relays: type: array items: type: object properties: ipv4: type: string nullable: true example: 4.4.4.4 description: IPv4 address of the relay ipv6: type: string nullable: true example: https://stakenuts.com/mainnet.json description: IPv6 address of the relay dns: type: string nullable: true example: relay1.stakenuts.com description: DNS name of the relay dns_srv: type: string nullable: true example: _relays._tcp.relays.stakenuts.com description: DNS SRV entry of the relay port: type: integer example: 3001 description: Network port of the relay required: - ipv4 - ipv6 - dns - dns_srv - port active_epoch: type: integer example: 210 description: Epoch in which the update becomes active required: - cert_index - pool_id - vrf_key - pledge - margin_cost - fixed_cost - reward_account - owners - metadata - relays - active_epoch tx_content_pool_retires: type: array items: type: object properties: cert_index: type: integer example: 0 description: Index of the certificate within the transaction pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 stake pool ID retiring_epoch: type: integer example: 216 description: Epoch in which the pool becomes retired required: - cert_index - pool_id - retiring_epoch tx_content_metadata: type: array items: type: object properties: label: type: string description: Metadata label json_metadata: oneOf: - type: string - type: object additionalProperties: true description: Content of the metadata required: - label - json_metadata example: - label: '1967' json_metadata: metadata: https://nut.link/metadata.json hash: 6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af - label: '1968' json_metadata: ADAUSD: - value: '0.10409800535729975' source: ergoOracles tx_content_metadata_cbor: type: array items: type: object properties: label: type: string description: Metadata label cbor_metadata: deprecated: true type: string nullable: true description: Content of the CBOR metadata metadata: type: string nullable: true description: Content of the CBOR metadata in hex required: - label - cbor_metadata - metadata example: - label: '1968' cbor_metadata: \xa100a16b436f6d62696e6174696f6e8601010101010c metadata: a100a16b436f6d62696e6174696f6e8601010101010c tx_content_redeemers: type: array items: type: object properties: tx_index: type: integer example: 0 description: Index of the redeemer within the transaction purpose: type: string enum: - spend - mint - cert - reward example: spend description: Validation purpose script_hash: type: string example: ec26b89af41bef0f7585353831cb5da42b5b37185e0c8a526143b824 description: Script hash redeemer_data_hash: type: string example: 923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec description: Redeemer data hash datum_hash: type: string example: 923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec deprecated: true description: Datum hash unit_mem: type: string example: '1700' description: The budget in Memory to run a script unit_steps: type: string example: '476468' description: The budget in CPU steps to run a script fee: type: string example: '172033' description: The fee consumed to run the script required: - tx_index - purpose - unit_mem - unit_steps - script_hash - redeemer_data_hash - datum_hash - fee account_content: type: object properties: stake_address: type: string example: stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7 description: Bech32 stake address active: type: boolean example: true description: Registration state of an account active_epoch: type: integer nullable: true example: 412 description: Epoch of the most recent action - registration or deregistration controlled_amount: type: string example: '619154618165' description: Balance of the account in Lovelaces rewards_sum: type: string example: '319154618165' description: Sum of all rewards for the account in the Lovelaces withdrawals_sum: type: string example: '12125369253' description: Sum of all the withdrawals for the account in Lovelaces reserves_sum: type: string example: '319154618165' description: Sum of all funds from reserves for the account in the Lovelaces treasury_sum: type: string example: '12000000' description: Sum of all funds from treasury for the account in the Lovelaces withdrawable_amount: type: string example: '319154618165' description: Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces pool_id: type: string nullable: true example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 pool ID that owns the account required: - stake_address - active - active_epoch - controlled_amount - rewards_sum - withdrawals_sum - reserves_sum - treasury_sum - withdrawable_amount - pool_id account_reward_content: type: array items: type: object properties: epoch: type: integer description: Epoch of the associated reward amount: type: string description: Rewards for given epoch in Lovelaces pool_id: type: string description: Bech32 pool ID being delegated to type: type: string enum: - leader - member - pool_deposit_refund description: Type of the reward required: - epoch - amount - pool_id - type example: - epoch: 215 amount: '12695385' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy type: member - epoch: 216 amount: '3586329' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy type: member - epoch: 217 amount: '1' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy type: member - epoch: 217 amount: '1337' pool_id: pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs type: leader - epoch: 218 amount: '1395265' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy type: member - epoch: 218 amount: '500000000' pool_id: pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs type: pool_deposit_refund account_history_content: type: array items: type: object properties: active_epoch: type: integer example: 210 description: Epoch in which the stake was active amount: type: string description: Stake amount in Lovelaces pool_id: type: string description: Bech32 ID of pool being delegated to required: - active_epoch - amount - pool_id example: - active_epoch: 210 amount: '12695385' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - active_epoch: 211 amount: '22695385' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy account_delegation_content: type: array items: type: object properties: active_epoch: type: integer example: 210 description: Epoch in which the delegation becomes active tx_hash: type: string description: Hash of the transaction containing the delegation amount: type: string description: Rewards for given epoch in Lovelaces pool_id: type: string description: Bech32 ID of pool being delegated to required: - active_epoch - tx_hash - amount - pool_id example: - active_epoch: 210 tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531 amount: '12695385' pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - active_epoch: 242 tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0 amount: '12691385' pool_id: pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj account_registration_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction containing the (de)registration certificate action: type: string enum: - registered - deregistered description: Action in the certificate required: - tx_hash - action example: - tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531 action: registered - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0 action: deregistered account_withdrawal_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction containing the withdrawal amount: type: string description: Withdrawal amount in Lovelaces required: - tx_hash - amount example: - tx_hash: 48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5 amount: '454541212442' - tx_hash: 4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34 amount: '97846969' account_mir_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction containing the MIR amount: type: string description: MIR amount in Lovelaces required: - tx_hash - amount example: - tx_hash: 69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d amount: '2193707473' - tx_hash: baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13 amount: '14520198574' account_addresses_content: type: array items: type: object properties: address: type: string description: Address associated with the stake key required: - address example: - address: addr1qx2kd28nq8ac5prwg32hhvudlwggpgfp8utlyqxu6wqgz62f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sy0f4qd - address: addr1qys3czp8s9thc6u2fqed9yq3h24nyw28uk0m6mkgn9dkckjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9suth4w4 - address: addr1q8j55h253zcvl326sk5qdt2n8z7eghzspe0ekxgncr796s2f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sjmd35m - address: addr1q8f7gxrprank3drhx8k5grlux7ene0nlwun8y9thu8mc3yjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sls6vnt account_addresses_assets: type: array items: type: object description: The sum of all assets of all addresses associated with a given account properties: unit: type: string format: Concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc537061636542756433343132 quantity: '1' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '125' account_addresses_total: type: object properties: stake_address: type: string description: Bech32 encoded stake address example: stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk received_sum: type: array items: type: object description: The sum of all the UTXO per asset for all addresses associated with the account properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' sent_sum: type: array items: type: object description: The sum of all the UTXO per asset for all addresses associated with the account properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' tx_count: type: integer example: 12 description: Count of all transactions for all addresses associated with the account required: - stake_address - received_sum - sent_sum - tx_count mempool_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction required: - tx_hash example: - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 mempool_tx_content: type: object properties: tx: type: object properties: hash: type: string example: 1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477 description: Transaction hash output_amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' fees: type: string example: '182485' description: Fees of the transaction in Lovelaces deposit: type: string example: '0' description: Deposit within the transaction in Lovelaces size: type: integer example: 433 description: Size of the transaction in Bytes invalid_before: type: string nullable: true example: null description: Left (included) endpoint of the timelock validity intervals invalid_hereafter: type: string nullable: true example: '13885913' description: Right (excluded) endpoint of the timelock validity intervals utxo_count: type: integer example: 4 description: Count of UTXOs within the transaction withdrawal_count: type: integer example: 0 description: Count of the withdrawals within the transaction mir_cert_count: type: integer example: 0 description: Count of the MIR certificates within the transaction delegation_count: type: integer example: 0 description: Count of the delegations within the transaction stake_cert_count: type: integer example: 0 description: Count of the stake keys (de)registration within the transaction pool_update_count: type: integer example: 0 description: Count of the stake pool registration and update certificates within the transaction pool_retire_count: type: integer example: 0 description: Count of the stake pool retirement certificates within the transaction asset_mint_or_burn_count: type: integer example: 0 description: Count of asset mints and burns within the transaction redeemer_count: type: integer example: 0 description: Count of redeemers within the transaction valid_contract: type: boolean example: true description: True if contract script passed validation required: - hash - output_amount - fees - deposit - size - invalid_before - invalid_hereafter - utxo_count - withdrawal_count - mir_cert_count - delegation_count - stake_cert_count - pool_update_count - pool_retire_count - asset_mint_or_burn_count - redeemer_count - valid_contract inputs: type: array items: type: object properties: address: type: string example: addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv description: Input address tx_hash: type: string example: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 description: Hash of the UTXO transaction output_index: type: integer example: 0 description: UTXO index in the transaction collateral: type: boolean example: false description: Whether the input is a collateral consumed on script validation failure reference: type: boolean example: false description: Whether the input is a reference transaction input required: - tx_hash - output_index - collateral outputs: type: array items: type: object properties: address: type: string example: addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv description: Output address amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' output_index: type: integer example: 0 description: UTXO index in the transaction data_hash: type: string nullable: true description: The hash of the transaction output datum example: 9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710 inline_datum: type: string nullable: true description: CBOR encoded inline datum example: 19a6aa collateral: type: boolean example: false description: Whether the output is a collateral output reference_script_hash: type: string nullable: true description: The hash of the reference script of the output example: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 required: - address - amount - output_index - data_hash - inline_datum - collateral - reference_script_hash redeemers: type: array items: type: object properties: tx_index: type: integer example: 0 description: Index of the redeemer within the transaction purpose: type: string enum: - spend - mint - cert - reward example: spend description: Validation purpose unit_mem: type: string example: '1700' description: The budget in Memory to run a script unit_steps: type: string example: '476468' description: The budget in CPU steps to run a script required: - tx_index - purpose - unit_mem - unit_steps required: - tx - inputs - outputs mempool_addresses_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction required: - tx_hash example: - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 tx_metadata_labels: type: array items: type: object properties: label: type: string description: Metadata label cip10: type: string nullable: true description: CIP10 defined description count: type: string description: The count of metadata entries with a specific label required: - label - cip10 - count example: - label: '1990' cip10: null count: '1' - label: '1967' cip10: nut.link metadata oracles registry count: '3' - label: '1968' cip10: nut.link metadata oracles data points count: '16321' tx_metadata_label_json: type: array items: type: object properties: tx_hash: type: string description: Transaction hash that contains the specific metadata json_metadata: additionalProperties: true anyOf: - type: string - type: object additionalProperties: true - type: array items: {} - type: integer - type: number - type: boolean nullable: true description: Content of the JSON metadata required: - tx_hash - json_metadata example: - tx_hash: 257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8 json_metadata: ADAUSD: - value: '0.10409800535729975' source: ergoOracles - tx_hash: e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c json_metadata: ADAUSD: - value: '0.15409850555139935' source: ergoOracles - tx_hash: 4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be json_metadata: null tx_metadata_label_cbor: type: array items: type: object properties: tx_hash: type: string description: Transaction hash that contains the specific metadata cbor_metadata: deprecated: true type: string nullable: true description: Content of the CBOR metadata metadata: type: string nullable: true description: Content of the CBOR metadata in hex required: - tx_hash - cbor_metadata - metadata example: - tx_hash: 257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8 cbor_metadata: null metadata: null - tx_hash: e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c cbor_metadata: null metadata: null - tx_hash: 4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be cbor_metadata: \xa100a16b436f6d62696e6174696f6e8601010101010c metadata: a100a16b436f6d62696e6174696f6e8601010101010c address_content: type: object properties: address: type: string description: Bech32 encoded addresses example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' stake_address: type: string nullable: true example: stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7 description: Stake address that controls the key type: type: string enum: - byron - shelley example: shelley description: Address era script: type: boolean example: false description: True if this is a script address required: - address - amount - stake_address - type - script address_content_extended: type: object properties: address: type: string description: Bech32 encoded addresses example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit decimals: type: integer nullable: true description: Number of decimal places of the asset unit. Primary data source is CIP68 reference NFT with a fallback to off-chain metadata. has_nft_onchain_metadata: type: boolean description: True if the latest minting transaction includes metadata (best-effort) required: - unit - quantity - decimals - has_nft_onchain_metadata example: - unit: lovelace quantity: '42000000' decimals: 6 has_nft_onchain_metadata: false - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' decimals: null has_nft_onchain_metadata: true stake_address: type: string nullable: true example: stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7 description: Stake address that controls the key type: type: string enum: - byron - shelley example: shelley description: Address era script: type: boolean example: false description: True if this is a script address required: - address - amount - stake_address - type - script address_content_total: type: object properties: address: type: string description: Bech32 encoded address example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz received_sum: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' sent_sum: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity example: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' tx_count: type: integer example: 12 description: Count of all transactions on the address required: - address - received_sum - sent_sum - tx_count address_utxo_content: type: array items: type: object properties: address: type: string description: Bech32 encoded addresses - useful when querying by payment_cred example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz tx_hash: type: string description: Transaction hash of the UTXO tx_index: type: integer deprecated: true description: UTXO index in the transaction output_index: type: integer description: UTXO index in the transaction amount: type: array items: type: object description: The sum of all the UTXO per asset properties: unit: type: string format: Lovelace or concatenation of asset policy_id and hex-encoded asset_name description: The unit of the value quantity: type: string description: The quantity of the unit required: - unit - quantity block: type: string description: Block hash of the UTXO data_hash: type: string nullable: true description: The hash of the transaction output datum inline_datum: type: string nullable: true description: CBOR encoded inline datum example: 19a6aa reference_script_hash: type: string nullable: true description: The hash of the reference script of the output example: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 required: - address - tx_hash - tx_index - output_index - amount - block - data_hash - inline_datum - reference_script_hash example: - address: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz tx_hash: 39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58 output_index: 0 amount: - unit: lovelace quantity: '42000000' block: 7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6 data_hash: 9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710 inline_datum: null reference_script_hash: null - address: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz tx_hash: 4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49 output_index: 0 amount: - unit: lovelace quantity: '729235000' block: 953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7 data_hash: null inline_datum: null reference_script_hash: null - address: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz tx_hash: 768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2 output_index: 1 amount: - unit: lovelace quantity: '42000000' - unit: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '12' block: 5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7 data_hash: null inline_datum: null reference_script_hash: null address_txs_content: type: array items: type: string description: Hash of the transaction example: - 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531 - 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0 address_transactions_content: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction tx_index: type: integer description: Transaction index within the block block_height: type: integer description: Block height block_time: type: integer description: Block creation time in UNIX time required: - tx_hash - tx_index - block_height - block_time example: - tx_hash: 8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b tx_index: 6 block_height: 69 block_time: 1635505891 - tx_hash: 52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f tx_index: 9 block_height: 4547 block_time: 1635505987 - tx_hash: e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b tx_index: 0 block_height: 564654 block_time: 1834505492 pool_list: type: array items: type: string description: Bech32 encoded pool ID example: - pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy - pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288 - pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2 pool_list_extended: type: array items: type: object properties: pool_id: type: string example: pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt description: Bech32 encoded pool ID hex: type: string example: 0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735 description: Hexadecimal pool ID. active_stake: type: string example: '4200000000' description: Active delegated amount live_stake: type: string example: '6900000000' description: Currently delegated amount required: - pool_id - hex - active_stake - live_stake example: - pool_id: pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q hex: 2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1 active_stake: '1541200000' live_stake: '1541400000' - pool_id: pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx hex: 6b3fda88053dc2cee18a7c2736f032182fcc78a2fe912e869aa4edcd active_stake: '22200000' live_stake: '48955550' - pool_id: pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w hex: 73318ec975cf1125a6367cbb1c9a406cbcb3e510e49d7c3aab14aa31 active_stake: '9989541215' live_stake: '168445464878' pool_list_retire: type: array items: type: object properties: pool_id: type: string example: pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt description: Bech32 encoded pool ID epoch: type: integer example: 242 description: Retirement epoch number required: - pool_id - epoch example: - pool_id: pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q epoch: 225 - pool_id: pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx epoch: 215 - pool_id: pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w epoch: 231 pool: type: object properties: pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 pool ID hex: type: string example: 0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735 description: Hexadecimal pool ID. vrf_key: type: string example: 0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233 description: VRF key hash blocks_minted: type: integer example: 69 description: Total minted blocks blocks_epoch: type: integer example: 4 description: Number of blocks minted in the current epoch live_stake: type: string example: '6900000000' live_size: type: number example: 0.42 live_saturation: type: number example: 0.93 live_delegators: type: number example: 127 active_stake: type: string example: '4200000000' active_size: type: number example: 0.43 declared_pledge: type: string example: '5000000000' description: Stake pool certificate pledge live_pledge: type: string example: '5000000001' description: Stake pool current pledge margin_cost: type: number example: 0.05 description: Margin tax cost of the stake pool fixed_cost: type: string example: '340000000' description: Fixed tax cost of the stake pool reward_account: type: string example: stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f description: Bech32 reward account of the stake pool owners: type: array items: type: string description: Bech32 accounts of the pool owners example: - stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v registration: type: array items: type: string description: Hash of the transaction including registration example: - 9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc - 7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95 - 3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9 retirement: type: array items: type: string description: Hash of the transaction including retirement example: 252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8 required: - pool_id - hex - vrf_key - blocks_minted - blocks_epoch - live_stake - live_size - live_saturation - live_delegators - active_stake - active_size - declared_pledge - live_pledge - margin_cost - fixed_cost - reward_account - owners - registration - retirement pool_history: type: array items: type: object properties: epoch: type: integer example: 233 description: Epoch number blocks: type: integer example: 22 description: Number of blocks created by pool active_stake: type: string example: '20485965693569' description: Active (Snapshot of live stake 2 epochs ago) stake in Lovelaces active_size: type: number example: 1.2345 description: Pool size (percentage) of overall active stake at that epoch delegators_count: type: integer example: 115 description: Number of delegators for epoch rewards: type: string example: '206936253674159' description: Total rewards received before distribution to delegators fees: type: string example: '1290968354' description: Pool operator rewards required: - epoch - blocks - active_stake - active_size - delegators_count - rewards - fees pool_metadata: type: object properties: pool_id: type: string example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy description: Bech32 pool ID hex: type: string example: 0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735 description: Hexadecimal pool ID url: type: string nullable: true example: https://stakenuts.com/mainnet.json description: URL to the stake pool metadata hash: type: string nullable: true example: 47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c description: Hash of the metadata file ticker: type: string nullable: true example: NUTS description: Ticker of the stake pool name: type: string nullable: true example: Stake Nuts description: Name of the stake pool description: type: string nullable: true example: The best pool ever description: Description of the stake pool homepage: type: string nullable: true example: https://stakentus.com/ description: Home page of the stake pool required: - pool_id - hex - url - hash - ticker - name - description - homepage empty_object: type: object pool_relays: type: array items: type: object properties: ipv4: type: string nullable: true example: 4.4.4.4 description: IPv4 address of the relay ipv6: type: string nullable: true example: https://stakenuts.com/mainnet.json description: IPv6 address of the relay dns: type: string nullable: true example: relay1.stakenuts.com description: DNS name of the relay dns_srv: type: string nullable: true example: _relays._tcp.relays.stakenuts.com description: DNS SRV entry of the relay port: type: integer example: 3001 description: Network port of the relay required: - ipv4 - ipv6 - dns - dns_srv - port pool_delegators: type: array items: type: object properties: address: type: string description: Bech32 encoded stake addresses live_stake: type: string description: Currently delegated amount required: - address - live_stake example: - address: stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha live_stake: '1137959159981411' - address: stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u live_stake: '16958865648' - address: stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck live_stake: '18605647' pool_blocks: type: array items: type: string description: Block hashes example: - d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d - 026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c - bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c - 86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7 pool_updates: type: array items: type: object properties: tx_hash: type: string description: Transaction ID cert_index: type: integer description: Certificate within the transaction action: type: string enum: - registered - deregistered description: Action in the certificate required: - tx_hash - cert_index - action example: - tx_hash: 6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad cert_index: 0 action: registered - tx_hash: 9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005 cert_index: 0 action: deregistered - tx_hash: e14a75b0eb2625de7055f1f580d70426311b78e0d36dd695a6bdc96c7b3d80e0 cert_index: 1 action: registered assets: type: array items: type: object properties: asset: type: string format: Concatenation of the policy_id and hex-encoded asset_name description: Asset identifier quantity: type: string description: Current asset quantity required: - asset - quantity example: - asset: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '1' - asset: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e75d quantity: '100000' - asset: 6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad quantity: '18605647' asset: type: object properties: asset: type: string example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e description: Hex-encoded asset full name policy_id: type: string example: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7 description: Policy ID of the asset asset_name: type: string nullable: true example: 6e7574636f696e description: Hex-encoded asset name of the asset fingerprint: type: string example: asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w description: CIP14 based user-facing fingerprint quantity: type: string example: '12000' description: Current asset quantity initial_mint_tx_hash: type: string example: 6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad description: ID of the initial minting transaction mint_or_burn_count: type: integer example: 1 description: Count of mint and burn transactions onchain_metadata: type: object nullable: true additionalProperties: true description: | On-chain metadata which SHOULD adhere to the valid standards, based on which we perform the look up and display the asset (best effort) onchain_metadata_standard: type: string nullable: true enum: - CIP25v1 - CIP25v2 - CIP68v1 description: | If on-chain metadata passes validation, we display the standard under which it is valid onchain_metadata_extra: type: string nullable: true description: | Arbitrary plutus data (CIP68). metadata: type: object nullable: true description: | Off-chain metadata fetched from GitHub based on network. Mainnet: https://github.com/cardano-foundation/cardano-token-registry/ Testnet: https://github.com/input-output-hk/metadata-registry-testnet/ properties: name: type: string example: nutcoin description: Asset name description: type: string example: The Nut Coin description: Asset description ticker: type: string nullable: true example: nutc url: type: string nullable: true example: https://www.stakenuts.com/ description: Asset website logo: type: string nullable: true example: iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII= description: Base64 encoded logo of the asset decimals: type: integer nullable: true maximum: 255 example: 6 description: Number of decimal places of the asset unit required: - name - description - ticker - url - logo - decimals required: - asset - policy_id - asset_name - fingerprint - quantity - initial_mint_tx_hash - mint_or_burn_count - metadata - onchain_metadata asset_history: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction containing the asset action action: type: string enum: - minted - burned description: Action executed upon the asset policy amount: type: string description: Asset amount of the specific action required: - tx_hash - action - amount example: - tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531 amount: '10' action: minted - tx_hash: 9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005 amount: '5' action: burned - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0 amount: '5' action: burned asset_txs: type: array items: type: string description: Hash of the transaction example: - 8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b - 52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f - e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b asset_transactions: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction tx_index: type: integer description: Transaction index within the block block_height: type: integer description: Block height block_time: type: integer example: 1635505891 description: Block creation time in UNIX time required: - tx_hash - tx_index - block_height - block_time example: - tx_hash: 8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b tx_index: 6 block_height: 69 block_time: 1635505891 - tx_hash: 52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f tx_index: 9 block_height: 4547 block_time: 1635505987 - tx_hash: e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b tx_index: 0 block_height: 564654 block_time: 1834505492 asset_addresses: type: array items: type: object properties: address: type: string description: Address containing the specific asset quantity: type: string description: Asset quantity on the specific address required: - address - quantity example: - address: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz quantity: '1' - address: addr1qyhr4exrgavdcn3qhfcc9f939fzsch2re5ry9cwvcdyh4x4re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qdpvhza quantity: '100000' - address: addr1q8zup8m9ue3p98kxlxl9q8rnyan8hw3ul282tsl9s326dfj088lvedv4zckcj24arcpasr0gua4c5gq4zw2rpcpjk2lq8cmd9l quantity: '18605647' asset_policy: type: array items: type: object properties: asset: type: string description: Concatenation of the policy_id and hex-encoded asset_name quantity: type: string description: Current asset quantity required: - asset - quantity example: - asset: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e quantity: '1' - asset: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a766e quantity: '100000' - asset: b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb574636f696e quantity: '18605647' scripts: type: array items: type: object properties: script_hash: type: string description: Script hash required: - script_hash example: - script_hash: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 - script_hash: e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e - script_hash: a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54 script: type: object properties: script_hash: type: string example: 13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1 description: Script hash type: type: string enum: - timelock - plutusV1 - plutusV2 example: plutusV1 description: Type of the script language serialised_size: type: integer nullable: true description: The size of the CBOR serialised script, if a Plutus script example: 3119 required: - script_hash - type - serialised_size script_json: type: object properties: json: additionalProperties: true anyOf: - type: string - type: object additionalProperties: true - type: array items: {} - type: integer - type: number - type: boolean nullable: true description: JSON contents of the `timelock` script, null for `plutus` scripts required: - json example: json: type: atLeast scripts: - type: sig keyHash: 654891a4db2ea44b5263f4079a33efa0358ba90769e3d8f86a4a0f81 - type: sig keyHash: 8685ad48f9bebb8fdb6447abbe140645e0bf743ff98da62e63e2147f - type: sig keyHash: cb0f3b3f91693374ff7ce1d473cf6e721c7bab52b0737f04164e5a2d required: 2 script_cbor: type: object properties: cbor: type: string nullable: true description: CBOR contents of the `plutus` script, null for `timelocks` required: - cbor example: cbor: 4e4d01000033222220051200120011 script_redeemers: type: array items: type: object properties: tx_hash: type: string example: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0 description: Hash of the transaction tx_index: type: integer example: 0 description: The index of the redeemer pointer in the transaction purpose: type: string enum: - spend - mint - cert - reward example: spend description: Validation purpose redeemer_data_hash: type: string example: 923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec description: Datum hash of the redeemer datum_hash: type: string example: 923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec description: Datum hash deprecated: true unit_mem: type: string example: '1700' description: The budget in Memory to run a script unit_steps: type: string example: '476468' description: The budget in CPU steps to run a script fee: type: string example: '172033' description: The fee consumed to run the script required: - tx_hash - tx_index - purpose - redeemer_data_hash - datum_hash - unit_mem - unit_steps - fee script_datum: type: object properties: json_value: type: object additionalProperties: true description: JSON content of the datum required: - json_value example: json_value: int: 42 script_datum_cbor: type: object properties: cbor: type: string description: CBOR serialized datum required: - cbor example: cbor: 19a6aa utils_addresses_xpub: type: object properties: xpub: type: string description: Script hash role: type: integer description: Account role index: type: integer description: Address index address: type: string description: Derived address required: - xpub - role - index - address example: - xpub: d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a role: 0 index: 0 address: addr1q90sqnljxky88s0jsnps48jd872p7znzwym0jpzqnax6qs5nfrlkaatu28n0qzmqh7f2cpksxhpc9jefx3wrl0a2wu8q5amen7 metrics: type: array items: type: object properties: time: type: integer description: Starting time of the call count interval (ends midnight UTC) in UNIX time calls: type: integer description: Sum of all calls for a particular day required: - time - calls example: - time: 1612543884 calls: 42 - time: 1614523884 calls: 6942 metrics_endpoints: type: array items: type: object properties: time: type: integer description: Starting time of the call count interval (ends midnight UTC) in UNIX time calls: type: integer description: Sum of all calls for a particular day and endpoint endpoint: type: string description: Endpoint parent name required: - time - calls - endpoint example: - time: 1612543814 calls: 182 endpoint: block - time: 1612543814 calls: 42 endpoint: epoch - time: 1612543812 calls: 775 endpoint: block - time: 1612523884 calls: 4 endpoint: epoch - time: 1612553884 calls: 89794 endpoint: block network: type: object properties: supply: type: object properties: max: type: string description: Maximum supply in Lovelaces example: '45000000000000000' total: type: string description: Current total (max supply - reserves) supply in Lovelaces example: '32890715183299160' circulating: type: string description: Current circulating (UTXOs + withdrawables) supply in Lovelaces example: '32412601976210393' locked: type: string description: Current supply locked by scripts in Lovelaces example: '125006953355' treasury: type: string description: Current supply locked in treasury example: '98635632000000' reserves: type: string description: Current supply locked in reserves example: '46635632000000' required: - max - total - circulating - locked - treasury - reserves stake: type: object properties: live: type: string example: '23204950463991654' description: Current live stake in Lovelaces active: type: string description: Current active stake in Lovelaces example: '22210233523456321' required: - live - active required: - supply - stake network-eras: type: array items: type: object properties: start: type: object description: | Start of the blockchain era, relative to the start of the network properties: time: type: number description: Time in seconds relative to the start time of the network slot: type: integer description: Absolute slot number epoch: type: integer description: Epoch number required: - time - slot - epoch end: type: object description: | End of the blockchain era, relative to the start of the network properties: time: type: number description: Time in seconds relative to the start time of the network slot: type: integer description: Absolute slot number epoch: type: integer description: Epoch number required: - time - slot - epoch parameters: type: object description: Era parameters properties: epoch_length: type: integer description: Epoch length in number of slots slot_length: type: number description: Slot length in seconds safe_zone: type: integer description: Zone in which it is guaranteed that no hard fork can take place required: - epoch_length - slot_length - safe_zone required: - start - end - parameters example: - start: time: 0 slot: 0 epoch: 0 end: time: 89856000 slot: 4492800 epoch: 208 parameters: epoch_length: 21600 slot_length: 20 safe_zone: 4320 - start: time: 89856000 slot: 4492800 epoch: 208 end: time: 101952000 slot: 16588800 epoch: 236 parameters: epoch_length: 432000 slot_length: 1 safe_zone: 129600 nutlink_address: type: object properties: address: type: string description: Bech32 encoded address example: addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz metadata_url: type: string description: URL of the specific metadata file example: https://nut.link/metadata.json metadata_hash: type: string description: Hash of the metadata file example: 6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af metadata: type: object nullable: true description: The cached metadata of the `metadata_url` file. additionalProperties: true required: - address - metadata_url - metadata_hash - metadata nutlink_address_tickers: type: array items: type: object properties: name: type: string description: Name of the ticker count: type: integer description: Number of ticker records latest_block: type: integer description: Block height of the latest record required: - name - count - latest_block example: - name: ADAUSD count: 1980038 latest_block: 2657092 - name: ADAEUR count: 1980038 latest_block: 2657092 - name: ADABTC count: 1980038 latest_block: 2657092 nutlink_address_ticker: type: array items: type: object properties: tx_hash: type: string description: Hash of the transaction block_height: type: integer description: Block height of the record tx_index: type: integer description: Transaction index within the block payload: anyOf: - type: string - type: object - type: array items: {} - type: integer - type: number - type: boolean additionalProperties: true description: Content of the ticker required: - tx_hash - tx_index - block_height - payload example: - tx_hash: e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b block_height: 2657092 tx_index: 8 payload: - source: coinGecko value: '1.29' - source: cryptoCompare value: '1.283' nutlink_tickers_ticker: type: array items: type: object properties: address: type: string description: Address of a metadata oracle tx_hash: type: string description: Hash of the transaction block_height: type: integer description: Block height of the record tx_index: type: integer description: Transaction index within the block payload: anyOf: - type: string - type: object - type: array items: {} - type: integer - type: number - type: boolean additionalProperties: true description: Content of the ticker required: - address - tx_hash - block_height - tx_index - payload example: - address: addr_test1qpmtp5t0t5y6cqkaz7rfsyrx7mld77kpvksgkwm0p7en7qum7a589n30e80tclzrrnj8qr4qvzj6al0vpgtnmrkkksnqd8upj0 tx_hash: e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b block_height: 2657092 tx_index: 8 payload: - source: coinGecko value: '1.29' - source: cryptoCompare value: '1.283' asset_onchain_metadata_cip25: type: object additionalProperties: true description: | On-chain metadata stored in the minting transaction under label 721, which adheres to https://cips.cardano.org/cips/cip25/ properties: name: type: string description: Name of the asset example: My NFT token image: oneOf: - type: string - type: array items: type: string description: URI(s) of the associated asset example: ipfs://ipfs/QmfKyJ4tuvHowwKQCbCHj4L5T3fSj8cjs7Aau8V7BWv226 description: oneOf: - type: string - type: array items: type: string description: Additional description example: My NFT token description mediaType: type: string description: Mime sub-type of image example: image/jpeg files: type: array items: type: object additionalProperties: true properties: name: type: string description: Name of the file example: myimage mediaType: type: string description: Mime sub-type of image example: image/jpeg src: oneOf: - type: string - type: array items: type: string description: URI pointing to a resource of this mime type example: My NFT token description required: - mediaType - src required: - name - image asset_onchain_metadata_cip68_ft_333: type: object additionalProperties: true description: | On-chain metadata stored in the datum of the reference NFT output which adheres to 333 FT Standard https://cips.cardano.org/cips/cip68/ properties: name: type: string description: Name of the asset example: My FT token description: type: string description: Additional description example: My FT token description logo: type: string description: URI(s) of the associated asset example: ipfs://ipfs/QmfKyJ4tuvHowwKQCbCHj4L5T3fSj8cjs7Aau8V7BWv226 ticker: type: string description: Ticker example: TOK decimals: type: number description: Number of decimals example: 8 required: - name - description asset_onchain_metadata_cip68_nft_222: type: object additionalProperties: true description: | On-chain metadata stored in the datum of the reference NFT output which adheres to 222 NFT Standard https://cips.cardano.org/cips/cip68/ properties: name: type: string description: Name of the asset example: My NFT token image: type: string description: URI(s) of the associated asset example: ipfs://ipfs/QmfKyJ4tuvHowwKQCbCHj4L5T3fSj8cjs7Aau8V7BWv226 description: type: string description: Additional description example: My NFT token description mediaType: type: string description: Mime sub-type of image example: image/jpeg files: type: array items: type: object additionalProperties: true properties: name: type: string description: Name of the file example: myimage mediaType: type: string description: Mime sub-type of image example: image/jpeg src: oneOf: - type: string - type: array items: type: string description: URI pointing to a resource of this mime type example: My NFT token description required: - mediaType - src required: - name - image asset_onchain_metadata_cip68_rft_444: type: object additionalProperties: true description: | On-chain metadata stored in the datum of the reference NFT output which adheres to 222 NFT Standard https://cips.cardano.org/cips/cip68/ properties: name: type: string description: Name of the asset example: My NFT token image: type: string description: URI(s) of the associated asset example: ipfs://ipfs/QmfKyJ4tuvHowwKQCbCHj4L5T3fSj8cjs7Aau8V7BWv226 description: type: string description: Additional description example: My NFT token description mediaType: type: string description: Mime sub-type of image example: image/jpeg decimals: type: number description: Number of decimals example: 8 files: type: array items: type: object additionalProperties: true properties: name: type: string description: Name of the file example: myimage mediaType: type: string description: Mime sub-type of image example: image/jpeg src: oneOf: - type: string - type: array items: type: string description: URI pointing to a resource of this mime type example: My NFT token description required: - mediaType - src required: - name - image securitySchemes: project_id: type: apiKey in: header name: project_id description: | There are multiple token types available based on network you choose when creating a Blockfrost a project, for a list of token types see available networks. responses: '400': description: Bad request content: application/json: schema: type: object properties: status_code: type: integer example: 400 error: type: string example: Bad Request message: type: string example: Backend did not understand your request. required: - error - message - status_code '403': description: Authentication secret is missing or invalid content: application/json: schema: type: object properties: status_code: type: integer example: 403 error: type: string example: Forbidden message: type: string example: Invalid project token. required: - error - message - status_code '404': description: Component not found content: application/json: schema: type: object properties: status_code: type: integer example: 404 error: type: string example: Not Found message: type: string example: The requested component has not been found. required: - error - message - status_code '418': description: IP has been auto-banned for extensive sending of requests after usage limit has been reached content: application/json: schema: type: object properties: status_code: type: integer example: 418 error: type: string example: Requested Banned message: type: string example: IP has been auto-banned for flooding. required: - error - message - status_code '425': description: Mempool is already full, not accepting new txs straight away content: application/json: schema: type: object properties: status_code: type: integer example: 425 error: type: string example: Mempool Full message: type: string example: Mempool is full, please try resubmitting again later. required: - error - message - status_code '429': description: Usage limit reached content: application/json: schema: type: object properties: status_code: type: integer example: 429 error: type: string example: Project Over Limit message: type: string example: Usage is over limit. required: - error - message - status_code '500': description: Internal Server Error content: application/json: schema: type: object properties: status_code: type: integer example: 500 error: type: string example: Internal Server Error message: type: string example: An unexpected response was received from the backend. required: - error - message - status_code 425-2: description: Pin queue is currently full, not accepting new txs straight away content: application/json: schema: type: object properties: status_code: type: integer example: 425 error: type: string example: Pin Queue Full message: type: string example: Your pin queue is currently full, please try pinning again later. required: - error - message - status_code