Blockchain Indexer API
{ "openapi": "3.0.3", "info": { "title": "Maestro dApp Platform - Blockchain Indexer API", "description": "https://docs.gomaestro.org/Cardano/Intro", "contact": { "name": "Maestro Blockchain Inc.", "url": "https://gomaestro.org/", "email": "[email protected]" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.txt" }, "version": "v1.8.0" }, "servers": [ { "url": "https://mainnet.gomaestro-api.org/v1", "description": "Cardano Mainnet" }, { "url": "https://preprod.gomaestro-api.org/v1", "description": "Cardano Preprod" }, { "url": "https://preview.gomaestro-api.org/v1", "description": "Cardano Preview" } ], "paths": { "/accounts/{stake_addr}": { "get": { "tags": [ "Accounts" ], "summary": "Stake account information", "description": "Returns various information regarding a stake account", "operationId": "account_info", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded reward/stake address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Information about the account", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedAccountInfo" }, "example": { "data": { "stake_address": "stake_test1uzq7mcr5mmj2jeqqf5eaxxd4sdzvszqnd26vnz5nvn0mcaqte3ycr", "registered": true, "delegated_pool": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "rewards_available": 24648659341, "utxo_balance": 249497357989, "total_balance": 274146017330, "total_rewarded": 24648659341, "total_withdrawn": 0 }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "d99c239b6fae8036b3057b6837a563d045ce2a393e17d789d1e85c51bee898fc", "block_slot": 32265099 } } } } }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/addresses": { "get": { "tags": [ "Accounts" ], "summary": "Stake account addresses", "description": "Returns a list of addresses seen on-chain which use the specified stake key. By default returns addresses which currently control at least one UTxO, or use include_empty query parameter to also return addresses which don't currently control any UTxOs.", "operationId": "account_addresses", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded stake/reward address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "include_empty", "in": "query", "description": "Include addresses that have been seen on-chain but have no balance", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Addresses seen on-chain which contain the specified stake key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAddress" }, "example": { "data": [ "addr_test1qpshevet4xrh7h2rr7pm3r7ysn8x9hk5gek9xvm6du3yl6upahs8fhhy49jqqnfn6vvmtq6yeqypx645ex9fxexlh36q9scvx8" ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bbd15af995f81cf22e559679865d5a0fb1ba348559cf88e07686234e499859c4", "block_slot": 32208435 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/assets": { "get": { "tags": [ "Accounts" ], "summary": "Stake account assets", "description": "Returns a list of native assets which are owned by addresses with the specified stake key", "operationId": "account_assets", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded reward/stake address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "policy", "in": "query", "description": "Filter results to only show assets of the specified policy", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "A list of assets which are owned by addresses that use the specified stake key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAsset" }, "example": { "data": [ { "unit": "01a67bf1c1b29912b17d53a31fa4b650da2dd136ff24ecc84f452ff047616d654368616e6765724e4654202331", "amount": 5 }, { "unit": "01a67bf1c1b29912b17d53a31fa4b650da2dd136ff24ecc84f452ff047616d654368616e6765724e4654202332", "amount": 6 }, { "unit": "01a67bf1c1b29912b17d53a31fa4b650da2dd136ff24ecc84f452ff047616d654368616e6765724e4654202333", "amount": 7 }, { "unit": "2f7e0f588efe4e2836c829c50619a498ddf5521255bf5e1e9f9f5a1346616b65555344", "amount": 864 }, { "unit": "833a41706977b6c54edba264a7ea9dc4390728a05c69cb53d8081df147616d654368616e676572546f6b656ef09f9a80", "amount": 2 }, { "unit": "cc5827d01be77807a48d7e3b70a7c32667722bce7957a61ca52f4e0d47616d654368616e676572546f6b656ef09f9a80", "amount": 70 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "27b0866a073a5068bd6a24a009beba68f8951c6bf2ae4c72a734c8566ecabfc2", "block_slot": 32208940 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/delegations": { "get": { "tags": [ "Accounts" ], "summary": "Stake account delegation history", "description": "Returns list of delegation actions relating to a stake account", "operationId": "account_delegations", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded stake/reward address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by epoch number)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Stake account delegations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAccountDelegation" }, "example": { "data": [ { "active_epoch_no": 397, "pool_id": "pool1jst7rrhucnp93hepezv5yqy6fx982xs2v0udwfc5ea6my3kfak7", "slot": 85518752 }, { "active_epoch_no": 462, "pool_id": "pool1ywpt43nttzjd7883wafg255mh0hmjypwe65ercw6p2sxg5lt7ez", "slot": 113498793 } ], "last_updated": { "timestamp": "2024-01-12 14:06:24", "block_hash": "8295c809a899e67bbf6a1a90408eb5b9f5b563e64931e1db2fa51ac057a9716f", "block_slot": 113502093 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/history": { "get": { "tags": [ "Accounts" ], "summary": "Stake account history", "description": "Returns per-epoch history for the specified stake key", "operationId": "account_history", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded stake/reward address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "epoch_no", "in": "query", "description": "Fetch result for only a specific epoch", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by epoch number)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Per-epoch history of the specified stake key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAccountHistory" }, "example": { "data": [ { "epoch_no": 73, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 270921649109 }, { "epoch_no": 74, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 271442847622 }, { "epoch_no": 75, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 271984526388 }, { "epoch_no": 76, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 272520020301 }, { "epoch_no": 77, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 273058079938 }, { "epoch_no": 78, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp", "active_stake": 273611950245 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "b48416b482bdfda2a3c1ccbe220f84f74256d3e457bd064edea8dc45dc7e22e1", "block_slot": 32209052 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/rewards": { "get": { "tags": [ "Accounts" ], "summary": "Stake account rewards", "description": "Returns a list of staking-related rewards for the specified stake key (pool member or leader rewards, deposit refund)", "operationId": "account_rewards", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded stake/reward address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by epoch number)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Staking rewards for the specified stake key (pool-member and pool-leader rewards, deposit refunds)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAccountReward" }, "example": { "data": [ { "type": "leader", "earned_epoch": 68, "spendable_epoch": 70, "amount": 576671933, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp" }, { "type": "leader", "earned_epoch": 69, "spendable_epoch": 71, "amount": 567061410, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp" }, { "type": "leader", "earned_epoch": 70, "spendable_epoch": 72, "amount": 559723577, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp" }, { "type": "leader", "earned_epoch": 71, "spendable_epoch": 73, "amount": 521198513, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp" }, { "type": "leader", "earned_epoch": 72, "spendable_epoch": 74, "amount": 541678766, "pool_id": "pool1egfg26w0syqly9qc65hz33gqv2qrzyka8tfue3ccsk3c73a56jp" } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "82b6eee6d8bc3ca82e450d94bed5bfbb7859417840e3db8a3bf639a46bcbe379", "block_slot": 32265228 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/accounts/{stake_addr}/updates": { "get": { "tags": [ "Accounts" ], "summary": "Stake account updates", "description": "Returns a list of updates relating to the specified stake key (registration, deregistration, delegation, withdrawal)", "operationId": "account_updates", "parameters": [ { "name": "stake_addr", "in": "path", "description": "Bech32 encoded stake/reward address ('stake1...')", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by absolute slot)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Updates relating to the specified stake key (registration, deregistration, delegation, withdrawal)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAccountUpdate" }, "example": { "data": [ { "action": "registration", "tx_hash": "3058ba8de662ea6bd6572aeea69047c74de1eb4989c75e818d0d2ea4cb3f0a10", "epoch_no": 162, "abs_slot": 68770093, "deposit": "2000000" }, { "action": "withdrawal", "tx_hash": "c90b48bcb8ec6b2ab1c622f55b34e488cc235d01907072014f9aaa58d883aba2", "epoch_no": 162, "abs_slot": 68770469, "deposit": null }, { "action": "withdrawal", "tx_hash": "4e1bea9b85be4fa9ca2c88e941b7e58da84e026b5d95088e4e387f1bbccbfa40", "epoch_no": 162, "abs_slot": 68771196, "deposit": null } ], "last_updated": { "timestamp": "2022-08-16 09:01:44", "block_hash": "b740737679995380c05b41fc82a9e383c56c931770c46d04967532844792dfec", "block_slot": 69074213 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/cred/transactions": { "post": { "tags": [ "Addresses" ], "summary": "Transactions by multiple payment credentials", "description": "Returns transactions in which at least one of a list specified payment credentials spent or received funds, or was a required signer.\n\nSpecifically, "spent or received funds" meaning: the payment credential was used in an address which controlled at least one of the transaction inputs and/or receives one of the outputs AND the transaction is phase-2 valid, OR, the address controlled at least one of the collateral inputs and/or receives the collateral return output AND the transaction is phase-2 invalid. Read more.", "operationId": "txs_by_payment_creds", "parameters": [ { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions minted on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "example": [ "addr_vkh1wdkle2sprqsuklt34474g6n4ps7k6pv6zwe4644uxmg7xj54y87", "addr_shared_vkh1ewj7sycvy5y234m3uhudn5dggqk3djr0jheacr3utna5gcnmwp2" ] } }, "required": true }, "responses": { "200": { "description": "Transactions involving payment credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPaymentCredentialsTransaction" }, "example": { "data": [ { "tx_hash": "6029360e8236d06d81a31e9d8c6748ada97817f227204be092c93ad04fd04e4c", "slot": 55718892 }, { "tx_hash": "21c895e07df0af0d4bfad175f823b047a61542352890ffdd23bd23d56f567d2d", "slot": 55718892 }, { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892 }, { "tx_hash": "c140d6590778da752bf9b33780efdb9dc6307aa0bfc107f95f503016b58aa218", "slot": 106047961 } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/cred/utxos": { "post": { "tags": [ "Addresses" ], "summary": "UTxOs by multiple payment credentials", "description": "Return detailed information on UTxOs which are controlled by some payment credential in a list of payment credentials. No more than 100 payment credentials can be provided.", "operationId": "utxos_by_payment_creds", "parameters": [ { "name": "resolve_datums", "in": "query", "description": "Try find and include the corresponding datums for datum hashes", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "with_cbor", "in": "query", "description": "Include the CBOR encodings of the transaction outputs in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "example": [ "addr_vkh1wdkle2sprqsuklt34474g6n4ps7k6pv6zwe4644uxmg7xj54y87", "addr_shared_vkh1ewj7sycvy5y234m3uhudn5dggqk3djr0jheacr3utna5gcnmwp2" ] } }, "required": true }, "responses": { "200": { "description": "Unspent transaction outputs", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoWithSlot" }, "example": { "data": [ { "tx_hash": "a7e1f137a1d4befa15128286fd08dad67aebe2c11995aa2c04cc48159ccef082", "index": 0, "slot": 55718892, "assets": [ { "unit": "lovelace", "amount": 1724100 }, { "unit": "29760f3fb40b3670144594df635e5bb5d144a1173bff0d96fcad155c43727970746f426173686f2330303037", "amount": 1 } ], "address": "addr1w896t6qnpsjs32xhw8jl3kw34pqz69kgd72l8hqw83w0k3qahx2sv", "datum": { "type": "hash", "hash": "950c3e20ab32ba38c75cac5b1a7451800e514326a953c64e2dced7b4772ffcbe", "bytes": null, "json": null }, "reference_script": null, "txout_cbor": null }, { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "index": 1, "slot": 55718892, "assets": [ { "unit": "lovelace", "amount": 1444443 }, { "unit": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a6164616d616e74", "amount": 1 } ], "address": "addr1g9ekml92qyvzrjmawxkh64r2w5xr6mg9ngfmxh2khsmdrcudevsft64mf887333adamant", "datum": null, "reference_script": null, "txout_cbor": null } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/cred/{credential}/balance": { "get": { "tags": [ "Addresses" ], "summary": "Balance by payment credential", "description": "Return total amount of assets, including ADA, in UTxOs controlled by a specific payment credential", "operationId": "balance_by_payment_cred", "parameters": [ { "name": "credential", "in": "path", "description": "Payment credential in bech32 format", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Lovelace and native asset balance of payment credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Balance" }, "example": { "data": { "lovelace": "73408487", "assets": { "29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c6": { "4d494e74": "27833420567", "4d494e": "6958355141" }, "2afb448ef716bfbed1dcb676102194c3009bee5399e93b90def9db6a": { "4249534f4e": "5000000" } } }, "last_updated": { "timestamp": "2023-12-11 21:36:35", "block_hash": "58df3617b77c9b8da958c118c3daf9cabae86e31aca761fe9bb8d57b40fe14be", "block_slot": 110764304 } } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/cred/{credential}/transactions": { "get": { "tags": [ "Addresses" ], "summary": "Payment credential transactions", "description": "Returns transactions in which the specified payment credential spent or received funds, or was a required signer.\n\nSpecifically, "spent or received funds" meaning: the payment credential was used in an address which controlled at least one of the transaction inputs and/or receives one of the outputs AND the transaction is phase-2 valid, OR, the address controlled at least one of the collateral inputs and/or receives the collateral return output AND the transaction is phase-2 invalid. Read more.", "operationId": "txs_by_payment_cred", "parameters": [ { "name": "credential", "in": "path", "description": "Payment credential in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions minted on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Get the transactions for an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPaymentCredentialTransaction" }, "example": { "data": [ { "tx_hash": "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0", "slot": 73867237, "input": false, "output": true, "required_signer": false }, { "tx_hash": "357a18477c72d771df77736f83abba44fa826a3e36bc31bb81ca4e2f06475cc6", "slot": 73867237, "input": false, "output": true, "required_signer": false } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/cred/{credential}/utxos": { "get": { "tags": [ "Addresses" ], "summary": "UTxOs by payment credential", "description": "Return detailed information on UTxOs controlled by addresses which use the specified payment credential", "operationId": "utxos_by_payment_cred", "parameters": [ { "name": "credential", "in": "path", "description": "Payment credential in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "Return only UTxOs which contain some of a specific asset (asset formatted as concatenation of hex encoded policy and asset name)", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "resolve_datums", "in": "query", "description": "Try find and include the corresponding datums for datum hashes", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "with_cbor", "in": "query", "description": "Include the CBOR encodings of the transaction outputs in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by slot at which UTxO was produced)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only UTxOs created on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only UTxOs created on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Get all unspent transaction outputs at addresses with the given payment credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoWithSlot" }, "example": { "data": [ { "tx_hash": "b24743fb4b5381971ee8b3d02a3fd5e783acdb5a21cd2d22d192ec84e7e279fc", "index": 0, "slot": 23100140, "assets": [ { "unit": "lovelace", "amount": 1224040 }, { "unit": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2446a65644f7261636c654e4654", "amount": 1 } ], "address": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "datum": { "type": "hash", "hash": "ac0017f05bec9c7d1a475283b89fc40630ecdd66544fc3c0506be5f7c790d79e", "bytes": null, "json": null }, "reference_script": null, "txout_cbor": null }, { "tx_hash": "e2e91c7be8239b9f52fadec8df627fe759d21e5b6559c3ec06d8120f1366e075", "index": 0, "slot": 32264892, "assets": [ { "unit": "lovelace", "amount": 1224040 }, { "unit": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2446a65644f7261636c654e4654", "amount": 1 } ], "address": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "datum": { "type": "hash", "hash": "bdea76b7527bf513874be137b040b3235033d6d5af0add15d6e0dcfc78859aed", "bytes": null, "json": null }, "reference_script": null, "txout_cbor": null } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "eb5008ee0990527fb0d27d16b8c6284d4c898112509948d4741a7c41e544b912", "block_slot": 32265653 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/utxos": { "post": { "tags": [ "Addresses" ], "summary": "UTxOs by multiple addresses", "description": "Return detailed information on UTxOs which are controlled by some address in the specified list of addresses", "operationId": "utxos_by_addresses", "parameters": [ { "name": "resolve_datums", "in": "query", "description": "Try find and include the corresponding datums for datum hashes", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "with_cbor", "in": "query", "description": "Include the CBOR encodings of the transaction outputs in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "example": [ "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7", "addr_test1wplyjq2gqaufjt6uux6g9ax9s7mcc50rm3f8zgsmquknggce4mde8" ] } }, "required": true }, "responses": { "200": { "description": "Get all unspent transaction outputs residing at any address in a list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoWithSlot" }, "example": { "data": [ { "tx_hash": "21d0ff7e2b5d8988ff999f404668aff3f72f9e7a7de5eaa3740cb306f3024ca9", "index": 0, "slot": 20648797, "assets": [ { "unit": "lovelace", "amount": 20000000 } ], "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7", "datum": null, "reference_script": { "hash": "d465557fc0471f4243863a085f42aaf998dbc231c0b3cdf68633354b", "type": "plutusv2", "bytes": "5910630100003....10030021120011", "json": null }, "txout_cbor": null }, { "tx_hash": "b2054dc932454372808972d92e46e6725d57438d9095cb77010a12aa843b5e01", "index": 1, "slot": 21610369, "assets": [ { "unit": "lovelace", "amount": 2000000 }, { "unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4f7261636c6546656564", "amount": 1 } ], "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7", "datum": { "type": "inline", "hash": "b908508e84bd37060d4515eb25a43396610a4d6ce363a89ff802f40a7f0a1729", "bytes": "d8799fd87b9fa3001a000593e9011b00000186867c6928021b00000186868a24c8ffff", "json": { "constructor": 0, "fields": [ { "constructor": 2, "fields": [ { "map": [ { "k": { "int": 0 }, "v": { "int": 365545 } }, { "k": { "int": 1 }, "v": { "int": 1677293545768 } }, { "k": { "int": 2 }, "v": { "int": 1677294445768 } } ] } ] } ] } }, "reference_script": null, "txout_cbor": null }, { "tx_hash": "45c205a85aa13b2bb8677675937deac2d19ac6fccf84905d845e1ca9df62bac3", "index": 0, "slot": 21610637, "assets": [ { "unit": "lovelace", "amount": 3000000 }, { "unit": "436941ead56c61dbf9b92b5f566f7d5b9cac08f8c957f28f0bd60d4b5041594d454e54544f4b454e", "amount": 850860 }, { "unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4167675374617465", "amount": 1 } ], "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7", "datum": { "type": "inline", "hash": "83115d854808011060dff35ab238823b693250e7a089386cfbd422ce55f50e76", "bytes": "d87b9fd8799fd879....6dffffffff", "json": { "constructor": 2, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "list": [ { "bytes": "007df380aef26e44739db3f4fe67d8137446e630dab3df16d9fbddc5" }, { "bytes": "cef7fb5f89a9c76a65acdd746d9e84104d6f824d7dc44f427fcaa1dd" }, { "bytes": "4ad1571e7df63d4d6c49240c8372eb639f57c0ef669338c0d752f29b" }, { "bytes": "f6f69e5af37c2978cb2124c12202f2185fd5c14ee93bb832911daf8e" }, { "bytes": "2d7103fdaf4beecbbef37edc6d24d311230f2836d0af791e3a6364d2" } ] }, { "int": 7500 }, { "int": 900000 }, { "int": 900000 }, { "int": 200 }, { "constructor": 0, "fields": [ { "int": 20 } ] }, { "int": 20000 }, { "int": 1500 }, { "list": [ { "bytes": "496e6469676f4f7261636c65446174756d" } ] } ] } ] } ] } }, "reference_script": null, "txout_cbor": null } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "2d6b15048692aca81cc6dbd9234360ed6163e838fcf9d9f1a9e8dc67e0779f82", "block_slot": 32266164 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/{address}/decode": { "get": { "tags": [ "Addresses" ], "summary": "Decode address", "description": "Returns the different information encoded within a Cardano address, including details of the payment and delegation parts of the address", "operationId": "decode_address", "parameters": [ { "name": "address", "in": "path", "description": "Address in bech32/hex/base58 format", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Decode an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddressInfo" }, "example": { "bech32": "addr_test1zp40k56s0pq085hyzyeclfh6l987el8xyze5v86h0pr7wzkvenlf6qfxx9s3re5y0pqh2ug89dynd8xsje5835f7sutslvktx9", "hex": "106afb53507840f3d2e411338fa6faf94fecfce620b3461f577847e70accccfe9d0126316111e68478417571072b49369cd0966878d13e8717", "network": "testnet", "payment_cred": { "kind": "script", "bech32": "addr_shared_vkh1dta4x5rcgrea9eq3xw86d7heflk0ee3qkdrp74mcglns58ucedk", "hex": "6afb53507840f3d2e411338fa6faf94fecfce620b3461f577847e70a" }, "staking_cred": { "kind": "key", "bech32": "stake_vkh1enx0a8gpycckzy0xs3uyzat3qu45jd5u6ztxs7x386r3wzy6dys", "reward_address": "stake_test1urxvel5aqynrzcg3u6z8sst4wyrjkjfknngfv6rc6ylgw9cj72l60", "hex": "ccccfe9d0126316111e68478417571072b49369cd0966878d13e8717", "pointer": null } } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/{address}/transactions": { "get": { "tags": [ "Addresses" ], "summary": "Address transactions", "description": "Returns transactions in which the specified address spent or received funds.\n\nSpecifically, the transactions where: the address controlled at least one of the transaction inputs and/or receives one of the outputs AND the transaction is phase-2 valid, OR, the address controlled at least one of the collateral inputs and/or receives the collateral return output AND the transaction is phase-2 invalid. Read more.", "operationId": "txs_by_address", "parameters": [ { "name": "address", "in": "path", "description": "Address in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions minted on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Get the transactions for an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAddressTransaction" }, "example": { "data": [ { "tx_hash": "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0", "slot": 73867237, "input": false, "output": true }, { "tx_hash": "357a18477c72d771df77736f83abba44fa826a3e36bc31bb81ca4e2f06475cc6", "slot": 73867237, "input": false, "output": true } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/{address}/transactions/count": { "get": { "tags": [ "Addresses" ], "summary": "Address transaction count", "description": "Returns the number of transactions in which the address spent or received some funds.\n\nSpecifically, the number of transactions where: the address controlled at least one of the transaction inputs and/or receives one of the outputs AND the transaction is phase-2 valid, OR, the address controlled at least one of the collateral inputs and/or receives the collateral return output AND the transaction is phase-2 invalid. Read more.", "operationId": "tx_count_by_address", "parameters": [ { "name": "address", "in": "path", "description": "Address in bech32 format", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Get the transaction count for an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedTxCount" }, "example": { "data": 11043, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "2d9eda3c353ed1e18bd7219cdee9d4911df9e582d76adf7f85b1f464a78bd5af", "block_slot": 32265939 } } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/{address}/utxo_refs": { "get": { "tags": [ "Addresses" ], "summary": "UTxO references at an address", "description": "Returns references (pair of transaction hash and output index in transaction) for UTxOs controlled by the specified address", "operationId": "utxo_refs_at_address", "parameters": [ { "name": "address", "in": "path", "description": "Address in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by slot at which UTxO was produced)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only UTxOs created on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only UTxOs created on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "UTxO references for all the unspent transaction outputs at an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoRef" }, "example": { "data": [ { "tx_hash": "b24743fb4b5381971ee8b3d02a3fd5e783acdb5a21cd2d22d192ec84e7e279fc", "index": 0 }, { "tx_hash": "e2e91c7be8239b9f52fadec8df627fe759d21e5b6559c3ec06d8120f1366e075", "index": 0 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "8b78a8e4f3f097a6a6fcb20901326b660e4c8b2d4a45f77dea3f2c6e223adf96", "block_slot": 32266099 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/addresses/{address}/utxos": { "get": { "tags": [ "Addresses" ], "summary": "UTxOs at an address", "description": "Return detailed information on UTxOs controlled by an address", "operationId": "utxos_by_address", "parameters": [ { "name": "address", "in": "path", "description": "Address in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "asset", "in": "query", "description": "Return only UTxOs which contain some of a specific asset (asset formatted as concatenation of hex encoded policy and asset name)", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "resolve_datums", "in": "query", "description": "Try find and include the corresponding datums for datum hashes", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "with_cbor", "in": "query", "description": "Include the CBOR encodings of the transaction outputs in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by slot at which UTxO was produced)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only UTxOs created on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only UTxOs created on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Get all unspent transaction outputs at an address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoWithSlot" }, "example": { "data": [ { "tx_hash": "b24743fb4b5381971ee8b3d02a3fd5e783acdb5a21cd2d22d192ec84e7e279fc", "index": 0, "slot": 23100140, "assets": [ { "unit": "lovelace", "amount": 1224040 }, { "unit": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2446a65644f7261636c654e4654", "amount": 1 } ], "address": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "datum": { "type": "hash", "hash": "ac0017f05bec9c7d1a475283b89fc40630ecdd66544fc3c0506be5f7c790d79e", "bytes": null, "json": null }, "reference_script": null, "txout_cbor": null }, { "tx_hash": "e2e91c7be8239b9f52fadec8df627fe759d21e5b6559c3ec06d8120f1366e075", "index": 0, "slot": 32264892, "assets": [ { "unit": "lovelace", "amount": 1224040 }, { "unit": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2446a65644f7261636c654e4654", "amount": 1 } ], "address": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "datum": { "type": "hash", "hash": "bdea76b7527bf513874be137b040b3235033d6d5af0add15d6e0dcfc78859aed", "bytes": null, "json": null }, "reference_script": null, "txout_cbor": null } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "eb5008ee0990527fb0d27d16b8c6284d4c898112509948d4741a7c41e544b912", "block_slot": 32265653 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}": { "get": { "tags": [ "Assets" ], "summary": "Native asset information", "description": "Return a summary of information about an asset", "operationId": "asset_info", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Information about the asset", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedAssetInfo" }, "examples": { "CIP-25": { "summary": "Asset with CIP-25 metadata", "value": { "data": { "asset_name": "6164616d616e74", "asset_name_ascii": "adamant", "fingerprint": "asset105lxc60yjpqygjsnn29e5hjyafnfw75pqwwza2", "total_supply": "1", "unique_holders": { "by_address": 1, "by_account": 0 }, "first_mint_tx": { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03", "amount": "1" }, "latest_mint_tx": { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03", "amount": "1" }, "mint_tx_count": 1, "burn_tx_count": 0, "asset_standards": { "cip25_metadata": { "name": "$adamant", "description": "The Handle Standard", "website": "https://adahandle.com", "image": "ipfs://Qmai8iwE1Diw5YZVYSpSPAbXM5AVprheve8AAXJzwXoftf", "core": { "og": 0, "termsofuse": "https://adahandle.com/tou", "handleEncoding": "utf-8", "prefix": "$", "version": 0 }, "augmentations": [] }, "cip68_metadata": null }, "latest_mint_tx_metadata": { "721": { "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a": { "cardanosweets": { "name": "$cardanosweets", "description": "The Handle Standard", "website": "https://adahandle.com", "image": "ipfs://QmaNoVpks3gAR4oayMkx9uHU2baDMGQrBAzpM1PZ3ebJBu", "core": { "og": 0, "termsofuse": "https://adahandle.com/tou", "handleEncoding": "utf-8", "prefix": "$", "version": 0 }, "augmentations": [] }, "adamant": { "name": "$adamant", "description": "The Handle Standard", "website": "https://adahandle.com", "image": "ipfs://Qmai8iwE1Diw5YZVYSpSPAbXM5AVprheve8AAXJzwXoftf", "core": { "og": 0, "termsofuse": "https://adahandle.com/tou", "handleEncoding": "utf-8", "prefix": "$", "version": 0 }, "augmentations": [] } } } }, "token_registry_metadata": null }, "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 } } } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}/accounts": { "get": { "tags": [ "Assets" ], "summary": "Accounts of addresses holding specific asset", "description": "Returns a list of accounts (as stake/reward addresses) associated with addresses which control some of the specified asset; in other words, instead of returning the addresses which hold some of the asset, the addresses are merged by their delegation part/account. Assets controlled by Byron, enterprise, or pointer addresses are omitted.\n\nCAUTION: An asset being associated with a particular stake account does not necessarily mean the owner of that account controls the asset; use "asset addresses" unless you are sure you want to work with stake keys. Read more here.", "operationId": "asset_accounts", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns stake addresses for accounts which control some of the specified asset", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAssetHolderAccount" }, "example": { "data": [ { "account": "stake1uy3c9n7hlnvt2eucfpgd8ezqn424na7nhc6zca2atq0tqsg5ljq5v", "amount": 1 }, { "account": "stake1uylx7yct3smspkes9fzk3f8y8mmu90htxe75g923576d2zgpluxt7", "amount": 3 } ], "last_updated": { "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}/addresses": { "get": { "tags": [ "Assets" ], "summary": "Native asset addresses", "description": "Returns a list of addresses which control some amount of the specified asset", "operationId": "asset_addresses", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns addresses holding the specified asset, paired with the amounts of the asset owned", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAssetHolder" }, "example": { "data": [ { "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy", "amount": 100000000000000 }, { "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8", "amount": 320000000000000 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "c0d2cf4d7e0e9dfbfda2e09330a8aa2dd426a0d9c2d927ea28e43aa0b6550f8f", "block_slot": 32266746 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}/mints": { "get": { "tags": [ "Assets" ], "summary": "Native asset mints and burns", "description": "Returns a list of transactions in which some of the specified asset was minted or burned", "operationId": "asset_mints", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions in blocks minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions in blocks minted on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Array of transactions with amounts of asset minted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedMintTransaction" }, "example": { "data": [ { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03", "amount": "1" } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}/transactions": { "get": { "tags": [ "Assets" ], "summary": "Native asset transactions", "description": "Returns a list of transactions in which some of a specific asset is moved or minted", "operationId": "asset_txs", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions in blocks minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions in blocks minted on or before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "An array of transactions", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedTimestampedTransaction" }, "example": { "data": [ { "tx_hash": "ad266dfdf3bec26462d326dcfca1bfd359ca72659bd792be19edd0e69708c466", "slot": 49503576, "timestamp": "2022-01-01 20:44:27" }, { "tx_hash": "2e36e8f8d600d95ac3851879f0fb930756e4f88917bf697c9a725049ce25f4eb", "slot": 49503576, "timestamp": "2022-01-01 20:44:27" }, { "tx_hash": "bc21b95844a8b4b08c20a848c4bc7f5be08df11bb3f75cf9510836c7259bc9fc", "slot": 55718892, "timestamp": "2022-03-14 19:13:03" }, { "tx_hash": "904e3cd77c10def76dadd4c1cb87166ed707bae43e5d7da8dcccaf3066b5bfe2", "slot": 106047961, "timestamp": "2023-10-18 07:30:52" } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/assets/{asset}/utxos": { "get": { "tags": [ "Assets" ], "summary": "Native asset UTxOs", "description": "Returns references for UTxOs which contain some of the specified asset, each paired with the amount of the asset contained in the UTxO", "operationId": "asset_utxos", "parameters": [ { "name": "asset", "in": "path", "description": "Asset, encoded as concatenation of hex of policy ID and asset name", "required": true, "schema": { "type": "string" } }, { "name": "address", "in": "query", "description": "Return only UTxOs controlled by a specific address (bech32 encoding)", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by slot at which UTxO was produced)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only UTxOs created on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only UTxOs created before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns UTxOs containing the specified asset, each paired with the amount of the asset", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAssetUtxo" }, "example": { "data": [ { "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404", "index": 0, "slot": 12722572, "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy", "amount": 100000000000000 }, { "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404", "index": 1, "slot": 12722572, "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8", "amount": 320000000000000 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "a819c4555f28885e8e9e90039b7dd8375bb88224414536adb2ee2615036d8d4c", "block_slot": 32277176 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/blocks/latest": { "get": { "tags": [ "Blocks" ], "summary": "Latest block information", "description": "Returns information about the most recently minted block", "operationId": "latest_block", "parameters": [ { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Summary of information regarding the latest block", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedBlockInfo" }, "example": { "data": { "hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "height": 7867166, "absolute_slot": 73867237, "timestamp": "2022-10-10 20:25:28", "epoch": 368, "epoch_slot": 254437, "block_producer": "pool103w4na57zyunn2s7r8cgrnqgsn3tskj4w69yx3alx4sezphv53t", "confirmations": 0, "tx_hashes": [ "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0", "a90e31b3de59452659617c351e5f746b819cb8b026bf945dd41b4cc199bcc8c9", "dbe30d4f6f42342d7cbfa950bb330cd111bea525b17c2ca115fcec19f1f2e55c", "836c720301e2f463fcaf3ffa746213c03616cc003a1802ddb1243e738140b109", "660c2a41c5a6618db2a514fe0d84bd2570e8f2e0ed8e3ac9b810f5f8230c171d", "357a18477c72d771df77736f83abba44fa826a3e36bc31bb81ca4e2f06475cc6", "a79137811a11914fa6b5543871496e2efbbfd4fb63e3ef808fbbf4247a194f7f", "f89ad271629e827e6722617cce03f7c966f37b9d9143ab356600f31591b902b0", "ae2cc8e8bf536899acb036c7c560c5658abfdffb84a35f18e9a8cf72fb160e35", "b84082a6c4fd731f2a4263d5e99f205798d4356ee5386633ef47727ba2a345fd", "6dc497eb7acf460a491cff25ca22dcdad1fa42bb133262afc20c828d7003b439", "ba7464e4d1c8610e3bef857ddaf7e52083291b5e30750e6bce7ebfeef07f4790", "0344e44a44c644f782088ca7e1143304b20f5cd3e5a4c77748bf4efe5aea06f8", "1eec3e58f7001c5b875456232e79cbfdb64e2be0e2b32c06f5c07cab38069634" ], "total_fees": 4195080, "total_ex_units": { "mem": 7191340, "steps": 2947856708 }, "script_invocations": 3, "size": 27430, "previous_block": "3c1778df54aedc9e6226d31cc316a8b5b7912800f909b62f77a46ad61fa10a0c", "total_output_lovelace": "102300616446", "era": "vasil", "protocol_version": [ 7, 0 ], "vrf_key": "f913889ad4f696f436dfa19803ebee2219cee59daba879ab9591c75fc8ee33e4", "operational_certificate": { "hot_vkey": "278c4f65bdca2498882a47eb876f023a86bc75b9307bd80ac361587f1c0fc1f1", "sequence_number": 4, "kes_period": 527, "kes_signature": "39a017fbd95a909a3bcca2f368fcc26e7fab64fb09dc48c7d4a99db5bd68b6280a61fe66da3f048b237754d48cfa1c3f954895f4fe41cb71c296997b53dd6501" } }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/blocks/{hash_or_height}": { "get": { "tags": [ "Blocks" ], "summary": "Block information", "description": "Returns information about the specified block", "operationId": "block_info", "parameters": [ { "name": "hash_or_height", "in": "path", "description": "Block height or hex encoded block hash", "required": true, "schema": { "type": "string" } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Summary of information regarding the specified block", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedBlockInfo" }, "example": { "data": { "hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "height": 7867166, "absolute_slot": 73867237, "timestamp": "2022-10-10 20:25:28", "epoch": 368, "epoch_slot": 254437, "block_producer": "pool103w4na57zyunn2s7r8cgrnqgsn3tskj4w69yx3alx4sezphv53t", "confirmations": 0, "tx_hashes": [ "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0", "a90e31b3de59452659617c351e5f746b819cb8b026bf945dd41b4cc199bcc8c9", "dbe30d4f6f42342d7cbfa950bb330cd111bea525b17c2ca115fcec19f1f2e55c", "836c720301e2f463fcaf3ffa746213c03616cc003a1802ddb1243e738140b109", "660c2a41c5a6618db2a514fe0d84bd2570e8f2e0ed8e3ac9b810f5f8230c171d", "357a18477c72d771df77736f83abba44fa826a3e36bc31bb81ca4e2f06475cc6", "a79137811a11914fa6b5543871496e2efbbfd4fb63e3ef808fbbf4247a194f7f", "f89ad271629e827e6722617cce03f7c966f37b9d9143ab356600f31591b902b0", "ae2cc8e8bf536899acb036c7c560c5658abfdffb84a35f18e9a8cf72fb160e35", "b84082a6c4fd731f2a4263d5e99f205798d4356ee5386633ef47727ba2a345fd", "6dc497eb7acf460a491cff25ca22dcdad1fa42bb133262afc20c828d7003b439", "ba7464e4d1c8610e3bef857ddaf7e52083291b5e30750e6bce7ebfeef07f4790", "0344e44a44c644f782088ca7e1143304b20f5cd3e5a4c77748bf4efe5aea06f8", "1eec3e58f7001c5b875456232e79cbfdb64e2be0e2b32c06f5c07cab38069634" ], "total_fees": 4195080, "total_ex_units": { "mem": 7191340, "steps": 2947856708 }, "script_invocations": 3, "size": 27430, "previous_block": "3c1778df54aedc9e6226d31cc316a8b5b7912800f909b62f77a46ad61fa10a0c", "total_output_lovelace": "102300616446", "era": "vasil", "protocol_version": [ 7, 0 ], "vrf_key": "f913889ad4f696f436dfa19803ebee2219cee59daba879ab9591c75fc8ee33e4", "operational_certificate": { "hot_vkey": "278c4f65bdca2498882a47eb876f023a86bc75b9307bd80ac361587f1c0fc1f1", "sequence_number": 4, "kes_period": 527, "kes_signature": "39a017fbd95a909a3bcca2f368fcc26e7fab64fb09dc48c7d4a99db5bd68b6280a61fe66da3f048b237754d48cfa1c3f954895f4fe41cb71c296997b53dd6501" } }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/chain-tip": { "get": { "tags": [ "General" ], "summary": "Chain-tip", "description": "Returns the identifier of the most recently processed block on the network", "operationId": "chain_tip", "responses": { "200": { "description": "Get details of the chain-tip (lastest block)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedChainTip" }, "example": { "data": { "block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a", "slot": 32284578, "height": 1102039 }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a", "block_slot": 32284578 } } } } }, "500": { "description": "Internal server error" } } } }, "/datums": { "post": { "tags": [ "Datums" ], "summary": "Datums by hashes", "description": "Returns the datums corresponding to the specified datum hashes, if the datums have been seen on-chain", "operationId": "datums_by_hashes", "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "example": [ "f03819a4039003a8c6b65153351adbc61f983bd22787ed238a5b4f24a01aa5d6", "5f7f360208c46d739296ea3ff4f41d85240d94aa3f59e5b1c82c2bbeceb57f23" ] } }, "required": true }, "responses": { "200": { "description": "Map of datum hashes to datum objects", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedDatumMap" }, "example": { "data": { "5f7f360208c46d739296ea3ff4f41d85240d94aa3f59e5b1c82c2bbeceb57f23": { "json": { "constructor": 0, "fields": [ { "bytes": "e1d915c10c840017bd39088a82507b27150a438e8907784221491309" }, { "bytes": "e1d915c10c840017bd39088a82507b27150a438e8907784221491309" } ] }, "bytes": "d8799f581ce1d915c10c840017bd3908...1a009896801a9a7ec8001b00000183c392c9a1ff" }, "f03819a4039003a8c6b65153351adbc61f983bd22787ed238a5b4f24a01aa5d6": { "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "fc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4c" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "d756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29" } ] } ] } ] } ] } ] }, "bytes": "d8799fd8799fd8799f581cfc6e1b47816bc...d8799fd8799f581cd756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29ffffffffd8799fd8799f581cfc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4cffd8799fd8799fd8799f581cd756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29ffffffffd87a80d87a9fd8799f581c25f0fc240e91bd95dcdaebd2ba7713fc5168ac77234a3d79449fc20c47534f4349455459ff1a0bebc200ff1a001e84801a001e8480ff" } }, "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 } } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/datums/{datum_hash}": { "get": { "tags": [ "Datums" ], "summary": "Datum by datum hash", "description": "Returns the datum corresponding to the specified datum hash, if the datum has been seen on-chain", "operationId": "datum_by_hash", "parameters": [ { "name": "datum_hash", "in": "path", "description": "Hex encoded datum hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Datum corresponding to the datum hash", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedDatum" }, "example": { "data": { "json": { "constructor": 0, "fields": [ { "bytes": "76140b3e82b58a9439ce10473d0d7c40ec9165fb03662c499a9162f95b9ec34641adbb83203c5276eaa35fc95c3776e00779ca412777cdc5201b53184d365306" }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "int": 100000 }, { "int": 36069 } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 1, "fields": [ { "int": 1676063825000 } ] }, { "constructor": 1, "fields": [] } ] }, { "constructor": 0, "fields": [ { "constructor": 1, "fields": [ { "int": 1676065625000 } ] }, { "constructor": 1, "fields": [] } ] } ] }, { "bytes": "555344" } ] }, { "bytes": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2" } ] }, "bytes": "d8799f584076140b3e82b58a9439ce10473d0d7c40ec9165fb03662c499a9162f95b9ec34641adbb83203c5276eaa35fc95c3776e00779ca412777cdc5201b53184d365306d8799fd8799f1a000186a0198ce5ffd8799fd8799fd87a9f1b000001863d305c68ffd87a80ffd8799fd87a9f1b000001863d4bd3a8ffd87a80ffff43555344ff581c0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2ff" }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "391e8974a46a05addd54593722380fdea42f29d7de4acc5729a6ec0663955293", "block_slot": 32284048 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/ecosystem/adahandle/{handle}": { "get": { "tags": [ "Ecosystem" ], "summary": "Resolve ADA Handle", "description": "Returns the Cardano address corresponding to an ADA Handle", "operationId": "adahandle_resolve", "parameters": [ { "name": "handle", "in": "path", "description": "Ada Handle to resolve", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Return the address which the Ada Handle resolves to", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedAddress" }, "example": { "data": "addr1vyn6t3yqfy5awnc5pekjxww4cn89y3g4pt5rmuykg4y2urc56c56e", "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/epochs/current": { "get": { "tags": [ "Epochs" ], "summary": "Current epoch details", "description": "Returns a summary of information about the current epoch", "operationId": "current_epoch", "responses": { "200": { "description": "Information about the current epoch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedCurrentEpochInfo" }, "example": { "data": { "epoch_no": 78, "fees": "8689785871", "tx_count": 15413, "blk_count": 9571, "start_time": 1687737655 }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bb35643eb0da04a3965b15db86edfaa8b4b9eba0f2dad77edf8e0250f41f2de1", "block_slot": 32284313 } } } } }, "500": { "description": "Internal server error" } } } }, "/epochs/{epoch_no}": { "get": { "tags": [ "Epochs" ], "summary": "Specific epoch details", "description": "Returns a summary of information about a specific epoch", "operationId": "epoch_info", "parameters": [ { "name": "epoch_no", "in": "path", "description": "Epoch number to return information about", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "Information about the requested epoch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedEpochInfo" }, "example": { "data": { "epoch_no": 448, "fees": "102017010232", "tx_count": 293800, "blk_count": 21133, "start_time": 1699739174, "end_time": 1700171024, "active_stake": "22973647279096705", "total_rewards": "10027944051413", "average_reward": "474515878" }, "last_updated": { "timestamp": "2023-11-23 13:42:12", "block_hash": "89e2f22f2441e7545bfd7b6f01a23be3b804c7cad4eea7dd2c989a679fa0138a", "block_slot": 109180641 } } } } }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/era-summaries": { "get": { "tags": [ "General" ], "summary": "Era summary", "description": "Returns the blockchain era summaries. May include a future Era before hard forks. You should not assume the last item is the current epoch. Check "slot" against the current /chain-tip.", "operationId": "era_summaries", "responses": { "200": { "description": "Get era summaries", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedEraSummaries" }, "example": { "data": [ { "start": { "time": { "seconds": 0 }, "slot": 0, "epoch": 0 }, "end": { "time": { "seconds": 1728000 }, "slot": 86400, "epoch": 4 }, "parameters": { "epoch_length": 21600, "slot_length": { "milliseconds": 20000 }, "safe_zone": 4320 } }, { "start": { "time": { "seconds": 1728000 }, "slot": 86400, "epoch": 4 }, "end": { "time": { "seconds": 2160000 }, "slot": 518400, "epoch": 5 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } }, { "start": { "time": { "seconds": 2160000 }, "slot": 518400, "epoch": 5 }, "end": { "time": { "seconds": 2592000 }, "slot": 950400, "epoch": 6 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } }, { "start": { "time": { "seconds": 2592000 }, "slot": 950400, "epoch": 6 }, "end": { "time": { "seconds": 3024000 }, "slot": 1382400, "epoch": 7 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } }, { "start": { "time": { "seconds": 3024000 }, "slot": 1382400, "epoch": 7 }, "end": { "time": { "seconds": 5184000 }, "slot": 3542400, "epoch": 12 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } }, { "start": { "time": { "seconds": 5184000 }, "slot": 3542400, "epoch": 12 }, "end": { "time": { "seconds": 70416000 }, "slot": 68774400, "epoch": 163 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } }, { "start": { "time": { "seconds": 70416000 }, "slot": 68774400, "epoch": 163 }, "end": { "time": { "seconds": 71280000 }, "slot": 69638400, "epoch": 165 }, "parameters": { "epoch_length": 432000, "slot_length": { "milliseconds": 1000 }, "safe_zone": 129600 } } ], "last_updated": { "timestamp": "2024-08-30 15:37:05", "block_hash": "cffcdbe42399a72449325dbb8f207d84c86b9609ec36e45b67e9bc538ecdc6d6", "block_slot": 69349025 } } } } }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}": { "get": { "tags": [ "Asset Policy" ], "summary": "Information about a policy of native assets", "description": "Returns a summary of information about a native asset policy ID and assets minted under that policy", "operationId": "policy_info", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded policy ID", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Summary of asset minting policy", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedPolicyInfo" }, "example": { "data": { "policy_id": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a", "script": { "hash": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a", "type": "native", "bytes": "8200581c4da965a049dfd15ed1ee19fba6e2974a0b79fc416dd1796a1f97f5e1", "json": { "keyHash": "4da965a049dfd15ed1ee19fba6e2974a0b79fc416dd1796a1f97f5e1", "type": "sig" } }, "assets_of_policy": 11, "total_supply": "11", "unique_holders": { "by_address": 21, "by_account": 19 }, "first_mint_tx": { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03" }, "latest_update_tx": { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03" } }, "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/accounts": { "get": { "tags": [ "Asset Policy" ], "summary": "Accounts of addresses holding assets of specific policy", "description": "Returns a list of accounts (as stake/reward addresses) associated with addresses which control some of an asset of the specified policy; in other words, instead of returning the addresses which hold the assets, the addresses are merged by their delegation part/account. Assets controlled by Byron, enterprise, or pointer addresses are omitted.\n\nCAUTION: An asset being associated with a particular stake account does not necessarily mean the owner of that account controls the asset; use "asset addresses" unless you are sure you want to work with stake keys. Read more here.", "operationId": "policy_accounts", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded Policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns stake addresses for accounts which hold assets of the given policy ID with the asset names and amounts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPolicyHolderAccount" }, "example": { "data": [ { "account": "stake1u83s6geern5tjrqgy6h7r99sspdnvayfjcd20k654qh737sfj90vm", "assets": [ { "name": "647261676f6e6d", "amount": 1 } ] }, { "account": "stake1u89727xfn46muezyut6ntj2cgmr0cy28xmjlvlec4w0qnmgyh3hy4", "assets": [ { "name": "7468657265616c746f656b6e656573", "amount": 1 } ] }, { "account": "stake1u8awcypj0uexy9al9msgeg5jqgsrypfcewq4hmz758mdsxsf0egkq", "assets": [ { "name": "677579677579", "amount": 1 } ] }, { "account": "stake1u96e4xmq9877s43meetz0tnwz37m4clv4vvrznj834dzszgkh2mj9", "assets": [ { "name": "2e323233", "amount": 1 }, { "name": "6972732e616461", "amount": 1 } ] } ], "last_updated": { "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 }, "next_cursor": "4UJEXH0Ew5ACnrzRLfjDDQOeyeB3vhccUwWwWto" } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/addresses": { "get": { "tags": [ "Asset Policy" ], "summary": "Addresses holding assets of specific policy", "description": "Returns a list of addresses which hold some of an asset of the specified policy ID", "operationId": "policy_addresses", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded Policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns addresses holding assets of the given policy ID with the asset names and amounts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPolicyHolder" }, "example": { "data": [ { "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy", "assets": [ { "name": "6362544843", "amount": 100000000000000 } ] }, { "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8", "assets": [ { "name": "6362544843", "amount": 320000000000000 } ] } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "2863d3805fa06b0b8062df9c1cb62773e0961f8333ef2cd7ea3faca0f3c738a7", "block_slot": 32277823 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/assets": { "get": { "tags": [ "Asset Policy" ], "summary": "List assets of a policy", "description": "Lists all assets which have existed under the specified policy ID with a short information summary for each", "operationId": "policy_assets", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded Policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "List of assets paired with short information summary", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedAssetInfoConcise" }, "example": { "data": [ { "asset_name": "6164616d616e74", "asset_name_ascii": "adamant", "fingerprint": "asset105lxc60yjpqygjsnn29e5hjyafnfw75pqwwza2", "total_supply": "1", "asset_standards": { "cip25_metadata": { "augmentations": [], "core": { "handleEncoding": "utf-8", "og": 0, "prefix": "$", "termsofuse": "https://adahandle.com/tou", "version": 0 }, "description": "The Handle Standard", "image": "ipfs://Qmai8iwE1Diw5YZVYSpSPAbXM5AVprheve8AAXJzwXoftf", "name": "$adamant", "website": "https://adahandle.com" }, "cip68_metadata": null } }, { "asset_name": "6264736d", "asset_name_ascii": "bdsm", "fingerprint": "asset1qyv6sdhq0fw7mxt0zl7gwd2h2hs4evpe0zl73r", "total_supply": "1", "asset_standards": { "cip25_metadata": { "augmentations": [], "core": { "handleEncoding": "utf-8", "og": 0, "prefix": "$", "termsofuse": "https://adahandle.com/tou", "version": 0 }, "description": "The Handle Standard", "image": "ipfs://QmfTpy3ybWL1teCMVAieh7atHtYgpcCZ5Ew58eSUxHgZFb", "name": "$bdsm", "website": "https://adahandle.com" }, "cip68_metadata": null } } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": "YmRzbQ" } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/mints": { "get": { "tags": [ "Asset Policy" ], "summary": "Transactions minting or burning assets of policy", "description": "Returns a list of transactions in which some of the specified asset was minted or burned", "operationId": "policy_mints", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions in blocks minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions in blocks minted before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Array of transactions with assets and amounts minted", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPolicyMintTransaction" }, "example": { "data": [ { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03", "assets": [ { "name": "6164616d616e74", "amount": "1" }, { "name": "6264736d", "amount": "1" }, { "name": "63617264616e6f737765657473", "amount": "1" } ] } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/transactions": { "get": { "tags": [ "Asset Policy" ], "summary": "Transactions involving assets of policy", "description": "Returns transactions which involved (moved, minted) at least one asset of the specified policy, along with a list of all the assets of the policy that were involved.", "operationId": "policy_txs", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by point in chain)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only transactions in blocks minted on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only transactions in blocks minted before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Transactions involving assets of policy", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPolicyTransaction" }, "example": { "data": [ { "tx_hash": "09b2c948cf12de9eba590eb6af9ddc1e98b9342a79568b63fea06541cb3fecc1", "slot": 49503576, "assets": [ "61736d72", "67657268617274", "647572616e676f", "67756e6e657273" ] }, { "tx_hash": "1c0375e0aa718c9a203d6fc35522f0de953fcccfe7a74b544a5a246f4d5103d4", "slot": 49503576, "assets": [ "6368696c6c696e67", "6d6f6e6579706f6f6c" ] }, { "tx_hash": "23243cf14d26e87a4ac6e70cc001d81587475759049c8dc8954629f665fe87c7", "slot": 55718892, "assets": [ "7468657265616c746f656b6e656573", "646566692e646567656e", "636f70796361742e626f7373636174", "6a7562", "632e6e2e662e742e", "6e6f6f702e646f6767", "77696e672e64616f", "627261696e6c657373", "6e66742e6c6f766572", "6869742e6d792e70616e7473", "626c7565746f756768677579", "686974686f6c6573", "6a61636f6269", "736f6d656461792e73776170", "6261642e636f6f6b", "63617264616e6f2e646567656e" ] }, { "tx_hash": "6029360e8236d06d81a31e9d8c6748ada97817f227204be092c93ad04fd04e4c", "slot": 55718892, "assets": [ "6972732e63727970746f", "2e323233", "6972732e616461" ] }, { "tx_hash": "6383a77a538f598cd07d7a79dfef7589527833a433d3b8475665f4ec1ed4c19d", "slot": 106047961, "assets": [ "666169726661782d726f6265727473", "6861646c65792e636f78", "62616e6b6f66686177616969", "63617264616e6f2e63686164", "74686169726f79616c66616d696c79" ] } ], "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/policy/{policy}/utxos": { "get": { "tags": [ "Asset Policy" ], "summary": "UTxOs containing assets of specific policy", "description": "Returns UTxO references of UTxOs which contain some of at least one asset of the specified policy ID, each paired with a list of assets of the policy contained in the UTxO and the corresponding amounts", "operationId": "policy_utxos", "parameters": [ { "name": "policy", "in": "path", "description": "Hex encoded policy ID", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by slot at which UTxO was produced)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "from", "in": "query", "description": "Return only UTxOs created on or after a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "to", "in": "query", "description": "Return only UTxOs created before a specific slot", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Returns UTxOs which contain assets of the given policy ID, with the asset names and amounts", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPolicyUtxo" }, "example": { "data": [ { "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404", "index": 0, "slot": 12722572, "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy", "assets": [ { "name": "6362544843", "amount": 100000000000000 } ] }, { "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404", "index": 1, "slot": 12722572, "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8", "assets": [ { "name": "6362544843", "amount": 320000000000000 } ] } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "0e0cb28820d245261e693d950c19f782fd90c63d03df5cdfde4efbfd2ac1365a", "block_slot": 32283585 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools": { "get": { "tags": [ "Pools" ], "summary": "List registered stake pools", "description": "Returns a list of currently registered stake pools", "operationId": "list_pools", "parameters": [ { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "List of all registered stake pools (ticker can be null)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPoolListInfo" }, "example": { "data": [ { "pool_id_bech32": "pool100wj94uzf54vup2hdzk0afng4dhjaqggt7j434mtgm8v2gfvfgp", "ticker": "JFLD" }, { "pool_id_bech32": "pool102s2nqtea2hf5q0s4amj0evysmfnhrn4apyyhd4azcmsclzm96m", "ticker": "YULI" }, { "pool_id_bech32": "pool102vsulhfx8ua2j9fwl2u7gv57fhhutc3tp6juzaefgrn7ae35wm", "ticker": "BNP" }, { "pool_id_bech32": "pool1030as3pp5684ghgf4kzcpv4p2jnmkmme7j363t95690zwxp7wa0", "ticker": "888" }, { "pool_id_bech32": "pool1030vz0wxheg0dvarr8hmeavelpszmp52qucs68c7wc9uga6n6e4", "ticker": "ROMER" }, { "pool_id_bech32": "pool10ysem79xjxd223plxqws0fheawd78znr3qs4h2h422gmxa40amu", "ticker": "LUCY" } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "73087e0231d665d82edcf7215b5381c26e406d111fe0075f987e59861dd6e451", "block_slot": 96404335 }, "next_cursor": "AAAAAAAAAAA" } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/blocks": { "get": { "tags": [ "Pools" ], "summary": "Stake pool blocks", "description": "Return information about blocks minted by a given pool for all epochs (or just for epoch epoch_no if provided)", "operationId": "pool_blocks", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "epoch_no", "in": "query", "description": "Epoch number to fetch results for", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by block absolute slot)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Return information about blocks minted by a given pool for all epochs (or epoch_no if provided)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPoolBlock" }, "example": { "data": [ { "epoch_no": 241, "epoch_slot": 416235, "abs_slot": 19165035, "block_height": 5213445, "block_hash": "6ecd67bb8515cf7ab82c5c0c4a3f6e99c390fdfaaffca4bd7ab0a3365c5327ce", "block_time": 1610731326 }, { "epoch_no": 243, "epoch_slot": 166752, "abs_slot": 19779552, "block_height": 5243962, "block_hash": "3ad8d2bafc5ad3e7fed82318f03f7b4ae221b5c9ca0b20b47b72a96bdf82a71b", "block_time": 1611345843 }, { "epoch_no": 280, "epoch_slot": 401137, "abs_slot": 35997937, "block_height": 6042598, "block_hash": "4a0572125268fd327258a6fea5c35bdc1e619bd81d542c36c8cf0a8a92214e21", "block_time": 1627564228 }, { "epoch_no": 281, "epoch_slot": 105848, "abs_slot": 36134648, "block_height": 6049318, "block_hash": "0cdef0adaf13b7db4a469637439b7847ba822bc05c94710ca4f517b57ac0f3a8", "block_time": 1627700939 }, { "epoch_no": 281, "epoch_slot": 246962, "abs_slot": 36275762, "block_height": 6056368, "block_hash": "8590d0e47ed7d50a39fed48e9f556c99f644626a08a90d04198810bff8c41bac", "block_time": 1627842053 } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "6d0c6e1c0966c5ba824fedd4dfa963ee2cab1091e33e3c76551d1dbae50ccd25", "block_slot": 96404672 }, "next_cursor": "AAAAAAAAAAA" } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/delegators": { "get": { "tags": [ "Pools" ], "summary": "Stake pool delegators", "description": "Returns a list of delegators of the specified pool", "operationId": "pool_delegators", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Array of information about current delegators for a given pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedDelegatorInfo" }, "example": { "data": [ { "stake_address": "stake1u82hrwv9ucsa38k4qejwenmq5zmleexlsplc4acpvl3g6asxr8aay", "amount": 838095398379, "active_epoch_no": 234, "latest_delegation_tx_hash": "94019e466d8c1a89f88df4127980bc6fb3f432b21c3f498ceb2daaedd721f04b" }, { "stake_address": "stake1uy0yzgwlv2898qwap6qtg7uwavknxtqfs3c2u8x35rgf5jcx0z2tv", "amount": 19763135363, "active_epoch_no": 363, "latest_delegation_tx_hash": "659911f1d712961c6795c1c082b216704351f368ef52388b9c0564e7d947218c" }, { "stake_address": "stake1uy7cha5x6k67xq0c5adpsknf8982pdr4vwrn9yaxapzz9esmllnll", "amount": 22896634615, "active_epoch_no": 234, "latest_delegation_tx_hash": "100124ac08d9beaa68c9592a35bd4479ccdf20f74b6ff60bc87311fa4ca6b248" }, { "stake_address": "stake1uylvs9r8f98cjfehvdy8ypa9feslckdy48m4vn8ruvaupas47scvy", "amount": 1474, "active_epoch_no": 263, "latest_delegation_tx_hash": "c317381b0d9e243dea2eacefe1a85d9e2186b6a80e70ca9c9680a757353a7a3e" } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "525024696e2a2fa3312bc726d443aebae17763387207299c3e8b394dddf592e4", "block_slot": 96404843 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/delegators/{epoch_no}": { "get": { "tags": [ "Pools" ], "summary": "Stake pool delegator history", "description": "Returns a list delegators of a pool as of a certain epoch", "operationId": "pool_historical_delegators", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "epoch_no", "in": "path", "description": "Epoch number to fetch results for", "required": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Array of information about delegators for a given pool in a specific epoch", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedHistoricalDelegatorInfo" }, "example": { "data": [ { "stake_address": "stake1u83feq9ks8lc5gyre0c3fqr7e643604jgec9jp0tau220mgyj0a8n", "amount": "18272086108353" }, { "stake_address": "stake1uxz2du6vka7emfclsgd2we8znyu2edy9exkxnd7n5xg63qga7u2jf", "amount": "4002283786898" } ], "last_updated": { "timestamp": "2023-12-18 10:13:03", "block_hash": "fb42be66ef3ca55b0538c9c69c4f9b55f16b286b45f1817f89e481feb8d5b7bf", "block_slot": 111328092 }, "next_cursor": "AAAAAAAAAAA" } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/history": { "get": { "tags": [ "Pools" ], "summary": "Stake pool history", "description": "Returns per-epoch information about the specified pool (or just for epoch epoch_no if provided)", "operationId": "pool_history", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "epoch_no", "in": "query", "description": "Epoch number to fetch results for", "required": false, "schema": { "type": "integer", "format": "int64", "nullable": true, "minimum": 0 } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "order", "in": "query", "description": "The order in which the results are sorted (by epoch number)", "required": false, "schema": { "allOf": [ { "type": "string", "default": "asc", "enum": [ "asc", "desc" ] } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "An array of pool history information for each epoch (or containing one entry for a given epoch_no)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedPoolHistory" }, "example": { "data": [ { "epoch_no": 6, "active_stake": 100000000000000, "active_stake_pct": "33.33333333333333333300", "saturation_pct": null, "block_cnt": 7243, "delegator_cnt": 1, "margin": 1, "fixed_cost": 500000000, "pool_fees": 0, "deleg_rewards": 0, "epoch_ros": "0" }, { "epoch_no": 7, "active_stake": 100000000000000, "active_stake_pct": "33.33333333333333333300", "saturation_pct": null, "block_cnt": 7213, "delegator_cnt": 1, "margin": 1, "fixed_cost": 500000000, "pool_fees": 0, "deleg_rewards": 0, "epoch_ros": "0" }, { "epoch_no": 8, "active_stake": 100000000000000, "active_stake_pct": "33.33333333333333333300", "saturation_pct": null, "block_cnt": 7102, "delegator_cnt": 1, "margin": 1, "fixed_cost": 500000000, "pool_fees": 0, "deleg_rewards": 0, "epoch_ros": "0" } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "c8814a8d064e18b46ffbde6add240203df27533c3ca1fb91c8031b88029ec979", "block_slot": 32288058 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/info": { "get": { "tags": [ "Pools" ], "summary": "Stake pool information", "description": "Returns current information about the specified pool", "operationId": "pool_info", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Current information regarding the specified pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedPoolInfo" }, "example": { "data": { "pool_id_bech32": "pool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8", "pool_id_hex": "f576ef654ff68f93b2554cce4d0691d4ce3b0a0e8742e5ba71a55b8b", "active_epoch_no": 6, "vrf_key_hash": "352196224497a0fd7bad52d113767660bf70f8b11a8c40c265f7bfb359ebe9ee", "margin": 1, "fixed_cost": 500000000, "pledge": 100000000000000, "reward_addr": "stake_test1uzkdwx64sjkt6xxtzye00y3k2m9wn5zultsguadaf4ggmssadyunp", "owners": [ "stake_test1urcnqgzt2x8hpsvej4zfudehahknm8lux894pmqwg5qshgcrn346q" ], "relays": [ { "dns": "preprod-node.world.dev.cardano.org", "srv": null, "ipv4": null, "ipv6": null, "port": 30000 } ], "meta_url": null, "meta_hash": null, "meta_json": null, "pool_status": "registered", "retiring_epoch": null, "op_cert": "4838a036e2540d83eea0d28626f41566dbaf6d263bc9ad95e2ff89740a2a1b65", "op_cert_counter": 5, "active_stake": 1037439267850, "sigma": "0.00432904657047742993", "block_count": 145101, "live_pledge": 1000053629698, "live_stake": 1037439267850, "live_delegators": 13, "live_saturation": "1.7000" }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "5daa79fe4bf6581b59e5ebebb7a0ac6b2edd3ade5016e9db09ac67a7661010e5", "block_slot": 32288194 } } } } }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/metadata": { "get": { "tags": [ "Pools" ], "summary": "Stake pool metadata", "description": "Returns the metadata declared on-chain by the specified stake pool", "operationId": "pool_metadata", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Various metadata for the specified pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedPoolMetadata" }, "example": { "data": { "pool_id_bech32": "pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7", "meta_url": "https://adappt.online/pool_metadata.json", "meta_hash": "be9033a437ba8e8c9ad7e072e71b1afca66ab18225d39d5e9de3d38e1e088f8d", "meta_json": { "name": "Adappt Online", "ticker": "ADAPT", "homepage": "https://adappt.online", "description": "Adappt Online pool supports Cardano and the concept of DApps. On-premise servers with 24/7 monitoring." } }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "d881a61a3573d2fdd0098b9506da74b36f23d67e797f55419dd7eb96a8b327fc", "block_slot": 96405212 } } } } }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/relays": { "get": { "tags": [ "Pools" ], "summary": "Stake pool relays", "description": "Returns a list of relays declared on-chain by the specified stake pool", "operationId": "pool_relays", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "List of relays declared on-chain by the specified pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedPoolRelays" }, "example": { "data": [ { "pool_id_bech32": "pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7", "relays": [ { "dns": "relay1.adappt.online", "srv": null, "ipv4": null, "ipv6": null, "port": 3001 }, { "dns": "relay2.adappt.online", "srv": null, "ipv4": null, "ipv6": null, "port": 3001 } ] } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "44d7fa145be596adba7e1a122cee3204bc1177c21598a3ef199925a13c042082", "block_slot": 96405276 } } } } }, "500": { "description": "Internal server error" } } } }, "/pools/{pool_id}/updates": { "get": { "tags": [ "Pools" ], "summary": "Stake pool updates", "description": "Returns a list of updates relating to the specified pool", "operationId": "pool_updates", "parameters": [ { "name": "pool_id", "in": "path", "description": "Pool ID in bech32 format", "required": true, "schema": { "type": "string" } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "List of pool updates relating to the specified pool", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedPoolUpdates" }, "example": { "data": [ { "tx_hash": "877091a2e789309eecd7d6a15721c6ad8ffdfdbdf8e1fd172f81ce54b7e26f15", "block_time": 1619787462, "pool_id_bech32": "pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7", "pool_id_hex": "780623d70c1168241e1d4d623e5e14e7f02e701b536329e9a735ad61", "active_epoch_no": 265, "vrf_key_hash": "66b11dc1264c5758a202ecea777d12329d6ca3ff111e9a161026d4ccd782238f", "margin": 0.015, "fixed_cost": 340000000, "pledge": 44325545672, "reward_addr": "stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x", "owners": [ "stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x" ], "relays": [ { "dns": "relay1.adappt.online", "srv": null, "ipv4": null, "ipv6": null, "port": 3001 }, { "dns": "relay2.adappt.online", "srv": null, "ipv4": null, "ipv6": null, "port": 3001 } ], "meta_url": "https://adappt.online/pool_metadata.json", "meta_hash": "be9033a437ba8e8c9ad7e072e71b1afca66ab18225d39d5e9de3d38e1e088f8d", "meta_json": { "name": "Adappt Online", "ticker": "ADAPT", "homepage": "https://adappt.online", "description": "Adappt Online pool supports Cardano and the concept of DApps. On-premise servers with 24/7 monitoring." }, "pool_status": "registered", "retiring_epoch": null }, { "tx_hash": "d4c54ce8b1edc60a18914a461c555d9784f8c6599321926302df31008b0c6c02", "block_time": 1596465191, "pool_id_bech32": "pool10qrz84cvz95zg8saf43ruhs5ulczuuqm2d3jn6d8xkkkzgzfje7", "pool_id_hex": "780623d70c1168241e1d4d623e5e14e7f02e701b536329e9a735ad61", "active_epoch_no": 210, "vrf_key_hash": "66b11dc1264c5758a202ecea777d12329d6ca3ff111e9a161026d4ccd782238f", "margin": 0.03, "fixed_cost": 340000000, "pledge": 2061750060728, "reward_addr": "stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x", "owners": [ "stake1u9dh8mls26d6aq68v5nmmkeh5eq563m3w5mnytqppl6l66swz236x", "stake1u95f0rfdr6phfpym6gn5rcfes66dkht0u49d8uhhq53agwc62e5xj", "stake1u8px8vy3lwk8me2umaf2n06jx6q0ghaa0vkehjtg5rqm3yqtckhmm" ], "relays": [ { "dns": "adappt.online", "srv": null, "ipv4": null, "ipv6": null, "port": 3001 } ], "meta_url": "https://adappt.online/pool_metadata.json", "meta_hash": "5a040f5e31f4fef8030fb9f996ac2a7f19852c071dcfd1da6fa0a8416d8fea5f", "meta_json": null, "pool_status": "registered", "retiring_epoch": null } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "4cede7843465d55e260722845c3694970500def738245d340501dfc02ae11517", "block_slot": 96405387 } } } } }, "500": { "description": "Internal server error" } } } }, "/protocol-parameters": { "get": { "tags": [ "General" ], "summary": "Protocol parameters", "description": "Returns the current blockchain protocol parameters", "operationId": "protocol_parameters", "responses": { "200": { "description": "Get protocol params", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedProtocolParameters" }, "example": { "data": { "min_fee_coefficient": 44, "min_fee_constant": { "ada": { "lovelace": 155381 } }, "min_fee_reference_scripts": { "base": 15.0, "range": 25600, "multiplier": 1.2 }, "max_block_body_size": { "bytes": 90112 }, "max_block_header_size": { "bytes": 1100 }, "max_transaction_size": { "bytes": 16384 }, "max_reference_scripts_size": { "bytes": 204800 }, "stake_credential_deposit": { "ada": { "lovelace": 2000000 } }, "stake_pool_deposit": { "ada": { "lovelace": 500000000 } }, "stake_pool_retirement_epoch_bound": 18, "desired_number_of_stake_pools": 500, "stake_pool_pledge_influence": "3/10", "monetary_expansion": "3/1000", "treasury_expansion": "1/5", "min_stake_pool_cost": { "ada": { "lovelace": 170000000 } }, "min_utxo_deposit_constant": { "ada": { "lovelace": 0 } }, "min_utxo_deposit_coefficient": 4310, "plutus_cost_models": { "plutus_v1": [ 100788, 420, 1, 1, 1000, 173, 0, 1, 1000, 59957, 4, 1, 11183, 32, 201305, 8356, 4, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 100, 100, 16000, 100, 94375, 32, 132994, 32, 61462, 4, 72010, 178, 0, 1, 22151, 32, 91189, 769, 4, 2, 85848, 228465, 122, 0, 1, 1, 1000, 42921, 4, 2, 24548, 29498, 38, 1, 898148, 27279, 1, 51775, 558, 1, 39184, 1000, 60594, 1, 141895, 32, 83150, 32, 15299, 32, 76049, 1, 13169, 4, 22100, 10, 28999, 74, 1, 28999, 74, 1, 43285, 552, 1, 44749, 541, 1, 33852, 32, 68246, 32, 72362, 32, 7243, 32, 7391, 32, 11546, 32, 85848, 228465, 122, 0, 1, 1, 90434, 519, 0, 1, 74433, 32, 85848, 228465, 122, 0, 1, 1, 85848, 228465, 122, 0, 1, 1, 270652, 22588, 4, 1457325, 64566, 4, 20467, 1, 4, 0, 141992, 32, 100788, 420, 1, 1, 81663, 32, 59498, 32, 20142, 32, 24588, 32, 20744, 32, 25933, 32, 24623, 32, 53384111, 14333, 10 ], "plutus_v2": [ 100788, 420, 1, 1, 1000, 173, 0, 1, 1000, 59957, 4, 1, 11183, 32, 201305, 8356, 4, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 100, 100, 16000, 100, 94375, 32, 132994, 32, 61462, 4, 72010, 178, 0, 1, 22151, 32, 91189, 769, 4, 2, 85848, 228465, 122, 0, 1, 1, 1000, 42921, 4, 2, 24548, 29498, 38, 1, 898148, 27279, 1, 51775, 558, 1, 39184, 1000, 60594, 1, 141895, 32, 83150, 32, 15299, 32, 76049, 1, 13169, 4, 22100, 10, 28999, 74, 1, 28999, 74, 1, 43285, 552, 1, 44749, 541, 1, 33852, 32, 68246, 32, 72362, 32, 7243, 32, 7391, 32, 11546, 32, 85848, 228465, 122, 0, 1, 1, 90434, 519, 0, 1, 74433, 32, 85848, 228465, 122, 0, 1, 1, 85848, 228465, 122, 0, 1, 1, 955506, 213312, 0, 2, 270652, 22588, 4, 1457325, 64566, 4, 20467, 1, 4, 0, 141992, 32, 100788, 420, 1, 1, 81663, 32, 59498, 32, 20142, 32, 24588, 32, 20744, 32, 25933, 32, 24623, 32, 43053543, 10, 53384111, 14333, 10, 43574283, 26308, 10 ], "plutus_v3": [ 100788, 420, 1, 1, 1000, 173, 0, 1, 1000, 59957, 4, 1, 11183, 32, 201305, 8356, 4, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 16000, 100, 100, 100, 16000, 100, 94375, 32, 132994, 32, 61462, 4, 72010, 178, 0, 1, 22151, 32, 91189, 769, 4, 2, 85848, 123203, 7305, -900, 1716, 549, 57, 85848, 0, 1, 1, 1000, 42921, 4, 2, 24548, 29498, 38, 1, 898148, 27279, 1, 51775, 558, 1, 39184, 1000, 60594, 1, 141895, 32, 83150, 32, 15299, 32, 76049, 1, 13169, 4, 22100, 10, 28999, 74, 1, 28999, 74, 1, 43285, 552, 1, 44749, 541, 1, 33852, 32, 68246, 32, 72362, 32, 7243, 32, 7391, 32, 11546, 32, 85848, 123203, 7305, -900, 1716, 549, 57, 85848, 0, 1, 90434, 519, 0, 1, 74433, 32, 85848, 123203, 7305, -900, 1716, 549, 57, 85848, 0, 1, 1, 85848, 123203, 7305, -900, 1716, 549, 57, 85848, 0, 1, 955506, 213312, 0, 2, 270652, 22588, 4, 1457325, 64566, 4, 20467, 1, 4, 0, 141992, 32, 100788, 420, 1, 1, 81663, 32, 59498, 32, 20142, 32, 24588, 32, 20744, 32, 25933, 32, 24623, 32, 43053543, 10, 53384111, 14333, 10, 43574283, 26308, 10, 16000, 100, 16000, 100, 962335, 18, 2780678, 6, 442008, 1, 52538055, 3756, 18, 267929, 18, 76433006, 8868, 18, 52948122, 18, 1995836, 36, 3227919, 12, 901022, 1, 166917843, 4307, 36, 284546, 36, 158221314, 26549, 36, 74698472, 36, 333849714, 1, 254006273, 72, 2174038, 72, 2261318, 64571, 4, 207616, 8310, 4, 1293828, 28716, 63, 0, 1, 1006041, 43623, 251, 0, 1 ] }, "script_execution_prices": { "memory": "577/10000", "cpu": "721/10000000" }, "max_execution_units_per_transaction": { "memory": 14000000, "cpu": 10000000000 }, "max_execution_units_per_block": { "memory": 62000000, "cpu": 20000000000 }, "max_value_size": { "bytes": 5000 }, "collateral_percentage": 150, "max_collateral_inputs": 3, "version": { "major": 9, "minor": 0 }, "stake_pool_voting_thresholds": { "no_confidence": "51/100", "constitutional_committee": { "default": "51/100", "state_of_no_confidence": "51/100" }, "hard_fork_initiation": "51/100", "protocol_parameters_update": { "security": "51/100" } }, "delegate_representative_voting_thresholds": { "no_confidence": "67/100", "constitutional_committee": { "default": "67/100", "state_of_no_confidence": "3/5" }, "constitution": "3/4", "hard_fork_initiation": "3/5", "protocol_parameters_update": { "network": "67/100", "economic": "67/100", "technical": "67/100", "governance": "3/4" }, "treasury_withdrawals": "67/100" }, "constitutional_committee_min_size": 7, "constitutional_committee_max_term_length": 146, "governance_action_lifetime": 6, "governance_action_deposit": { "ada": { "lovelace": 100000000000 } }, "delegate_representative_deposit": { "ada": { "lovelace": 500000000 } }, "delegate_representative_max_idle_time": 20 }, "last_updated": { "timestamp": "2024-08-29 16:03:26", "block_hash": "ebe27467ad34f4ecb80a3a537aae2e084e34d751426d484f87a5a6a9db4c216f", "block_slot": 69264206 } } } } }, "500": { "description": "Internal server error" } } } }, "/scripts/{script_hash}": { "get": { "tags": [ "Scripts" ], "summary": "Script by script hash", "description": "Returns the script corresponding to the specified script hash, if the script has been seen on-chain", "operationId": "script_by_hash", "parameters": [ { "name": "script_hash", "in": "path", "description": "Hex encoded script hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Script corresponding to the provided script hash", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedScriptFirstSeen" }, "examples": { "Native": { "summary": "An example response for a Native script", "value": { "data": { "hash": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a", "type": "native", "bytes": "8200581c4da965a049dfd15ed1ee19fba6e2974a0b79fc416dd1796a1f97f5e1", "json": { "keyHash": "4da965a049dfd15ed1ee19fba6e2974a0b79fc416dd1796a1f97f5e1", "type": "sig" }, "first_seen": { "tx_hash": "257916e7ae112cf16f27218e41bfa37c018bab922354201b3b38c9a24c35ab33", "slot": 55718892, "timestamp": "2022-03-14 19:13:03" } }, "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 } } }, "Plutus": { "summary": "An example response for a Plutus script", "value": { "data": { "hash": "a65ca58a4e9c755fa830173d2a5caed458ac0c73f97db7faae2e7e3b", "type": "plutusv1", "bytes": "59014f59014c0100003232323232323232222...8c0088cc00800800555cf2ba15573e6e1d200201", "json": null, "first_seen": { "tx_hash": "27836bbea6fba67a9209de16c81d426e92ac218e5007fbf86d3a6786ca1db316", "slot": 106047961, "timestamp": "2023-10-18 07:30:52" } }, "last_updated": { "timestamp": "2023-10-18 07:30:52", "block_hash": "0e1e924710135acfe200ab13d290bd282a67584fd54456f0dcac0aeaa38bb2c2", "block_slot": 106047961 } } } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/system-start": { "get": { "tags": [ "General" ], "summary": "Blockchain system start", "description": "Returns the blockchain system start time", "operationId": "system_start", "responses": { "200": { "description": "Get system start time", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedSystemStart" }, "example": { "data": "2017-09-23 21:44:51", "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "2e220d7adfe5b9e6444894ae237679c29d71fc4b44cc36aa9156262b4bb4c159", "block_slot": 96402974 } } } } }, "500": { "description": "Internal server error" } } } }, "/transactions/evaluate": { "post": { "tags": [ "Transactions" ], "summary": "Evaluate redeemers of a transaction", "description": "Executes the redeemers of a transaction in order to compute how many execution units are needed for each, without submitting the transaction to the chain and without requiring the transaction to be fully-valid.\n\nUseful during transaction building to compute what budget should be used for each redeemer.\n\nNote that all transaction inputs and reference inputs must be able to be resolved (we must be able to find the contents of that UTxO by finding the UTxO on-chain) in order to evaluate the transaction. If your transaction contains any inputs which may not be found on-chain at the time of evaluation, for example if you are transaction chaining, then you must pass in these inputs and their corresponding transaction output bytes as additional UTxOs.", "operationId": "evaluate_redeemers", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluateRequest" }, "examples": { "With Additional UTxOs": { "summary": "Transaction evaluation request with additional input UTxOs", "value": { "cbor": "84a80084825820649748a242393deac81d6f88a2b7edfec28b...946693a204c50204f726465722050726f63657373", "additional_utxos": [ { "tx_hash": "649748a242393deac81d6f88a2b7edfec28b1966d1d88b7f0a36e2d8c60ef9e9", "index": 0, "txout_cbor": "83581d713422c13d5a97e68fe725d3d740b7f96cb315e3b44d03a2be28863beb821a0ae72e72a1581c804f5544c1962a40546827cab750a88404dc7108c0f588b72964754fa144565946491a0e9b3eda58205b90f5d273e2d7f7db45dc4f0efdcfe7536250a9abf18dee57abee9c798944c7" } ] } }, "Without Additional UTxOs": { "summary": "Transaction evaluation request without additional UTxOs", "value": { "cbor": "84a80084825820649748a242393deac81d6f88a2b...8176567946693a204c50204f726465722050726f63657373" } } } } }, "required": true }, "responses": { "200": { "description": "Details of executed redeemers", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EvaluatedRedeemer" } }, "example": [ { "redeemer_tag": "spend", "redeemer_index": 0, "ex_units": { "mem": 426418, "steps": 125361025 } }, { "redeemer_tag": "spend", "redeemer_index": 1, "ex_units": { "mem": 385832, "steps": 113607371 } }, { "redeemer_tag": "mint", "redeemer_index": 0, "ex_units": { "mem": 388722, "steps": 111814261 } } ] } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/transactions/outputs": { "post": { "tags": [ "Transactions" ], "summary": "Transaction outputs by output references", "description": "Returns the specified transaction outputs. Returns 404 if any of the outputs specified do not exist unless the allow_missing query parameter is set to true. Results are sorted lexicographically by output reference and duplicates are omitted. Do not change the output references parameter while paginating.", "operationId": "txos_by_txo_refs", "parameters": [ { "name": "resolve_datums", "in": "query", "description": "Try find and include the corresponding datums for datum hashes", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "with_cbor", "in": "query", "description": "Include the CBOR encoding of the transaction output in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "allow_missing", "in": "query", "description": "Do not return 404 if any transactions are not found (404 will still be returned if you specify an index higher than the number of outputs in a transaction)", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "count", "in": "query", "description": "The max number of results per page", "required": false, "schema": { "allOf": [ { "type": "integer", "default": 100, "minimum": 0 } ], "nullable": true } }, { "name": "cursor", "in": "query", "description": "Pagination cursor string, use the cursor included in a page of results to fetch the next page", "required": false, "schema": { "type": "string", "nullable": true } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } }, "example": [ "a90e31b3de59452659617c351e5f746b819cb8b026bf945dd41b4cc199bcc8c9#1", "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0#0" ] } }, "required": true }, "responses": { "200": { "description": "Get transaction outputs via output references", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUtxoWithBytes" }, "example": { "data": [ { "tx_hash": "31a84c3c6200bec2498b18c42f882fa690cd0d32a9c84a2019eb5cc42f5971d0", "index": 0, "assets": [ { "unit": "lovelace", "amount": 27660180 } ], "address": "addr1wxn9efv2f6w82hagxqtn62ju4m293tqvw0uhmdl64ch8uwc0h43gt", "datum": { "type": "hash", "hash": "f03819a4039003a8c6b65153351adbc61f983bd22787ed238a5b4f24a01aa5d6", "bytes": "d8799fd8799fd8799f581cfc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4cffd8799fd8799fd8799f581cd756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29ffffffffd8799fd8799f581cfc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4cffd8799fd8799fd8799f581cd756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29ffffffffd87a80d87a9fd8799f581c25f0fc240e91bd95dcdaebd2ba7713fc5168ac77234a3d79449fc20c47534f4349455459ff1a0bebc200ff1a001e84801a001e8480ff", "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "fc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4c" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "d756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29" } ] } ] } ] } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "fc6e1b47816bc4a4165a39f3c6dd65868e6b74a743dc2dcf54eb2d4c" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "d756fb7ceee90ed5af3f193d73f9970ca640ab540eedac272cb28c29" } ] } ] } ] } ] }, { "constructor": 1, "fields": [] }, { "constructor": 1, "fields": [ { "constructor": 0, "fields": [ { "bytes": "25f0fc240e91bd95dcdaebd2ba7713fc5168ac77234a3d79449fc20c" }, { "bytes": "534f4349455459" } ] }, { "int": 200000000 } ] }, { "int": 2000000 }, { "int": 2000000 } ] } }, "reference_script": null, "txout_cbor": null }, { "tx_hash": "a90e31b3de59452659617c351e5f746b819cb8b026bf945dd41b4cc199bcc8c9", "index": 1, "assets": [ { "unit": "lovelace", "amount": 118671749 } ], "address": "addr1qy27nwry749alh8ajmkghml67j9egdx9asgcnsjk8wldfs40m5d3qle5j85vfd335zzxfdz9eshkjh58svvjwtgxt0tskx7f5l", "datum": null, "reference_script": null, "txout_cbor": null } ], "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "bdf4630098ac6923e0ef1ca0b0d6e00dca96790a8c3dd670948fdfe1456798d2", "block_slot": 73867237 }, "next_cursor": null } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/transactions/{tx_hash}": { "get": { "tags": [ "Transactions" ], "summary": "Transaction details", "description": "Returns detailed information about a transaction", "operationId": "tx_info", "parameters": [ { "name": "tx_hash", "in": "path", "description": "Transaction hash in hex", "required": true, "schema": { "type": "string" } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Detailed information about the specified transaction", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedTransactionInfo" }, "example": { "data": { "tx_hash": "e33433bdc122bd4032e2d4d2371d75658f81804c50e56c4edf2da01baaccccc7", "block_hash": "58df3617b77c9b8da958c118c3daf9cabae86e31aca761fe9bb8d57b40fe14be", "block_tx_index": 26, "block_height": 9661308, "block_timestamp": 1702330595, "block_absolute_slot": 110764304, "block_epoch": 453, "inputs": [ { "tx_hash": "498965c4ca9e705e0e4fa90c7b723b6bf5bcdf4362e4843c8b9bd54eaa73c9ad", "index": 0, "assets": [ { "unit": "lovelace", "amount": 344000000 } ], "address": "addr1zxn9efv2f6w82hagxqtn62ju4m293tqvw0uhmdl64ch8uw6j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pq6s3z70", "datum": { "type": "hash", "hash": "352956040ebdafc51cb80aed1dcbbbceff03dcfde2eb56cc29511856b5bb476a", "bytes": "d8799fd8799fd8799f581c3e7016902520a84e8911db26a045ad31224da1a631929f5fc149724dffd8799fd8799fd8799f581c09d9128f44e94b849a09d90eeaec4b26c60c4f11a40a94ca2267e353ffffffffd8799fd8799f581c3e7016902520a84e8911db26a045ad31224da1a631929f5fc149724dffd8799fd8799fd8799f581c09d9128f44e94b849a09d90eeaec4b26c60c4f11a40a94ca2267e353ffffffffd87a80d8799fd8799f581c5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d11443494147ff1a4183768bff1a001e84801a001e8480ff", "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "3e7016902520a84e8911db26a045ad31224da1a631929f5fc149724d" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "09d9128f44e94b849a09d90eeaec4b26c60c4f11a40a94ca2267e353" } ] } ] } ] } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "3e7016902520a84e8911db26a045ad31224da1a631929f5fc149724d" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "09d9128f44e94b849a09d90eeaec4b26c60c4f11a40a94ca2267e353" } ] } ] } ] } ] }, { "constructor": 1, "fields": [] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114" }, { "bytes": "494147" } ] }, { "int": 1099134603 } ] }, { "int": 2000000 }, { "int": 2000000 } ] } }, "reference_script": null }, { "tx_hash": "c22e28eb033ac63a549e65e0407d374c14bf5805b37f7c8a7b1a0770fe00c656", "index": 0, "assets": [ { "unit": "lovelace", "amount": 1416027292509 }, { "unit": "0be55d262b29f564998ff81efe21bdc0022621c12f15af08d0f2ddb1bdfd144032f09ad980b8d205fef0737c2232b4e90a5d34cc814d0ef687052400", "amount": 1 }, { "unit": "13aa2accf2e1561723aa26871e071fdf32c867cff7e7d50ad470d62f4d494e53574150", "amount": 1 }, { "unit": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114494147", "amount": 4615496690137 }, { "unit": "e4214b7cce62ac6fbba385d164df48e157eae5863521b4b67ca71d86bdfd144032f09ad980b8d205fef0737c2232b4e90a5d34cc814d0ef687052400", "amount": 1365147 } ], "address": "addr1z8snz7c4974vzdpxu65ruphl3zjdvtxw8strf2c2tmqnxz2j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pq0xmsha", "datum": { "type": "hash", "hash": "d97ccf3eba5574c513e902ca376bd087c03311c425d481a4ffc38b5c27b8cb4c", "bytes": "d8799fd8799f4040ffd8799f581c5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d11443494147ff1b0000018bc1e7de051b0000025339590c7ad8799fd8799fd8799fd8799f581caafb1196434cb837fd6f21323ca37b302dff6387e8a84b3fa28faf56ffd8799fd8799fd8799f581c52563c5410bff6a0d43ccebb7c37e1f69f5eb260552521adff33b9c2ffffffffd87a80ffffff", "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "" }, { "bytes": "" } ] }, { "constructor": 0, "fields": [ { "bytes": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114" }, { "bytes": "494147" } ] }, { "int": 1699765280261 }, { "int": 2556467678330 }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "aafb1196434cb837fd6f21323ca37b302dff6387e8a84b3fa28faf56" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "52563c5410bff6a0d43ccebb7c37e1f69f5eb260552521adff33b9c2" } ] } ] } ] } ] }, { "constructor": 1, "fields": [] } ] } ] } ] } }, "reference_script": null }, { "tx_hash": "c8fcd44cfa28d6cd9b58ff1cd8c5ce1dc4872ec2655fa723c58ef683610bdc4b", "index": 2, "assets": [ { "unit": "lovelace", "amount": 1455465782 }, { "unit": "2f2e0404310c106e2a260e8eb5a7e43f00cff42c667489d30e17981631373032363237323030303030", "amount": 1 } ], "address": "addr1qx7tzh4qen0p50ntefz8yujwgqt7zulef6t6vrf7dq4xa82j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pqrkj6fh", "datum": null, "reference_script": null } ], "outputs": [ { "tx_hash": "e33433bdc122bd4032e2d4d2371d75658f81804c50e56c4edf2da01baaccccc7", "index": 0, "assets": [ { "unit": "lovelace", "amount": 1416367292509 }, { "unit": "0be55d262b29f564998ff81efe21bdc0022621c12f15af08d0f2ddb1bdfd144032f09ad980b8d205fef0737c2232b4e90a5d34cc814d0ef687052400", "amount": 1 }, { "unit": "13aa2accf2e1561723aa26871e071fdf32c867cff7e7d50ad470d62f4d494e53574150", "amount": 1 }, { "unit": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114494147", "amount": 4614392059860 }, { "unit": "e4214b7cce62ac6fbba385d164df48e157eae5863521b4b67ca71d86bdfd144032f09ad980b8d205fef0737c2232b4e90a5d34cc814d0ef687052400", "amount": 1365147 } ], "address": "addr1z8snz7c4974vzdpxu65ruphl3zjdvtxw8strf2c2tmqnxz2j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pq0xmsha", "datum": { "type": "hash", "hash": "d97ccf3eba5574c513e902ca376bd087c03311c425d481a4ffc38b5c27b8cb4c", "bytes": "d8799fd8799f4040ffd8799f581c5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d11443494147ff1b0000018bc1e7de051b0000025339590c7ad8799fd8799fd8799fd8799f581caafb1196434cb837fd6f21323ca37b302dff6387e8a84b3fa28faf56ffd8799fd8799fd8799f581c52563c5410bff6a0d43ccebb7c37e1f69f5eb260552521adff33b9c2ffffffffd87a80ffffff", "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "" }, { "bytes": "" } ] }, { "constructor": 0, "fields": [ { "bytes": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114" }, { "bytes": "494147" } ] }, { "int": 1699765280261 }, { "int": 2556467678330 }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "aafb1196434cb837fd6f21323ca37b302dff6387e8a84b3fa28faf56" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "52563c5410bff6a0d43ccebb7c37e1f69f5eb260552521adff33b9c2" } ] } ] } ] } ] }, { "constructor": 1, "fields": [] } ] } ] } ] } }, "reference_script": null }, { "tx_hash": "e33433bdc122bd4032e2d4d2371d75658f81804c50e56c4edf2da01baaccccc7", "index": 1, "assets": [ { "unit": "lovelace", "amount": 2000000 }, { "unit": "5d16cc1a177b5d9ba9cfa9793b07e60f1fb70fea1f8aef064415d114494147", "amount": 1104630277 } ], "address": "addr1qyl8q95sy5s2sn5fz8djdgz945cjyndp5cce986lc9yhyngfmyfg738ffwzf5zwepm4wcjexccxy7ydyp22v5gn8udfste7yl4", "datum": null, "reference_script": null }, { "tx_hash": "e33433bdc122bd4032e2d4d2371d75658f81804c50e56c4edf2da01baaccccc7", "index": 2, "assets": [ { "unit": "lovelace", "amount": 1456673898 }, { "unit": "2f2e0404310c106e2a260e8eb5a7e43f00cff42c667489d30e17981631373032363237323030303030", "amount": 1 } ], "address": "addr1qx7tzh4qen0p50ntefz8yujwgqt7zulef6t6vrf7dq4xa82j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pqrkj6fh", "datum": null, "reference_script": null } ], "reference_inputs": [], "collateral_inputs": [ { "tx_hash": "c8fcd44cfa28d6cd9b58ff1cd8c5ce1dc4872ec2655fa723c58ef683610bdc4b", "index": 2, "assets": [ { "unit": "lovelace", "amount": 1455465782 }, { "unit": "2f2e0404310c106e2a260e8eb5a7e43f00cff42c667489d30e17981631373032363237323030303030", "amount": 1 } ], "address": "addr1qx7tzh4qen0p50ntefz8yujwgqt7zulef6t6vrf7dq4xa82j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pqrkj6fh", "datum": null, "reference_script": null } ], "collateral_return": { "tx_hash": "e33433bdc122bd4032e2d4d2371d75658f81804c50e56c4edf2da01baaccccc7", "index": 3, "assets": [ { "unit": "lovelace", "amount": 1450465782 }, { "unit": "2f2e0404310c106e2a260e8eb5a7e43f00cff42c667489d30e17981631373032363237323030303030", "amount": 1 } ], "address": "addr1qx7tzh4qen0p50ntefz8yujwgqt7zulef6t6vrf7dq4xa82j2c79gy9l76sdg0xwhd7r0c0kna0tycz4y5s6mlenh8pqrkj6fh", "datum": null, "reference_script": null }, "mint": [], "invalid_before": 110764281, "invalid_hereafter": 110765281, "fee": 791884, "deposit": 0, "certificates": { "stake_registrations": [], "stake_deregistrations": [], "stake_delegations": [], "pool_registrations": [], "pool_retirements": [], "reg_certs": [], "unreg_certs": [], "vote_delegations": [], "stake_vote_delegations": [], "stake_reg_delegations": [], "vote_reg_delegations": [], "stake_vote_reg_delegations": [], "auth_committee_hot_certs": [], "resign_committee_cold_certs": [], "reg_drep_certs": [], "unreg_drep_certs": [], "update_drep_certs": [], "mir_transfers": [] }, "withdrawals": [], "additional_signers": [ "bcb15ea0ccde1a3e6bca4472724e4017e173f94e97a60d3e682a6e9d" ], "scripts_executed": [ { "hash": "a65ca58a4e9c755fa830173d2a5caed458ac0c73f97db7faae2e7e3b", "type": "plutusv1", "bytes": "59014c01000032323232323232322223232325333009300e300700213...", "json": null }, { "hash": "e1317b152faac13426e6a83e06ff88a4d62cce3c1634ab0a5ec13309", "type": "plutusv1", "bytes": "591e18010000323232323232323232323232323232323232323232323...", "json": null } ], "scripts_successful": true, "redeemers": { "spends": [ { "script_hash": "a65ca58a4e9c755fa830173d2a5caed458ac0c73f97db7faae2e7e3b", "input": { "tx_hash": "498965c4ca9e705e0e4fa90c7b723b6bf5bcdf4362e4843c8b9bd54eaa73c9ad", "index": 0 }, "input_index": 0, "data": { "json": { "constructor": 0, "fields": [] }, "bytes": "d87980" }, "ex_units": [ 42061, 14890343 ] }, { "script_hash": "e1317b152faac13426e6a83e06ff88a4d62cce3c1634ab0a5ec13309", "input": { "tx_hash": "c22e28eb033ac63a549e65e0407d374c14bf5805b37f7c8a7b1a0770fe00c656", "index": 0 }, "input_index": 1, "data": { "json": { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "bcb15ea0ccde1a3e6bca4472724e4017e173f94e97a60d3e682a6e9d" } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "bytes": "52563c5410bff6a0d43ccebb7c37e1f69f5eb260552521adff33b9c2" } ] } ] } ] } ] }, { "int": 2 } ] }, "bytes": "d8799fd8799fd8799f581cbcb15ea0ccde1a3e6bca4472724e40..." }, "ex_units": [ 2639497, 790336775 ] } ], "mints": [], "withdrawals": [], "certificates": [], "votes": [], "proposals": [] }, "metadata": { "674": { "msg": [ "Minswap: Order Executed" ] } }, "size": 9626 }, "last_updated": { "timestamp": "2023-12-11 21:36:35", "block_hash": "58df3617b77c9b8da958c118c3daf9cabae86e31aca761fe9bb8d57b40fe14be", "block_slot": 110764304 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/transactions/{tx_hash}/cbor": { "get": { "tags": [ "Transactions" ], "summary": "CBOR bytes of a transaction", "description": "Returns hex-encoded CBOR bytes of a transaction", "operationId": "tx_cbor_by_tx_hash", "parameters": [ { "name": "tx_hash", "in": "path", "description": "Transaction Hash", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Get a transaction's hex encoded cbor via a transaction hash", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedTxCbor" }, "example": { "data": "84a8008282582085b5faa0ea5e....0821a0008743d1a0c1c6598f5f6", "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "9f729f5404f6a4efcd65f5306e8c1784a9277f7408369cb92c567ccbfb6460b6", "block_slot": 32295201 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/transactions/{tx_hash}/outputs/{index}/address": { "get": { "tags": [ "Transactions" ], "summary": "Address by transaction output reference", "description": "Returns the address which was specified in the given transaction output.\n\nNote that if the transaction is invalid this will only return a result for the collateral return output, should one be present in the transaction. If the transaction is valid it will not return a result for the collateral return output.", "operationId": "address_by_txo", "parameters": [ { "name": "tx_hash", "in": "path", "description": "Transaction Hash", "required": true, "schema": { "type": "string" } }, { "name": "index", "in": "path", "description": "Output Index", "required": true, "schema": { "type": "integer", "minimum": 0 } } ], "responses": { "200": { "description": "Get an address via a transaction output reference", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedAddress" }, "example": { "data": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "8cd56aae0fc966903b2b215a477d57e7b3f4a225af3eeea4b62be724c9fa1195", "block_slot": 32295075 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } }, "/transactions/{tx_hash}/outputs/{index}/txo": { "get": { "tags": [ "Transactions" ], "summary": "Transaction output by output reference", "description": "Returns the specified transaction output. Attempts to resolve the datum hash to the corresponding bytes and JSON, should the output contain a datum hash.", "operationId": "txo_by_txo_ref", "parameters": [ { "name": "with_cbor", "in": "query", "description": "Include the CBOR encoding of the transaction output in the response", "required": false, "schema": { "type": "boolean", "nullable": true } }, { "name": "tx_hash", "in": "path", "description": "Transaction Hash", "required": true, "schema": { "type": "string" } }, { "name": "index", "in": "path", "description": "Output Index", "required": true, "schema": { "type": "integer", "minimum": 0 } }, { "name": "amounts-as-strings", "in": "header", "description": "Large numbers returned as strings if set to true", "required": false, "schema": { "type": "string", "nullable": true } } ], "responses": { "200": { "description": "Get a transaction output via it's output reference", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TimestampedUtxo" }, "example": { "data": { "tx_hash": "291b983ac75275a933415475d6417413b34eaccc5f0794fd7b9e8d04e7fe077e", "index": 0, "assets": [ { "unit": "lovelace", "amount": 1224040 }, { "unit": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2446a65644f7261636c654e4654", "amount": 1 } ], "address": "addr_test1wzdtu0djc76qyqak9cj239udezj2544nyk3ksmfqvaksv7c9xanpg", "datum": { "type": "hash", "hash": "5fc2400956b1d1828bea0be9c94e95f2b3cebda27c21b07e8a6bada2b2588163", "bytes": "d8799f584073ab91123886242e4d02de6ed05490d684e99a99c49b957a5f943a80655ac0744372adeacdc7dedb95a818ce676886f1306d439152b82d48de71688008840d00d8799fd8799f1a00030d401a000116e5ffd8799fd8799fd87a9f1b000001863d492040ffd87a80ffd8799fd87a9f1b000001863d649780ffd87a80ffff43555344ff581c0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2ff", "json": { "constructor": 0, "fields": [ { "bytes": "73ab91123886242e4d02de6ed05490d684e99a99c49b957a5f943a80655ac0744372adeacdc7dedb95a818ce676886f1306d439152b82d48de71688008840d00" }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "int": 200000 }, { "int": 71397 } ] }, { "constructor": 0, "fields": [ { "constructor": 0, "fields": [ { "constructor": 1, "fields": [ { "int": 1676065448000 } ] }, { "constructor": 1, "fields": [] } ] }, { "constructor": 0, "fields": [ { "constructor": 1, "fields": [ { "int": 1676067248000 } ] }, { "constructor": 1, "fields": [] } ] } ] }, { "bytes": "555344" } ] }, { "bytes": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2" } ] } }, "reference_script": null, "txout_cbor": null }, "last_updated": { "timestamp": "2022-10-10 20:25:28", "block_hash": "3c504cc4ce12a511db04838b544820c4e2281c0209a906ca17981cf63a084b7b", "block_slot": 32295757 } } } } }, "400": { "description": "Malformed query parameters" }, "404": { "description": "No results found" }, "500": { "description": "Internal server error" } } } } }, "components": { "schemas": { "AccountAction": { "type": "string", "description": "Type of staking-related action", "enum": [ "registration", "deregistration", "delegation", "withdrawal" ] }, "AccountDelegation": { "type": "object", "description": "Stake account related update", "required": [ "active_epoch_no", "pool_id", "slot" ], "properties": { "active_epoch_no": { "type": "integer", "format": "int64", "description": "Epoch number in which the delegation becomes active" }, "pool_id": { "type": "string", "description": "Bech32 encoded pool ID the account is delegating to" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which contained the transaction" } } }, "AccountHistory": { "type": "object", "description": "Per-epoch information about a stake account", "required": [ "epoch_no", "active_stake" ], "properties": { "active_stake": { "$ref": "#/components/schemas/NumOrString" }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch number" }, "pool_id": { "type": "string", "description": "Bech32 encoded pool ID the account was delegated to", "nullable": true } } }, "AccountInfo": { "type": "object", "description": "Summary of information regarding a stake account", "required": [ "stake_address", "registered", "rewards_available", "utxo_balance", "total_balance", "total_rewarded", "total_withdrawn" ], "properties": { "delegated_pool": { "type": "string", "description": "Bech32 pool ID that the stake key is delegated to", "nullable": true }, "registered": { "type": "boolean", "description": "True if the stake key is registered" }, "rewards_available": { "$ref": "#/components/schemas/NumOrString" }, "stake_address": { "type": "string", "description": "Bech32 encoded stake address" }, "total_balance": { "$ref": "#/components/schemas/NumOrString" }, "total_rewarded": { "$ref": "#/components/schemas/NumOrString" }, "total_withdrawn": { "$ref": "#/components/schemas/NumOrString" }, "utxo_balance": { "$ref": "#/components/schemas/NumOrString" } } }, "AccountReward": { "type": "object", "description": "Stake account related reward", "required": [ "type", "earned_epoch", "spendable_epoch", "amount" ], "properties": { "amount": { "$ref": "#/components/schemas/NumOrString" }, "earned_epoch": { "type": "integer", "format": "int32", "description": "Epoch in which the reward was earned" }, "pool_id": { "type": "string", "description": "Bech32 encoded pool ID (if relevant to reward type)", "nullable": true }, "spendable_epoch": { "type": "integer", "format": "int32", "description": "Epoch at which the reward is spendable" }, "type": { "$ref": "#/components/schemas/AccountStakingRewardType" } } }, "AccountRewardType": { "type": "string", "description": "Type of stake account reward", "enum": [ "member", "leader", "treasury", "reserves", "refund" ] }, "AccountStakingRewardType": { "type": "string", "description": "Staking-related reward type", "enum": [ "member", "leader", "refund" ] }, "AccountUpdate": { "type": "object", "description": "Stake account related update", "required": [ "action", "tx_hash", "epoch_no", "abs_slot" ], "properties": { "abs_slot": { "type": "integer", "format": "int32", "description": "Absolute slot of the block which contained the transaction" }, "action": { "$ref": "#/components/schemas/AccountAction" }, "deposit": { "type": "string", "description": "Deposit in lovelace if action is Registration", "nullable": true }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch number in which the transaction occured" }, "tx_hash": { "type": "string", "description": "Transaction hash of the transaction which performed the action" } } }, "Ada": { "type": "object", "required": [ "lovelace" ], "properties": { "lovelace": { "type": "integer", "format": "int64" } } }, "AdditionalUtxo": { "type": "object", "description": "UTxO which may not exist on-chain yet but is used in the transaction inputs or reference inputs", "required": [ "tx_hash", "index", "txout_cbor" ], "properties": { "index": { "type": "integer", "format": "int64", "description": "UTxO transaction index", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" }, "txout_cbor": { "type": "string", "description": "CBOR encoding of the UTxO" } } }, "Address": { "type": "string", "description": "Bech32-encoded Cardano Address" }, "AddressInfo": { "type": "object", "description": "Information decoded from a Cardano address", "required": [ "hex" ], "properties": { "bech32": { "type": "string", "nullable": true }, "hex": { "type": "string" }, "network": { "allOf": [ { "$ref": "#/components/schemas/NetworkId" } ], "nullable": true }, "payment_cred": { "allOf": [ { "$ref": "#/components/schemas/PaymentCredential" } ], "nullable": true }, "staking_cred": { "allOf": [ { "$ref": "#/components/schemas/StakingCredential" } ], "nullable": true } } }, "AddressTransaction": { "type": "object", "description": "Transaction which involved a specific address", "required": [ "tx_hash", "slot", "input", "output" ], "properties": { "input": { "type": "boolean", "description": "Address controlled at least one of the consumed UTxOs" }, "output": { "type": "boolean", "description": "Address controlled at least one of the produced UTxOs" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which contains the transaction", "minimum": 0 }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "Anchor": { "type": "object", "required": [ "url", "content_hash" ], "properties": { "content_hash": { "type": "string", "description": "Hash of data at URL" }, "url": { "type": "string", "description": "URL" } } }, "Asset": { "type": "object", "description": "Lovelace or native asset", "required": [ "unit", "amount" ], "properties": { "amount": { "$ref": "#/components/schemas/NumOrString" }, "unit": { "type": "string", "description": "Asset (either lovelace or concatenation of hex encoded policy ID and asset name for native asset)" } } }, "AssetHolder": { "type": "object", "description": "Holder of a specific asset", "required": [ "address", "amount" ], "properties": { "address": { "type": "string", "description": "Address of the holder" }, "amount": { "$ref": "#/components/schemas/NumOrString" } } }, "AssetHolderAccount": { "type": "object", "description": "Account which controls some of a specific asset", "required": [ "account", "amount" ], "properties": { "account": { "type": "string", "description": "Stake/reward address for stake credential" }, "amount": { "$ref": "#/components/schemas/NumOrString" } } }, "AssetInPolicy": { "type": "object", "description": "Asset of a specific policy", "required": [ "name", "amount" ], "properties": { "amount": { "$ref": "#/components/schemas/NumOrString" }, "name": { "type": "string", "description": "Hex encoded asset name" } } }, "AssetInPolicyMint": { "type": "object", "description": "Name of asset of a specific policy and amount minted or burned", "required": [ "name", "amount" ], "properties": { "amount": { "type": "string", "description": "Amount of asset minted (negative if burned)" }, "name": { "type": "string", "description": "Asset name" } } }, "AssetInfo": { "type": "object", "description": "Information about a specific Cardano native-asset", "required": [ "asset_name", "asset_name_ascii", "fingerprint", "total_supply", "unique_holders", "first_mint_tx", "latest_mint_tx", "mint_tx_count", "burn_tx_count", "asset_standards" ], "properties": { "asset_name": { "type": "string", "description": "Hex encoding of the asset name" }, "asset_name_ascii": { "type": "string", "description": "ASCII representation of the asset name" }, "asset_standards": { "$ref": "#/components/schemas/AssetStandards" }, "burn_tx_count": { "type": "integer", "format": "int64", "description": "Number of transactions which burned some of the asset", "minimum": 0 }, "fingerprint": { "type": "string", "description": "CIP-14 fingerprint of the asset" }, "first_mint_tx": { "$ref": "#/components/schemas/MintTransaction" }, "latest_mint_tx": { "$ref": "#/components/schemas/MintTransaction" }, "latest_mint_tx_metadata": { "type": "object", "description": "Metadata of the most recent transaction which minted or burned the asset", "nullable": true }, "mint_tx_count": { "type": "integer", "format": "int64", "description": "Number of transactions which minted some of the asset", "minimum": 0 }, "token_registry_metadata": { "allOf": [ { "$ref": "#/components/schemas/TokenRegistryMetadata" } ], "nullable": true }, "total_supply": { "type": "string", "description": "Total amount of the asset in existence currently" }, "unique_holders": { "$ref": "#/components/schemas/Holders" } } }, "AssetInfoConcise": { "type": "object", "description": "Information about a specific Cardano native-asset", "required": [ "asset_name", "asset_name_ascii", "fingerprint", "total_supply", "asset_standards" ], "properties": { "asset_name": { "type": "string", "description": "Hex encoding of the asset name" }, "asset_name_ascii": { "type": "string", "description": "ASCII representation of the asset name" }, "asset_standards": { "$ref": "#/components/schemas/AssetStandards" }, "fingerprint": { "type": "string", "description": "CIP-14 fingerprint of the asset" }, "total_supply": { "type": "string", "description": "Current amount of the asset minted" } } }, "AssetInfoOld": { "type": "object", "description": "Information about a specific Cardano native-asset", "required": [ "asset_name", "fingerprint", "total_supply", "first_mint_tx", "first_mint_time", "mint_tx_count", "burn_tx_count", "asset_standards", "latest_mint_tx_metadata" ], "properties": { "asset_name": { "type": "string", "description": "Hex encoding of the asset name" }, "asset_name_ascii": { "type": "string", "description": "ASCII representation of the asset name", "nullable": true }, "asset_standards": { "$ref": "#/components/schemas/AssetStandards" }, "burn_tx_count": { "type": "integer", "format": "int64", "description": "Number of transactions which burned some of the asset" }, "fingerprint": { "type": "string", "description": "CIP-14 fingerprint of the asset" }, "first_mint_time": { "type": "integer", "format": "int32", "description": "Time of the first transaction which minted some of a specific asset" }, "first_mint_tx": { "type": "string", "description": "First transaction which minted some of a specific asset" }, "latest_mint_tx_metadata": { "type": "object", "description": "Metadata of the most recent transaction which minted the asset" }, "mint_tx_count": { "type": "integer", "format": "int64", "description": "Number of transactions which minted some of the asset" }, "token_registry_metadata": { "allOf": [ { "$ref": "#/components/schemas/TokenRegistryMetadata" } ], "nullable": true }, "total_supply": { "type": "integer", "format": "int64", "description": "Total amount of the asset in existence currently", "minimum": 0 } } }, "AssetStandards": { "type": "object", "description": "Asset information corresponding to popular standards", "properties": { "cip25_metadata": { "type": "object", "description": "CIP-25 metadata for a specific asset", "nullable": true }, "cip68_metadata": { "allOf": [ { "$ref": "#/components/schemas/Cip68Metadata" } ], "nullable": true } } }, "AssetTx": { "type": "object", "description": "Transaction which moved or minted a specific asset", "required": [ "tx_hash", "epoch_no", "block_height" ], "properties": { "block_height": { "type": "integer", "format": "int32", "description": "The height of the block which included the transaction" }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch in which the transaction occurred" }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "AssetUtxo": { "type": "object", "description": "UTxO which contains a specific asset", "required": [ "tx_hash", "index", "slot", "address", "amount" ], "properties": { "address": { "type": "string", "description": "Address which controls the UTxO" }, "amount": { "$ref": "#/components/schemas/NumOrString" }, "index": { "type": "integer", "format": "int64", "description": "UTxO transaction index", "minimum": 0 }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of block which produced the UTxO", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" } } }, "AuthCommitteeHotCert": { "type": "object", "description": "Authorizes the constitutional committee hot credential", "required": [ "cert_index", "committee_cold_credential", "committee_hot_credential" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "committee_cold_credential": { "type": "string" }, "committee_hot_credential": { "type": "string" } } }, "Balance": { "type": "object", "description": "Payment credential, the payment part of a Cardano address", "required": [ "lovelace", "assets" ], "properties": { "assets": { "type": "object", "description": "Total amount of different native assets in controlled UTxOs, as a map of minting policy to asset names to amounts", "additionalProperties": { "type": "object", "additionalProperties": { "type": "string" } } }, "lovelace": { "type": "string", "description": "Total amount of lovelace in controlled UTxOs" } } }, "BlockInfo": { "type": "object", "description": "Block information", "required": [ "hash", "height", "absolute_slot", "timestamp", "epoch", "epoch_slot", "confirmations", "tx_hashes", "total_fees", "total_ex_units", "script_invocations", "size", "total_output_lovelace", "era", "protocol_version" ], "properties": { "absolute_slot": { "type": "integer", "format": "int64", "description": "Absolute slot when block was minted", "minimum": 0 }, "block_producer": { "type": "string", "description": "Identifier of stake pool which minted the block", "nullable": true }, "confirmations": { "type": "integer", "format": "int64", "description": "Number of blocks which have been minted since the block", "minimum": 0 }, "epoch": { "type": "integer", "format": "int64", "description": "Epoch in which block was minted", "minimum": 0 }, "epoch_slot": { "type": "integer", "format": "int64", "description": "Epoch slot at which block was minted", "minimum": 0 }, "era": { "$ref": "#/components/schemas/LedgerEra" }, "hash": { "type": "string", "description": "Block hash" }, "height": { "type": "integer", "format": "int64", "description": "Block height (number)", "minimum": 0 }, "next_block": { "type": "string", "description": "Block hash of the next block", "nullable": true }, "operational_certificate": { "allOf": [ { "$ref": "#/components/schemas/OperationalCert" } ], "nullable": true }, "previous_block": { "type": "string", "description": "Block hash of the previous block", "nullable": true }, "protocol_version": { "type": "array", "items": { "allOf": [ { "type": "integer", "format": "int64", "minimum": 0 }, { "type": "integer", "format": "int64", "minimum": 0 } ] }, "description": "Ledger protocol version (major, minor)" }, "script_invocations": { "type": "integer", "format": "int32", "description": "Number of script invocations", "minimum": 0 }, "size": { "type": "integer", "format": "int32", "description": "Size of the block body in bytes", "minimum": 0 }, "timestamp": { "type": "string", "description": "UTC timestamp when the block was minted" }, "total_ex_units": { "$ref": "#/components/schemas/ExUnits" }, "total_fees": { "$ref": "#/components/schemas/NumOrString" }, "total_output_lovelace": { "type": "string", "description": "Total lovelace in outputs of transactions included in the block" }, "tx_hashes": { "type": "array", "items": { "type": "string" }, "description": "Ordered transaction hashes for the transactions in the block" }, "vrf_key": { "type": "string", "description": "Null for Byron", "nullable": true } } }, "Bound": { "type": "object", "required": [ "time", "slot", "epoch" ], "properties": { "epoch": { "type": "integer", "format": "int64" }, "slot": { "type": "integer", "format": "int64" }, "time": { "type": "integer", "format": "int64" } } }, "CertRedeemer": { "type": "object", "required": [ "cert_index", "data", "ex_units" ], "properties": { "cert_index": { "type": "integer", "description": "Position of certificate redeemer attempting to authenticate in sorted certificates", "minimum": 0 }, "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" } } }, "Certificates": { "type": "object", "description": "Certificates found in a transaction", "required": [ "stake_registrations", "stake_deregistrations", "stake_delegations", "pool_registrations", "pool_retirements", "reg_certs", "unreg_certs", "vote_delegations", "stake_vote_delegations", "stake_reg_delegations", "vote_reg_delegations", "stake_vote_reg_delegations", "auth_committee_hot_certs", "resign_committee_cold_certs", "reg_drep_certs", "unreg_drep_certs", "update_drep_certs", "mir_transfers" ], "properties": { "auth_committee_hot_certs": { "type": "array", "items": { "$ref": "#/components/schemas/AuthCommitteeHotCert" } }, "mir_transfers": { "type": "array", "items": { "$ref": "#/components/schemas/MirCert" }, "description": "Instantaneous rewards certificates" }, "pool_registrations": { "type": "array", "items": { "$ref": "#/components/schemas/PoolRegCert" }, "description": "Stake pool registration certificates" }, "pool_retirements": { "type": "array", "items": { "$ref": "#/components/schemas/PoolRetireCert" }, "description": "Stake pool retirement certificates" }, "reg_certs": { "type": "array", "items": { "$ref": "#/components/schemas/RegCert" } }, "reg_drep_certs": { "type": "array", "items": { "$ref": "#/components/schemas/RegDRepCert" } }, "resign_committee_cold_certs": { "type": "array", "items": { "$ref": "#/components/schemas/ResignCommitteeColdCert" } }, "stake_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeDelegCert" }, "description": "Stake key delegation certificates" }, "stake_deregistrations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeRegCert" }, "description": "Stake key deregistration certificates" }, "stake_reg_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeRegDelegCert" } }, "stake_registrations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeRegCert" }, "description": "Stake key registration certificates" }, "stake_vote_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeVoteDelegCert" } }, "stake_vote_reg_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/StakeVoteRegDelegCert" } }, "unreg_certs": { "type": "array", "items": { "$ref": "#/components/schemas/UnRegCert" } }, "unreg_drep_certs": { "type": "array", "items": { "$ref": "#/components/schemas/UnRegDRepCert" } }, "update_drep_certs": { "type": "array", "items": { "$ref": "#/components/schemas/UpdateDRepCert" } }, "vote_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/VoteDelegCert" } }, "vote_reg_delegations": { "type": "array", "items": { "$ref": "#/components/schemas/VoteRegDelegCert" } } } }, "ChainTip": { "type": "object", "description": "Blockchain chain-tip (most recently adopted block)", "required": [ "block_hash", "slot", "height" ], "properties": { "block_hash": { "type": "string", "description": "Block hash of the most recent block" }, "height": { "type": "integer", "format": "int64", "description": "Height (number) of the most recent block", "minimum": 0 }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the most recent block", "minimum": 0 } } }, "Cip68AssetType": { "type": "string", "enum": [ "reference_nft", "user_nft", "user_ft" ] }, "Cip68Metadata": { "type": "object", "required": [ "purpose", "version", "metadata" ], "properties": { "extra": { "type": "string", "description": "Custom user defined Plutus data CBOR bytes", "nullable": true }, "metadata": { "type": "object", "description": "Asset CIP-68 metadata" }, "purpose": { "$ref": "#/components/schemas/Cip68AssetType" }, "version": { "type": "integer", "format": "int64", "description": "CIP-68 version", "minimum": 0 } } }, "ConstitutionalCommittee": { "type": "object", "required": [ "default", "state_of_no_confidence" ], "properties": { "default": { "type": "string" }, "state_of_no_confidence": { "type": "string" } } }, "CurrentEpochInfo": { "type": "object", "description": "Information summary of the current epoch", "required": [ "epoch_no", "fees", "tx_count", "blk_count", "start_time" ], "properties": { "blk_count": { "type": "integer", "format": "int32", "description": "Total blocks in the epoch so far" }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch number" }, "fees": { "type": "string", "description": "Total fees collected in the epoch so far" }, "start_time": { "type": "integer", "format": "int64", "description": "UNIX timestamp when the epoch began" }, "tx_count": { "type": "integer", "format": "int32", "description": "Total transactions in the epoch so far" } } }, "DRep": { "type": "object", "description": "DRep", "required": [ "kind" ], "properties": { "credential": { "allOf": [ { "$ref": "#/components/schemas/DRepCredential" } ], "nullable": true }, "kind": { "$ref": "#/components/schemas/DRepKind" } } }, "DRepCredKind": { "type": "string", "enum": [ "key", "script" ] }, "DRepCredential": { "type": "object", "description": "Payment credential, the payment part of a Cardano address", "required": [ "kind", "bech32", "hex" ], "properties": { "bech32": { "type": "string", "description": "Bech32-encoding of the credential key hash or script hash" }, "hex": { "type": "string", "description": "Hex-encoding of the script or key credential" }, "kind": { "$ref": "#/components/schemas/DRepCredKind" } } }, "DRepKind": { "type": "string", "enum": [ "credential", "abstain", "no_confidence" ] }, "Data": { "type": "object", "required": [ "hash", "value" ], "properties": { "hash": { "type": "string" }, "value": { "type": "object" } } }, "Datum": { "type": "object", "required": [ "bytes" ], "properties": { "bytes": { "type": "string", "description": "Hex encoded datum CBOR bytes" }, "json": { "type": "object", "description": "JSON representation of the datum", "nullable": true } } }, "DatumOption": { "type": "object", "description": "Datum (inline or hash)", "required": [ "type", "hash" ], "properties": { "bytes": { "type": "string", "description": "Hex encoded datum CBOR bytes (null if datum type is hash and corresponding datum bytes have not been seen on-chain)", "nullable": true }, "hash": { "type": "string", "description": "Datum hash" }, "json": { "type": "object", "description": "JSON representation of the datum (null if datum type is hash and corresponding datum bytes have not been seen on-chain)", "nullable": true }, "type": { "$ref": "#/components/schemas/DatumOptionType" } } }, "DatumOptionType": { "type": "string", "description": "Datum type (inline datum or datum hash)", "enum": [ "hash", "inline" ] }, "DelegateRepresentativeDeposit": { "type": "object", "description": "DRep action deposit (introduced in Conway)", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "DelegateRepresentativeVotingThresholds": { "type": "object", "description": "DRep voting thresholds (introduced in Conway)", "required": [ "no_confidence", "constitutional_committee", "constitution", "hard_fork_initiation", "protocol_parameters_update", "treasury_withdrawals" ], "properties": { "constitution": { "type": "string" }, "constitutional_committee": { "$ref": "#/components/schemas/ConstitutionalCommittee" }, "hard_fork_initiation": { "type": "string" }, "no_confidence": { "type": "string" }, "protocol_parameters_update": { "$ref": "#/components/schemas/ProtocolParametersUpdateDRep" }, "treasury_withdrawals": { "type": "string" } } }, "DelegatorInfo": { "type": "object", "description": "Information summary of a delegator", "required": [ "amount" ], "properties": { "active_epoch_no": { "type": "integer", "format": "int64", "description": "Epoch at which the delegation becomes active", "nullable": true }, "amount": { "$ref": "#/components/schemas/NumOrString" }, "latest_delegation_tx_hash": { "type": "string", "description": "Transaction hash relating to the most recent delegation", "nullable": true }, "stake_address": { "type": "string", "description": "Bech32 encoded stake address (reward address)", "nullable": true } } }, "End": { "type": "object", "required": [ "time", "slot", "epoch" ], "properties": { "epoch": { "type": "integer", "format": "int64" }, "slot": { "type": "integer", "format": "int64" }, "time": { "$ref": "#/components/schemas/Time" } } }, "EpochInfo": { "type": "object", "description": "Information summary of an epoch", "required": [ "epoch_no", "fees", "tx_count", "blk_count", "start_time", "end_time" ], "properties": { "active_stake": { "type": "string", "description": "Total active stake for the epoch", "nullable": true }, "average_reward": { "type": "string", "description": "Average reward for block producers during the epoch", "nullable": true }, "blk_count": { "type": "integer", "format": "int32", "description": "Total blocks in the epoch" }, "end_time": { "type": "integer", "format": "int64", "description": "UNIX timestamp when the epoch ended" }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch number" }, "fees": { "type": "string", "description": "Total fees collected in the epoch" }, "start_time": { "type": "integer", "format": "int64", "description": "UNIX timestamp when the epoch began" }, "total_rewards": { "type": "string", "description": "Total rewards earned by block producers during the epoch", "nullable": true }, "tx_count": { "type": "integer", "format": "int32", "description": "Total transactions in the epoch" } } }, "Era": { "type": "object", "required": [ "start", "end", "parameters" ], "properties": { "end": { "$ref": "#/components/schemas/End" }, "parameters": { "$ref": "#/components/schemas/Parameters" }, "start": { "$ref": "#/components/schemas/Start" } } }, "EraParameters": { "type": "object", "required": [ "epoch_length", "slot_length" ], "properties": { "epoch_length": { "type": "integer", "format": "int64" }, "safe_zone": { "type": "integer", "format": "int64", "nullable": true }, "slot_length": { "type": "integer", "format": "int64" } } }, "EraSummaries": { "type": "array", "items": { "$ref": "#/components/schemas/EraSummary" } }, "EraSummary": { "type": "object", "required": [ "start", "parameters" ], "properties": { "end": { "allOf": [ { "$ref": "#/components/schemas/Bound" } ], "nullable": true }, "parameters": { "$ref": "#/components/schemas/EraParameters" }, "start": { "$ref": "#/components/schemas/Bound" } } }, "Eras": { "type": "array", "items": { "$ref": "#/components/schemas/Era" } }, "EvaluateRequest": { "type": "object", "required": [ "cbor" ], "properties": { "additional_utxos": { "type": "array", "items": { "$ref": "#/components/schemas/AdditionalUtxo" }, "nullable": true }, "cbor": { "type": "string", "description": "Transaction CBOR" } } }, "EvaluatedRedeemer": { "type": "object", "description": "Identifier of an evaluated redeemer and the execution units required to execute it", "required": [ "redeemer_tag", "redeemer_index", "ex_units" ], "properties": { "ex_units": { "$ref": "#/components/schemas/ExUnits" }, "redeemer_index": { "type": "integer", "description": "Index for the redeemer tag (which input, policy, etc)", "minimum": 0 }, "redeemer_tag": { "$ref": "#/components/schemas/RedeemerTag" } } }, "ExUnit": { "type": "object", "description": "Execution units for Plutus scripts", "required": [ "memory", "steps" ], "properties": { "memory": { "type": "integer", "format": "int64", "description": "Memory execution units" }, "steps": { "type": "integer", "format": "int64", "description": "CPU execution units" } } }, "ExUnits": { "type": "object", "description": "Execution unit budget for executing a redeemer", "required": [ "mem", "steps" ], "properties": { "mem": { "type": "integer", "format": "int64", "minimum": 0 }, "steps": { "type": "integer", "format": "int64", "minimum": 0 } } }, "GovernanceActionDeposit": { "type": "object", "description": "Governance action deposit (introduced in Conway)", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "HistoricalDelegatorInfo": { "type": "object", "description": "Information summary of a delegator", "properties": { "amount": { "type": "string", "description": "Delegator live stake", "nullable": true }, "stake_address": { "type": "string", "description": "Bech32 encoded stake address (reward address)", "nullable": true } } }, "Holders": { "type": "object", "description": "Number of holders of at least one of a specific asset or assets of a specific policy, by address or address staking part", "required": [ "by_address", "by_account" ], "properties": { "by_account": { "type": "integer", "format": "int64", "description": "Number of unique staking keys used in addresses which control at least one of an asset of the policy ID", "minimum": 0 }, "by_address": { "type": "integer", "format": "int64", "description": "Number of unique addresses which control at least one of an asset of the policy ID", "minimum": 0 } } }, "LastUpdated": { "type": "object", "description": "Details of the most recent block processed by the indexer (aka chain tip); that is, the data returned is correct as of this block in time.", "required": [ "timestamp", "block_hash", "block_slot" ], "properties": { "block_hash": { "type": "string", "description": "Hex-encoded hash of the most recently processed block (aka chain tip)" }, "block_slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the most recently processed block (aka chain tip)", "minimum": 0 }, "timestamp": { "type": "string", "description": "UTC timestamp of when the most recently processed block was minted" } } }, "LedgerEra": { "type": "string", "enum": [ "byron", "shelley", "allegra", "mary", "alonzo", "vasil", "valentine", "conway", "notrecognised" ] }, "MaxBlockBodySize": { "type": "object", "description": "Maximum number of bytes allowed for a block body", "required": [ "bytes" ], "properties": { "bytes": { "type": "integer", "format": "int64", "description": "Maximum number of bytes allowed for a block body" } } }, "MaxBlockHeaderSize": { "type": "object", "description": "Maximum number of bytes allowed for a block header", "required": [ "bytes" ], "properties": { "bytes": { "type": "integer", "format": "int64", "description": "Maximum number of bytes allowed for a block header" } } }, "MaxExecutionUnits": { "type": "object", "description": "Maximum execution units", "required": [ "memory", "cpu" ], "properties": { "cpu": { "type": "integer", "format": "int64", "description": "Maximum execution CPU units" }, "memory": { "type": "integer", "format": "int64", "description": "Maximum execution memory units" } } }, "MaxReferenceScriptsSize": { "type": "object", "description": "Maximum reference script size (introduced in Conway)", "required": [ "bytes" ], "properties": { "bytes": { "type": "integer", "format": "int64" } } }, "MaxTransactionSize": { "type": "object", "description": "Maximum number of bytes allowed for a transaction", "required": [ "bytes" ], "properties": { "bytes": { "type": "integer", "format": "int64", "description": "Maximum number of bytes allowed for a transaction" } } }, "MaxValueSize": { "type": "object", "description": "Maximum value size", "required": [ "bytes" ], "properties": { "bytes": { "type": "integer", "format": "int64", "description": "Maximum value size" } } }, "MinFeeConstant": { "type": "object", "description": "Minimum ADA fee", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "MinFeeReferenceScripts": { "type": "object", "description": "Parameters for reference script fee calculation (introduced in Conway)", "required": [ "base", "range", "multiplier" ], "properties": { "base": { "type": "number", "format": "double" }, "multiplier": { "type": "number", "format": "double" }, "range": { "type": "integer", "format": "int64" } } }, "MinStakePoolCost": { "type": "object", "description": "Minimum stake pool cost", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "MinUtxoDepositConstant": { "type": "object", "description": "Minimum UTxO deposit amount", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "MintAsset": { "type": "object", "description": "Lovelace or native asset", "required": [ "unit", "amount" ], "properties": { "amount": { "$ref": "#/components/schemas/NumOrString" }, "unit": { "type": "string", "description": "Asset (represented as concatenation of hex encoded policy ID and asset name)" } } }, "MintRedeemer": { "type": "object", "required": [ "policy", "data", "ex_units" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" }, "policy": { "type": "string", "description": "Asset policy (hash of script being executed)" } } }, "MintTransaction": { "type": "object", "description": "Transaction hash with details of when that transaction appeared on-chain", "required": [ "tx_hash", "slot", "timestamp", "amount" ], "properties": { "amount": { "type": "string", "description": "Amount of asset minted or burned (negative if burned)" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which includes the transaction", "minimum": 0 }, "timestamp": { "type": "string", "description": "UTC timestamp of the block which includes the transaction" }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "MintingTx": { "type": "object", "description": "Transaction which minted or burned a specific asset", "required": [ "tx_hash", "mint_amount", "block_timestamp", "metadata" ], "properties": { "block_timestamp": { "type": "integer", "format": "int32", "description": "UNIX timestamp of the block which included transaction" }, "metadata": { "type": "object", "description": "Transaction metadata" }, "mint_amount": { "type": "integer", "format": "int64", "description": "Amount of the asset minted or burned (negative if burned)" }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "MirCert": { "type": "object", "description": "Certificate for sending an instantaneous reward (moving funds from treasury or reserves pot to the other pot or to stake accounts)", "required": [ "cert_index", "from", "to" ], "properties": { "accounts": { "type": "array", "items": { "$ref": "#/components/schemas/Withdrawal" }, "description": "List of stake accounts with corresponding reward amounts (null if to is 'reserves' or 'treasury')", "nullable": true }, "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "from": { "$ref": "#/components/schemas/MirSource" }, "other_pot": { "type": "integer", "format": "int64", "description": "Amount transfered to the other pot (null if to is 'accounts')", "nullable": true, "minimum": 0 }, "to": { "$ref": "#/components/schemas/MirTarget" } } }, "MirSource": { "type": "string", "description": "The pot from which an MIR reward is being funded by", "enum": [ "reserves", "treasury" ] }, "MirTarget": { "type": "string", "description": "Where the MIR reward(s) are being sent", "enum": [ "reserves", "treasury", "accounts" ] }, "NetworkId": { "type": "string", "enum": [ "mainnet", "testnet" ] }, "NumOrString": { "oneOf": [ { "type": "integer", "format": "int64", "description": "Unsigned 64-bit integer", "minimum": 0 }, { "type": "integer", "description": "Unsigned 128-bit integer", "minimum": 0 }, { "type": "integer", "format": "int64", "description": "Signed 64-bit integer" }, { "type": "number", "format": "double", "description": "64-bit floating point number" }, { "type": "string", "description": "String representation of an integer or number" } ], "description": "Integer or number by default, or a string representation if the amounts-as-strings header is set to true" }, "OperationalCert": { "type": "object", "required": [ "hot_vkey", "sequence_number", "kes_period", "kes_signature" ], "properties": { "hot_vkey": { "type": "string" }, "kes_period": { "type": "integer", "format": "int64", "minimum": 0 }, "kes_signature": { "type": "string" }, "sequence_number": { "type": "integer", "format": "int64", "minimum": 0 } } }, "PaginatedAccountDelegation": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountDelegation" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAccountHistory": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountHistory" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAccountReward": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountReward" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAccountUpdate": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AccountUpdate" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAddress": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Address" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAddressTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AddressTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAsset": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetHolder": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetHolder" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetHolderAccount": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetHolderAccount" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetInfoConcise": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInfoConcise" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetInfoOld": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInfoOld" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetTx": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetTx" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedAssetUtxo": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AssetUtxo" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedDelegatorInfo": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DelegatorInfo" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedHistoricalDelegatorInfo": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/HistoricalDelegatorInfo" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedMintTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MintTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedMintingTx": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/MintingTx" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPaymentCredentialTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PaymentCredentialTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPaymentCredentialsTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PaymentCredentialsTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPolicyHolder": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyHolder" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPolicyHolderAccount": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyHolderAccount" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPolicyMintTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyMintTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPolicyTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPolicyUtxo": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PolicyUtxo" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPoolBlock": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PoolBlock" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPoolHistory": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PoolHistory" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedPoolListInfo": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PoolListInfo" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedTimestampedTransaction": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TimestampedTransaction" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedUtxoRef": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/UtxoRef" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedUtxoWithBytes": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/UtxoWithBytes" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "PaginatedUtxoWithSlot": { "type": "object", "description": "A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/UtxoWithSlot" }, "description": "Endpoint response data" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" }, "next_cursor": { "type": "string", "description": "Pagination cursor", "nullable": true } } }, "Parameters": { "type": "object", "required": [ "epoch_length", "slot_length", "safe_zone" ], "properties": { "epoch_length": { "type": "integer", "format": "int64" }, "safe_zone": { "type": "integer", "format": "int64" }, "slot_length": { "$ref": "#/components/schemas/SlotLength" } } }, "PaymentCredKind": { "type": "string", "enum": [ "key", "script" ] }, "PaymentCredential": { "type": "object", "description": "Payment credential, the payment part of a Cardano address", "required": [ "kind", "bech32", "hex" ], "properties": { "bech32": { "type": "string", "description": "Bech32-encoding of the credential key hash or script hash" }, "hex": { "type": "string", "description": "Hex-encoding of the script or key credential" }, "kind": { "$ref": "#/components/schemas/PaymentCredKind" } } }, "PaymentCredentialTransaction": { "type": "object", "description": "Transaction which involved a specific payment credential", "required": [ "tx_hash", "slot", "input", "output", "required_signer" ], "properties": { "input": { "type": "boolean", "description": "Payment credential controlled at least one of the consumed UTxOs" }, "output": { "type": "boolean", "description": "Payment credential controlled at least one of the produced UTxOs" }, "required_signer": { "type": "boolean", "description": "Payment credential was an additional required signer" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which contains the transaction", "minimum": 0 }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "PaymentCredentialsTransaction": { "type": "object", "description": "Transaction which involved one or more specific payment credentials", "required": [ "tx_hash", "slot" ], "properties": { "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which contains the transaction", "minimum": 0 }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "PlutusCostModels": { "type": "object", "description": "Plutus script execution cost models", "required": [ "plutus_v1", "plutus_v2" ], "properties": { "plutus_v1": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Plutus script v1 execution cost model" }, "plutus_v2": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Plutus script v2 execution cost model" }, "plutus_v3": { "type": "array", "items": { "type": "integer", "format": "int64" }, "description": "Plutus script v3 execution cost model (introduced in Conway)", "nullable": true } } }, "Pointer": { "type": "object", "required": [ "slot", "tx_index", "cert_index" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "minimum": 0 }, "slot": { "type": "integer", "format": "int64", "minimum": 0 }, "tx_index": { "type": "integer", "format": "int64", "minimum": 0 } } }, "PolicyHolder": { "type": "object", "description": "Holder of assets of a specific policy", "required": [ "address", "assets" ], "properties": { "address": { "type": "string", "description": "Address of the holder" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInPolicy" }, "description": "List of assets owned by the holder belonging to the policy" } } }, "PolicyHolderAccount": { "type": "object", "description": "Account which controls some assets of a specific policy", "required": [ "account", "assets" ], "properties": { "account": { "type": "string", "description": "Address of the holder" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInPolicy" }, "description": "List of assets owned by the holder belonging to the policy" } } }, "PolicyInfo": { "type": "object", "description": "Information about a Cardano native-asset policy ID", "required": [ "policy_id", "script", "assets_of_policy", "total_supply", "unique_holders", "first_mint_tx", "latest_mint_tx" ], "properties": { "assets_of_policy": { "type": "integer", "format": "int64", "description": "Number of unique asset names of the policy ID which have existed", "minimum": 0 }, "first_mint_tx": { "$ref": "#/components/schemas/TimestampedTransaction" }, "latest_mint_tx": { "$ref": "#/components/schemas/TimestampedTransaction" }, "policy_id": { "type": "string", "description": "Hex encoding of the policy ID" }, "script": { "$ref": "#/components/schemas/Script" }, "total_supply": { "type": "string", "description": "Sum of the total supplies of all different assets under the policy ID" }, "unique_holders": { "$ref": "#/components/schemas/Holders" } } }, "PolicyMintTransaction": { "type": "object", "description": "Transaction hash with details of when that transaction appeared on-chain", "required": [ "tx_hash", "slot", "timestamp", "assets" ], "properties": { "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInPolicyMint" }, "description": "Assets of specified policy which were minted or burned in the transaction" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which includes the transaction", "minimum": 0 }, "timestamp": { "type": "string", "description": "UTC timestamp of the block which includes the transaction" }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "PolicyTransaction": { "type": "object", "description": "A transaction which moves assets of a specific policy", "required": [ "tx_hash", "slot", "assets" ], "properties": { "assets": { "type": "array", "items": { "type": "string" }, "description": "List of assets of the policy which were involved in the transaction" }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of block which contained the transaction", "minimum": 0 }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "PolicyUtxo": { "type": "object", "description": "UTxO which contains assets of a specific policy", "required": [ "tx_hash", "index", "slot", "address", "assets" ], "properties": { "address": { "type": "string", "description": "Address which controls the UTxO" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/AssetInPolicy" }, "description": "List of assets contained in the UTxO belonging to the policy" }, "index": { "type": "integer", "description": "UTxO transaction index", "minimum": 0 }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of block which produced the UTxO", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" } } }, "PoolBlock": { "type": "object", "description": "Block created by a stake pool", "required": [ "block_height", "block_hash", "block_time" ], "properties": { "abs_slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block", "nullable": true }, "block_hash": { "type": "string", "description": "Block hash" }, "block_height": { "type": "integer", "format": "int32", "description": "Block height (block number)" }, "block_time": { "type": "integer", "format": "int32", "description": "UNIX timestamp when the block was mined" }, "epoch_no": { "type": "integer", "format": "int32", "description": "Epoch number", "nullable": true }, "epoch_slot": { "type": "integer", "format": "int32", "description": "Epoch slot", "nullable": true } } }, "PoolHistory": { "type": "object", "description": "Per-epoch history of a stake pool", "required": [ "epoch_no", "fixed_cost", "pool_fees", "deleg_rewards", "epoch_ros" ], "properties": { "active_stake": { "allOf": [ { "$ref": "#/components/schemas/NumOrString" } ], "nullable": true }, "active_stake_pct": { "type": "string", "description": "Pool active stake as percentage of total active stake", "nullable": true }, "block_cnt": { "type": "integer", "format": "int64", "description": "Blocks created in the epoch", "nullable": true }, "deleg_rewards": { "$ref": "#/components/schemas/NumOrString" }, "delegator_cnt": { "type": "integer", "format": "int64", "description": "Delegators in the epoch", "nullable": true }, "epoch_no": { "type": "integer", "format": "int64", "description": "Epoch number" }, "epoch_ros": { "type": "string", "description": "Annual return percentage for delegators for the epoch" }, "fixed_cost": { "$ref": "#/components/schemas/NumOrString" }, "margin": { "allOf": [ { "$ref": "#/components/schemas/NumOrString" } ], "nullable": true }, "pool_fees": { "$ref": "#/components/schemas/NumOrString" }, "saturation_pct": { "type": "string", "description": "Pool saturation percent", "nullable": true } } }, "PoolInfo": { "type": "object", "description": "Information summary of a stake pool", "required": [ "pool_id_bech32", "pool_id_hex", "active_epoch_no", "margin", "fixed_cost", "pledge", "owners", "relays", "active_stake", "live_pledge", "live_stake", "live_delegators" ], "properties": { "active_epoch_no": { "type": "integer", "format": "int64", "description": "Epoch when the update takes effect" }, "active_stake": { "$ref": "#/components/schemas/NumOrString" }, "block_count": { "type": "integer", "format": "int64", "description": "Number of blocks created", "nullable": true, "minimum": 0 }, "fixed_cost": { "$ref": "#/components/schemas/NumOrString" }, "live_delegators": { "type": "integer", "format": "int64", "description": "Number of current delegators" }, "live_pledge": { "$ref": "#/components/schemas/NumOrString" }, "live_saturation": { "type": "string", "description": "Live saturation", "nullable": true }, "live_stake": { "$ref": "#/components/schemas/NumOrString" }, "margin": { "$ref": "#/components/schemas/NumOrString" }, "meta_hash": { "type": "string", "description": "Hash of the pool metadata", "nullable": true }, "meta_json": { "allOf": [ { "$ref": "#/components/schemas/PoolMetaJson" } ], "nullable": true }, "meta_url": { "type": "string", "description": "URL pointing to the pool metadata", "nullable": true }, "op_cert": { "type": "string", "description": "Pool operational certificate", "nullable": true }, "op_cert_counter": { "type": "integer", "format": "int64", "description": "Operational certificate counter", "nullable": true }, "owners": { "type": "array", "items": { "type": "string" }, "description": "List of stake keys which control the pool" }, "pledge": { "$ref": "#/components/schemas/NumOrString" }, "pool_id_bech32": { "type": "string", "description": "Bech32 encoded pool ID" }, "pool_id_hex": { "type": "string", "description": "Hex encoded pool ID" }, "pool_status": { "type": "string", "description": "Status of the pool", "nullable": true }, "relays": { "type": "array", "items": { "$ref": "#/components/schemas/Relay" }, "description": "Relays declared by the pool" }, "retiring_epoch": { "type": "integer", "format": "int32", "description": "Epoch at which the pool will be retired", "nullable": true }, "reward_addr": { "type": "string", "description": "Reward address associated with the pool", "nullable": true }, "sigma": { "type": "string", "description": "Pool stake share", "nullable": true }, "vrf_key_hash": { "type": "string", "description": "VRF key hash", "nullable": true } } }, "PoolListInfo": { "type": "object", "description": "Stake pool identifier", "required": [ "pool_id_bech32" ], "properties": { "pool_id_bech32": { "type": "string", "description": "Bech32 encoded pool ID" }, "ticker": { "type": "string", "description": "Pool ticker symbol", "nullable": true } } }, "PoolMetaJson": { "type": "object", "description": "JSON metadata associated with a stake pool", "required": [ "name" ], "properties": { "description": { "type": "string", "description": "Pool description", "nullable": true }, "homepage": { "type": "string", "description": "Pool home page URL", "nullable": true }, "name": { "type": "string", "description": "Pool name" }, "ticker": { "type": "string", "description": "Pool ticker symbol", "nullable": true } } }, "PoolMetadata": { "type": "object", "description": "Metadata associated with a stake pool", "required": [ "pool_id_bech32" ], "properties": { "meta_hash": { "type": "string", "description": "Hash of the pool metadata", "nullable": true }, "meta_json": { "allOf": [ { "$ref": "#/components/schemas/PoolMetaJson" } ], "nullable": true }, "meta_url": { "type": "string", "description": "URL pointing to the pool metadata", "nullable": true }, "pool_id_bech32": { "type": "string", "description": "Bech32 encoded pool ID" } } }, "PoolRegCert": { "type": "object", "description": "Certificate for registering or updating a stake pool", "required": [ "cert_index", "pool_id", "from_epoch", "vrf_key_hash", "margin", "fixed_cost", "pledge", "reward_address", "owner_addresses", "relays" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "fixed_cost": { "$ref": "#/components/schemas/NumOrString" }, "from_epoch": { "type": "integer", "format": "int64", "description": "Epoch at which the update will become active", "minimum": 0 }, "margin": { "$ref": "#/components/schemas/NumOrString" }, "metadata_hash": { "type": "string", "description": "Hash of metadata that the metadata URL should point to", "nullable": true }, "metadata_url": { "type": "string", "description": "URL pointing to pool metadata declared by the stake pool", "nullable": true }, "owner_addresses": { "type": "array", "items": { "type": "string" }, "description": "Stake addresses which control the stake pool" }, "pledge": { "$ref": "#/components/schemas/NumOrString" }, "pool_id": { "type": "string", "description": "Pool ID of the stake pool being updated" }, "relays": { "type": "array", "items": { "$ref": "#/components/schemas/Relay" }, "description": "Relays declared by the stake pool" }, "reward_address": { "type": "string", "description": "Stake address which will receive rewards from the stake pool" }, "vrf_key_hash": { "type": "string", "description": "VRF key hash of the stake pool" } } }, "PoolRelay": { "type": "object", "description": "Relay declared by a stake pool", "required": [ "pool_id_bech32", "relays" ], "properties": { "pool_id_bech32": { "type": "string", "description": "Bech32 encoded pool ID" }, "relays": { "type": "array", "items": { "$ref": "#/components/schemas/Relay" }, "description": "Relays declared by the pool" } } }, "PoolRelays": { "type": "array", "items": { "$ref": "#/components/schemas/PoolRelay" }, "description": "A list of stake pool relays declared on-chain" }, "PoolRetireCert": { "type": "object", "description": "Certificate for retiring a stake pool", "required": [ "cert_index", "pool_id", "after_epoch" ], "properties": { "after_epoch": { "type": "integer", "format": "int32", "description": "Pool will be retired at the end of this epoch", "minimum": 0 }, "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "pool_id": { "type": "string", "description": "Bech32 pool ID of the pool being retired" } } }, "PoolUpdate": { "type": "object", "description": "Update to a stake pool", "required": [ "tx_hash", "pool_id_bech32", "pool_id_hex", "margin", "fixed_cost", "pledge" ], "properties": { "active_epoch_no": { "type": "integer", "format": "int64", "description": "Epoch when the update takes effect", "nullable": true }, "block_time": { "type": "integer", "format": "int32", "description": "UNIX timestamp of the block containing the transaction", "nullable": true }, "fixed_cost": { "$ref": "#/components/schemas/NumOrString" }, "margin": { "$ref": "#/components/schemas/NumOrString" }, "meta_hash": { "type": "string", "description": "Hash of the pool metadata", "nullable": true }, "meta_json": { "allOf": [ { "$ref": "#/components/schemas/PoolMetaJson" } ], "nullable": true }, "meta_url": { "type": "string", "description": "URL pointing to the pool metadata", "nullable": true }, "owners": { "type": "array", "items": { "type": "string" }, "description": "List of stake keys which control the pool", "nullable": true }, "pledge": { "$ref": "#/components/schemas/NumOrString" }, "pool_id_bech32": { "type": "string", "description": "Bech32 encoded pool ID" }, "pool_id_hex": { "type": "string", "description": "Hex encoded pool ID" }, "pool_status": { "type": "string", "description": "Status of the pool", "nullable": true }, "relays": { "type": "array", "items": { "$ref": "#/components/schemas/Relay" }, "description": "Relays declared by the pool", "nullable": true }, "retiring_epoch": { "type": "integer", "format": "int32", "description": "Epoch at which the pool will be retired", "nullable": true }, "reward_addr": { "type": "string", "description": "Reward address associated with the pool", "nullable": true }, "tx_hash": { "type": "string", "description": "Transaction hash for the transaction which contained the update" }, "vrf_key_hash": { "type": "string", "description": "VRF key hash", "nullable": true } } }, "PoolUpdates": { "type": "array", "items": { "$ref": "#/components/schemas/PoolUpdate" }, "description": "List of updates to a stake pool" }, "Prices": { "type": "object", "required": [ "memory", "steps" ], "properties": { "memory": { "type": "string" }, "steps": { "type": "string" } } }, "ProposalRedeemer": { "type": "object", "required": [ "proposal_index", "data", "ex_units" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" }, "proposal_index": { "type": "integer", "description": "Index of the relevant proposal", "minimum": 0 } } }, "ProtocolParametersUpdateDRep": { "type": "object", "required": [ "network", "economic", "technical", "governance" ], "properties": { "economic": { "type": "string" }, "governance": { "type": "string" }, "network": { "type": "string" }, "technical": { "type": "string" } } }, "ProtocolParametersUpdateStakePool": { "type": "object", "required": [ "security" ], "properties": { "security": { "type": "string" } } }, "ProtocolParametersV5": { "type": "object", "required": [ "min_fee_coefficient", "min_fee_constant", "max_block_body_size", "max_block_header_size", "max_tx_size", "stake_key_deposit", "pool_deposit", "pool_retirement_epoch_bound", "desired_number_of_pools", "pool_influence", "monetary_expansion", "treasury_expansion", "protocol_version", "min_pool_cost", "coins_per_utxo_byte", "cost_models", "prices", "max_execution_units_per_transaction", "max_execution_units_per_block", "max_value_size", "collateral_percentage", "max_collateral_inputs" ], "properties": { "coins_per_utxo_byte": { "type": "integer", "format": "int64" }, "collateral_percentage": { "type": "integer", "format": "int64" }, "cost_models": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "type": "integer", "format": "int64" } } }, "desired_number_of_pools": { "type": "integer", "format": "int64" }, "max_block_body_size": { "type": "integer", "format": "int64" }, "max_block_header_size": { "type": "integer", "format": "int64" }, "max_collateral_inputs": { "type": "integer", "format": "int64" }, "max_execution_units_per_block": { "$ref": "#/components/schemas/ExUnit" }, "max_execution_units_per_transaction": { "$ref": "#/components/schemas/ExUnit" }, "max_tx_size": { "type": "integer", "format": "int64" }, "max_value_size": { "type": "integer", "format": "int64" }, "min_fee_coefficient": { "type": "integer", "format": "int64" }, "min_fee_constant": { "type": "integer", "format": "int64" }, "min_pool_cost": { "type": "integer", "format": "int64" }, "monetary_expansion": { "type": "string" }, "pool_deposit": { "type": "integer", "format": "int64" }, "pool_influence": { "type": "string" }, "pool_retirement_epoch_bound": { "type": "integer", "format": "int64" }, "prices": { "$ref": "#/components/schemas/Prices" }, "protocol_version": { "$ref": "#/components/schemas/Version" }, "stake_key_deposit": { "type": "integer", "format": "int64" }, "treasury_expansion": { "type": "string" } } }, "ProtocolParametersV6": { "type": "object", "required": [ "min_fee_coefficient", "min_fee_constant", "max_block_body_size", "max_block_header_size", "max_transaction_size", "stake_credential_deposit", "stake_pool_deposit", "stake_pool_retirement_epoch_bound", "desired_number_of_stake_pools", "stake_pool_pledge_influence", "monetary_expansion", "treasury_expansion", "min_stake_pool_cost", "min_utxo_deposit_constant", "min_utxo_deposit_coefficient", "plutus_cost_models", "script_execution_prices", "max_execution_units_per_transaction", "max_execution_units_per_block", "max_value_size", "collateral_percentage", "max_collateral_inputs", "version" ], "properties": { "collateral_percentage": { "type": "integer", "format": "int64" }, "constitutional_committee_max_term_length": { "type": "integer", "format": "int64", "nullable": true }, "constitutional_committee_min_size": { "type": "integer", "format": "int64", "nullable": true }, "delegate_representative_deposit": { "allOf": [ { "$ref": "#/components/schemas/DelegateRepresentativeDeposit" } ], "nullable": true }, "delegate_representative_max_idle_time": { "type": "integer", "format": "int64", "nullable": true }, "delegate_representative_voting_thresholds": { "allOf": [ { "$ref": "#/components/schemas/DelegateRepresentativeVotingThresholds" } ], "nullable": true }, "desired_number_of_stake_pools": { "type": "integer", "format": "int64" }, "governance_action_deposit": { "allOf": [ { "$ref": "#/components/schemas/GovernanceActionDeposit" } ], "nullable": true }, "governance_action_lifetime": { "type": "integer", "format": "int64", "nullable": true }, "max_block_body_size": { "$ref": "#/components/schemas/MaxBlockBodySize" }, "max_block_header_size": { "$ref": "#/components/schemas/MaxBlockHeaderSize" }, "max_collateral_inputs": { "type": "integer", "format": "int64" }, "max_execution_units_per_block": { "$ref": "#/components/schemas/MaxExecutionUnits" }, "max_execution_units_per_transaction": { "$ref": "#/components/schemas/MaxExecutionUnits" }, "max_reference_scripts_size": { "allOf": [ { "$ref": "#/components/schemas/MaxReferenceScriptsSize" } ], "nullable": true }, "max_transaction_size": { "$ref": "#/components/schemas/MaxTransactionSize" }, "max_value_size": { "$ref": "#/components/schemas/MaxValueSize" }, "min_fee_coefficient": { "type": "integer", "format": "int64" }, "min_fee_constant": { "$ref": "#/components/schemas/MinFeeConstant" }, "min_fee_reference_scripts": { "allOf": [ { "$ref": "#/components/schemas/MinFeeReferenceScripts" } ], "nullable": true }, "min_stake_pool_cost": { "$ref": "#/components/schemas/MinStakePoolCost" }, "min_utxo_deposit_coefficient": { "type": "integer", "format": "int64" }, "min_utxo_deposit_constant": { "$ref": "#/components/schemas/MinUtxoDepositConstant" }, "monetary_expansion": { "type": "string" }, "plutus_cost_models": { "$ref": "#/components/schemas/PlutusCostModels" }, "script_execution_prices": { "$ref": "#/components/schemas/ScriptExecutionPrices" }, "stake_credential_deposit": { "$ref": "#/components/schemas/StakeDeposit" }, "stake_pool_deposit": { "$ref": "#/components/schemas/StakeDeposit" }, "stake_pool_pledge_influence": { "type": "string" }, "stake_pool_retirement_epoch_bound": { "type": "integer", "format": "int64" }, "stake_pool_voting_thresholds": { "allOf": [ { "$ref": "#/components/schemas/StakePoolVotingThresholds" } ], "nullable": true }, "treasury_expansion": { "type": "string" }, "version": { "$ref": "#/components/schemas/Version" } } }, "RedeemerTag": { "type": "string", "description": "Redeemer tag", "enum": [ "spend", "mint", "cert", "wdrl", "vote", "propose" ] }, "Redeemers": { "type": "object", "required": [ "spends", "mints", "withdrawals", "certificates", "votes", "proposals" ], "properties": { "certificates": { "type": "array", "items": { "$ref": "#/components/schemas/CertRedeemer" }, "description": "Redeemers attempting to delegate or deregister a script-controlled stake account" }, "mints": { "type": "array", "items": { "$ref": "#/components/schemas/MintRedeemer" }, "description": "Redeemers attempting to mint assets of a script-controlled policy ID" }, "proposals": { "type": "array", "items": { "$ref": "#/components/schemas/ProposalRedeemer" }, "description": "Redeemers attempting to submit a proposal" }, "spends": { "type": "array", "items": { "$ref": "#/components/schemas/SpendRedeemer" }, "description": "Redeemers attempting to spend a UTxO locked at a script" }, "votes": { "type": "array", "items": { "$ref": "#/components/schemas/VoteRedeemer" }, "description": "Redeemers attempting to cast a vote for a script-controlled stake account" }, "withdrawals": { "type": "array", "items": { "$ref": "#/components/schemas/WdrlRedeemer" }, "description": "Redeemers attempting to withdraw rewards for a script-controlled stake account" } } }, "RegCert": { "type": "object", "description": "Registers stake credentials", "required": [ "cert_index", "stake_address", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Stake registration deposit" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "RegDRepCert": { "type": "object", "description": "Registers DRep's credentials", "required": [ "cert_index", "drep_credential", "deposit" ], "properties": { "anchor": { "allOf": [ { "$ref": "#/components/schemas/Anchor" } ], "nullable": true }, "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Registration deposit" }, "drep_credential": { "$ref": "#/components/schemas/DRepCredential" } } }, "Relay": { "type": "object", "description": "Stake pool relay", "properties": { "dns": { "type": "string", "nullable": true }, "ipv4": { "type": "string", "nullable": true }, "ipv6": { "type": "string", "nullable": true }, "port": { "type": "integer", "format": "int32", "nullable": true }, "srv": { "type": "string", "nullable": true } } }, "ResignCommitteeColdCert": { "type": "object", "description": "Authorizes the constitutional committee hot credential", "required": [ "cert_index", "committee_cold_credential" ], "properties": { "anchor": { "allOf": [ { "$ref": "#/components/schemas/Anchor" } ], "nullable": true }, "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "committee_cold_credential": { "type": "string" } } }, "Script": { "type": "object", "description": "Details of a Native or Plutus script", "required": [ "hash", "type", "bytes" ], "properties": { "bytes": { "type": "string", "description": "Script bytes" }, "hash": { "type": "string", "description": "Script hash" }, "json": { "type": "object", "description": "JSON representation of script (null if script not of native type)", "nullable": true }, "type": { "$ref": "#/components/schemas/ScriptType" } } }, "ScriptExecutionPrices": { "type": "object", "description": "Script execution prices", "required": [ "memory", "cpu" ], "properties": { "cpu": { "type": "string", "description": "Script execution CPU price" }, "memory": { "type": "string", "description": "Script execution memory price" } } }, "ScriptFirstSeen": { "type": "object", "description": "Details of a Native or Plutus script", "required": [ "hash", "type", "bytes", "first_seen" ], "properties": { "bytes": { "type": "string", "description": "Script bytes" }, "first_seen": { "$ref": "#/components/schemas/TimestampedTransaction" }, "hash": { "type": "string", "description": "Script hash" }, "json": { "type": "object", "description": "JSON representation of script (null if script not of native type)", "nullable": true }, "type": { "$ref": "#/components/schemas/ScriptType" } } }, "ScriptType": { "type": "string", "description": "Script type and version", "enum": [ "native", "plutusv1", "plutusv2", "plutusv3" ] }, "SlotLength": { "type": "object", "required": [ "milliseconds" ], "properties": { "milliseconds": { "type": "integer", "format": "int64" } } }, "SpendRedeemer": { "type": "object", "required": [ "script_hash", "input", "input_index", "data", "ex_units" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" }, "input": { "type": "object", "description": "UTxO reference (transaction hash and output index)", "required": [ "tx_hash", "index" ], "properties": { "index": { "type": "integer", "format": "int64", "description": "UTxO transaction index", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" } } }, "input_index": { "type": "integer", "description": "Position of input within the lexicographically sorted transaction inputs", "minimum": 0 }, "script_hash": { "type": "string", "description": "Script being executed" } } }, "StakeDelegCert": { "type": "object", "description": "Certificate for stake key delegation", "required": [ "cert_index", "stake_address", "pool_id" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "pool_id": { "type": "string", "description": "Pool ID of the stake pool the stake key is delegating to" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being delegated" } } }, "StakeDeposit": { "type": "object", "description": "Stake deposit amount", "required": [ "ada" ], "properties": { "ada": { "$ref": "#/components/schemas/Ada" } } }, "StakePoolVotingThresholds": { "type": "object", "description": "Stake pool voting thresholds (introduced in Conway)", "required": [ "no_confidence", "constitutional_committee", "hard_fork_initiation", "protocol_parameters_update" ], "properties": { "constitutional_committee": { "$ref": "#/components/schemas/ConstitutionalCommittee" }, "hard_fork_initiation": { "type": "string" }, "no_confidence": { "type": "string" }, "protocol_parameters_update": { "$ref": "#/components/schemas/ProtocolParametersUpdateStakePool" } } }, "StakeRegCert": { "type": "object", "description": "Certificate for registering a stake key", "required": [ "cert_index", "stake_address" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "StakeRegDelegCert": { "type": "object", "description": "Registers stake credentials and delegates to a stake pool", "required": [ "cert_index", "stake_address", "pool_id", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Stake registration deposit" }, "pool_id": { "type": "string", "description": "Pool ID of the stake pool the stake key is delegating to" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "StakeVoteDelegCert": { "type": "object", "description": "Delegates to a stake pool and a DRep from the same certificate", "required": [ "cert_index", "stake_address", "pool_id", "drep" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "drep": { "$ref": "#/components/schemas/DRep" }, "pool_id": { "type": "string", "description": "Pool ID of the stake pool the stake key is delegating to" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "StakeVoteRegDelegCert": { "type": "object", "description": "Registers stake credentials, delegates to a pool, and to a DRep", "required": [ "cert_index", "stake_address", "pool_id", "drep", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Stake registration deposit" }, "drep": { "$ref": "#/components/schemas/DRep" }, "pool_id": { "type": "string", "description": "Pool ID of the stake pool the stake key is delegating to" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "StakingCredKind": { "type": "string", "enum": [ "key", "script", "pointer" ] }, "StakingCredential": { "type": "object", "description": "Staking credential, the delegation part of a Cardano address", "required": [ "kind" ], "properties": { "bech32": { "type": "string", "description": "Bech32-encoding of the credential key hash or script hash", "nullable": true }, "hex": { "type": "string", "nullable": true }, "kind": { "$ref": "#/components/schemas/StakingCredKind" }, "pointer": { "allOf": [ { "$ref": "#/components/schemas/Pointer" } ], "nullable": true }, "reward_address": { "type": "string", "nullable": true } } }, "Start": { "type": "object", "required": [ "time", "slot", "epoch" ], "properties": { "epoch": { "type": "integer", "format": "int64" }, "slot": { "type": "integer", "format": "int64" }, "time": { "$ref": "#/components/schemas/Time" } } }, "SystemStart": { "type": "string" }, "Time": { "type": "object", "required": [ "seconds" ], "properties": { "seconds": { "type": "integer", "format": "int64" } } }, "TimestampedAccountInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/AccountInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedAddress": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Address" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedAssetInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/AssetInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedBalance": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Balance" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedBlockInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/BlockInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedChainTip": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/ChainTip" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedCurrentEpochInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/CurrentEpochInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedDatum": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedDatumMap": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "type": "object", "description": "Endpoint response data", "additionalProperties": { "$ref": "#/components/schemas/Datum" } }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedEpochInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/EpochInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedEraSummaries": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Eras" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedPolicyInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/PolicyInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedPoolInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/PoolInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedPoolMetadata": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/PoolMetadata" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedPoolRelays": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/PoolRelays" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedPoolUpdates": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/PoolUpdates" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedProtocolParameters": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/ProtocolParametersV6" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedProtocolParametersLegacy": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/ProtocolParametersV5" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedScript": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Script" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedScriptFirstSeen": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/ScriptFirstSeen" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedSystemStart": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/SystemStart" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedTransaction": { "type": "object", "description": "Transaction hash with details of when that transaction appeared on-chain", "required": [ "tx_hash", "slot", "timestamp" ], "properties": { "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which includes the transaction", "minimum": 0 }, "timestamp": { "type": "string", "description": "UTC timestamp of the block which includes the transaction" }, "tx_hash": { "type": "string", "description": "Transaction hash" } } }, "TimestampedTransactionInfo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/TransactionInfo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedTxCbor": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/TxCbor" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedTxCount": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/TxCount" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TimestampedUtxo": { "type": "object", "description": "Timestamped response. Returns the endpoint response data along with the chain-tip of the indexer, which details at which point in the chain's history the data was correct as-of.", "required": [ "data", "last_updated" ], "properties": { "data": { "$ref": "#/components/schemas/Utxo" }, "last_updated": { "$ref": "#/components/schemas/LastUpdated" } } }, "TokenRegistryMetadata": { "type": "object", "description": "Token registry metadata", "required": [ "name", "description" ], "properties": { "decimals": { "type": "integer", "format": "int64", "description": "Recommended value for decimal places", "nullable": true }, "description": { "type": "string", "description": "Asset description" }, "logo": { "type": "string", "description": "Base64 encoded logo PNG associated with the asset", "nullable": true }, "name": { "type": "string", "description": "Asset name" }, "ticker": { "type": "string", "description": "Asset ticker", "nullable": true }, "url": { "type": "string", "description": "URL associated with the asset", "nullable": true } } }, "TransactionInfo": { "type": "object", "description": "Transaction Information", "required": [ "tx_hash", "block_hash", "block_tx_index", "block_height", "block_timestamp", "block_absolute_slot", "block_epoch", "inputs", "outputs", "reference_inputs", "collateral_inputs", "mint", "fee", "deposit", "certificates", "withdrawals", "additional_signers", "scripts_executed", "scripts_successful", "redeemers", "size" ], "properties": { "additional_signers": { "type": "array", "items": { "type": "string" }, "description": "Additional required signers" }, "block_absolute_slot": { "type": "integer", "format": "int64", "description": "Absolute slot of the block which includes the transaction", "minimum": 0 }, "block_epoch": { "type": "integer", "format": "int64", "description": "Epoch in which the block was minted in", "minimum": 0 }, "block_hash": { "type": "string", "description": "Hash of the block which includes the transaction" }, "block_height": { "type": "integer", "format": "int64", "description": "Block height (number) of the block which includes the transaction", "minimum": 0 }, "block_timestamp": { "type": "integer", "format": "int64", "description": "UNIX timestamp of the block which includes the transaction", "minimum": 0 }, "block_tx_index": { "type": "integer", "format": "int32", "description": "The transaction's position within the block which includes it", "minimum": 0 }, "certificates": { "$ref": "#/components/schemas/Certificates" }, "collateral_inputs": { "type": "array", "items": { "$ref": "#/components/schemas/Utxo" }, "description": "Collateral inputs, to be taken if Plutus scripts are not successful" }, "collateral_return": { "allOf": [ { "$ref": "#/components/schemas/Utxo" } ], "nullable": true }, "deposit": { "type": "integer", "format": "int64", "description": "The amount of lovelace used for deposits (negative if being returned)" }, "fee": { "type": "integer", "format": "int64", "description": "The fee specified in the transaction", "minimum": 0 }, "inputs": { "type": "array", "items": { "$ref": "#/components/schemas/Utxo" }, "description": "Transaction inputs (lexicographically sorted)" }, "invalid_before": { "type": "integer", "format": "int64", "description": "The slot before which the transaction would not be accepted onto the chain", "nullable": true, "minimum": 0 }, "invalid_hereafter": { "type": "integer", "format": "int64", "description": "The slot from which the transaction would not be accepted onto the chain", "nullable": true, "minimum": 0 }, "metadata": { "type": "object", "description": "Transaction metadata JSON", "nullable": true }, "mint": { "type": "array", "items": { "$ref": "#/components/schemas/MintAsset" }, "description": "Native assets minted or burned by the transaction" }, "outputs": { "type": "array", "items": { "$ref": "#/components/schemas/Utxo" }, "description": "Transaction outputs" }, "redeemers": { "$ref": "#/components/schemas/Redeemers" }, "reference_inputs": { "type": "array", "items": { "$ref": "#/components/schemas/Utxo" }, "description": "Reference inputs" }, "scripts_executed": { "type": "array", "items": { "$ref": "#/components/schemas/Script" }, "description": "Native and Plutus scripts which were executed while processing the transaction" }, "scripts_successful": { "type": "boolean", "description": "False if any executed Plutus scripts failed (aka phase-two validity), meaning collateral was processed." }, "size": { "type": "integer", "format": "int64", "description": "Size of the transaction in bytes", "minimum": 0 }, "tx_hash": { "type": "string", "description": "Transaction hash (identifier)" }, "withdrawals": { "type": "array", "items": { "$ref": "#/components/schemas/Withdrawal" }, "description": "Stake account withdrawals" } } }, "TxCbor": { "type": "string", "description": "Hex encoded transaction CBOR bytes" }, "TxCount": { "type": "integer", "format": "int64", "description": "Number of transactions", "minimum": 0 }, "TxStatus": { "type": "string", "enum": [ "Failed", "Onchain", "Pending", "Rejected", "Rolledback" ] }, "TxStatusInfo": { "type": "object", "required": [ "tx_hash", "tx_status" ], "properties": { "tx_hash": { "type": "string" }, "tx_status": { "$ref": "#/components/schemas/TxStatus" } } }, "UnRegCert": { "type": "object", "description": "Unregisters stake credentials", "required": [ "cert_index", "stake_address", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Stake registration deposit to be returned" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "UnRegDRepCert": { "type": "object", "description": "Unregisters (retires) DRep's credentials", "required": [ "cert_index", "drep_credential", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Registration deposit to be returned" }, "drep_credential": { "$ref": "#/components/schemas/DRepCredential" } } }, "UpdateDRepCert": { "type": "object", "description": "Unregisters (retires) DRep's credentials", "required": [ "cert_index", "drep_credential" ], "properties": { "anchor": { "allOf": [ { "$ref": "#/components/schemas/Anchor" } ], "nullable": true }, "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "drep_credential": { "$ref": "#/components/schemas/DRepCredential" } } }, "Utxo": { "type": "object", "description": "Transaction output", "required": [ "tx_hash", "index", "assets", "address" ], "properties": { "address": { "type": "string", "description": "Address which controls the UTxO" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" }, "description": "List of assets contained in the UTxO" }, "datum": { "allOf": [ { "$ref": "#/components/schemas/DatumOption" } ], "nullable": true }, "index": { "type": "integer", "format": "int64", "description": "UTxO transaction index", "minimum": 0 }, "reference_script": { "allOf": [ { "$ref": "#/components/schemas/Script" } ], "nullable": true }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" } } }, "UtxoRef": { "type": "object", "description": "UTxO reference (transaction hash and output index)", "required": [ "tx_hash", "index" ], "properties": { "index": { "type": "integer", "format": "int64", "description": "UTxO transaction index", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" } } }, "UtxoWithBytes": { "type": "object", "description": "Transaction output (with field for optionally-returned CBOR bytes)", "required": [ "tx_hash", "index", "assets", "address" ], "properties": { "address": { "type": "string", "description": "Address which controls the UTxO" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" }, "description": "List of assets contained in the UTxO" }, "datum": { "allOf": [ { "$ref": "#/components/schemas/DatumOption" } ], "nullable": true }, "index": { "type": "integer", "description": "UTxO transaction index", "minimum": 0 }, "reference_script": { "allOf": [ { "$ref": "#/components/schemas/Script" } ], "nullable": true }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" }, "txout_cbor": { "type": "string", "description": "Hex encoded transaction output CBOR bytes", "nullable": true } } }, "UtxoWithSlot": { "type": "object", "description": "Transaction output", "required": [ "tx_hash", "index", "slot", "assets", "address" ], "properties": { "address": { "type": "string", "description": "Address which controls the UTxO" }, "assets": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" }, "description": "List of assets contained in the UTxO" }, "datum": { "allOf": [ { "$ref": "#/components/schemas/DatumOption" } ], "nullable": true }, "index": { "type": "integer", "description": "UTxO transaction index", "minimum": 0 }, "reference_script": { "allOf": [ { "$ref": "#/components/schemas/Script" } ], "nullable": true }, "slot": { "type": "integer", "format": "int64", "description": "Absolute slot of block which produced the UTxO", "minimum": 0 }, "tx_hash": { "type": "string", "description": "UTxO transaction hash" }, "txout_cbor": { "type": "string", "description": "Hex encoded transaction output CBOR bytes", "nullable": true } } }, "Version": { "type": "object", "required": [ "major", "minor" ], "properties": { "major": { "type": "integer", "format": "int32" }, "minor": { "type": "integer", "format": "int32" } } }, "VoteDelegCert": { "type": "object", "description": "Delegates votes", "required": [ "cert_index", "stake_address", "drep" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "drep": { "$ref": "#/components/schemas/DRep" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "VoteRedeemer": { "type": "object", "required": [ "vote_index", "data", "ex_units" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" }, "vote_index": { "type": "integer", "description": "Index of relevant vote in sorted votes", "minimum": 0 } } }, "VoteRegDelegCert": { "type": "object", "description": "Registers stake credentials and delegates to a DRep", "required": [ "cert_index", "stake_address", "drep", "deposit" ], "properties": { "cert_index": { "type": "integer", "format": "int64", "description": "Index of the certificate in the transaction", "minimum": 0 }, "deposit": { "type": "string", "description": "Stake registration deposit" }, "drep": { "$ref": "#/components/schemas/DRep" }, "stake_address": { "type": "string", "description": "Stake address corresponding to stake key being updated" } } }, "WdrlRedeemer": { "type": "object", "required": [ "stake_address", "data", "ex_units" ], "properties": { "data": { "$ref": "#/components/schemas/Datum" }, "ex_units": { "type": "array", "items": { "type": "integer", "format": "int64", "minimum": 0 }, "description": "Execution unit budget (memory, steps)" }, "stake_address": { "type": "string", "description": "Stake account that the redeemer is attempting to withdraw rewards from" } } }, "Withdrawal": { "type": "object", "required": [ "stake_address", "amount" ], "properties": { "amount": { "$ref": "#/components/schemas/NumOrString" }, "stake_address": { "type": "string" } } } }, "securitySchemes": { "api-key": { "type": "apiKey", "in": "header", "name": "api-key", "description": "Project API Key" } } }, "security": [ { "api-key": [] } ], "tags": [ { "name": "Maestro" } ] }