From 2f5239ddcf3d94469e763d99eec8d2ed621c6728 Mon Sep 17 00:00:00 2001 From: slowbackspace Date: Tue, 17 Sep 2024 17:20:11 +0200 Subject: [PATCH 1/2] feat: blockbook btc integration --- blockbook.yaml | 952 +++++++++++++ blockfrost-openapi.yaml | 33 + docs/blockfrost-openapi.yaml | 1059 ++++++++++++++ docs/midnight/index.html | 280 ++-- json-schema.json | 2 +- openapi-merge.json | 12 + openapi.json | 1261 ++++++++++++++++- openapi.yaml | 1059 ++++++++++++++ package.json | 2 +- src/definitions.yaml | 33 + src/generated-types.ts | 1039 -------------- .../get-schema-for-endpoint.test.ts.snap | 520 +++++++ 12 files changed, 5070 insertions(+), 1182 deletions(-) create mode 100644 blockbook.yaml diff --git a/blockbook.yaml b/blockbook.yaml new file mode 100644 index 00000000..5d54e30c --- /dev/null +++ b/blockbook.yaml @@ -0,0 +1,952 @@ +openapi: 3.0.0 +info: + version: 0.4.0 + title: Blockfrost.io ~ Blockbook API documentation + x-logo: + url: https://staging.blockfrost.io/images/logo.svg + altText: Blockfrost + contact: + name: Blockfrost Team + url: "https://blockfrost.io" + email: contact@blockfrost.io + license: + name: MIT + url: "https://opensource.org/licenses/MIT" + termsOfService: "https://blockfrost.io/terms" +servers: + - url: https://bitcoin-mainnet.blockfrost.io + description: Bitcoin mainnet network + - url: https://litecoin-mainnet.blockfrost.io + description: Litecoin mainnet network + - url: https://dogecoin-mainnet.blockfrost.io + description: Dogecoin mainnet network +security: + - project_id: [] + +paths: + "/status": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + get: + tags: + - Bitcoin + - Litecoin + - Dogecoin + summary: Blockchain status + operationId: getStatus + description: Get current status of Blockbook and its backend + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + blockbook: + type: object + properties: + coin: + type: string + network: + type: string + host: + type: string + version: + type: string + gitCommit: + type: string + buildTime: + type: string + syncMode: + type: boolean + initialSync: + type: boolean + inSync: + type: boolean + bestHeight: + type: integer + lastBlockTime: + type: string + inSyncMempool: + type: boolean + lastMempoolTime: + type: string + mempoolSize: + type: integer + decimals: + type: integer + dbSize: + type: integer + hasFiatRates: + type: boolean + currentFiatRatesTime: + type: string + historicalFiatRatesTime: + type: string + about: + type: string + backend: + type: object + properties: + chain: + type: string + blocks: + type: integer + headers: + type: integer + bestBlockHash: + type: string + difficulty: + type: string + sizeOnDisk: + type: integer + version: + type: string + subversion: + type: string + protocolVersion: + type: string + x-examples: + Example 1: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: "2023-02-27T02:40:48+00:00" + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: "2023-04-07T02:55:40.032567054Z" + inSyncMempool: true + lastMempoolTime: "2023-04-07T03:04:36.260327616Z" + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: "2023-04-07T03:00:04.080770962Z" + historicalFiatRatesTime: "2023-04-07T00:00:00Z" + about: "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: "47887764338536.25" + sizeOnDisk: 534828732178 + version: "240001" + subversion: "/Satoshi:24.0.1/" + protocolVersion: "70016" + examples: + Example 1: + value: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: "2023-02-27T02:40:48+00:00" + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: "2023-04-07T02:55:40.032567054Z" + inSyncMempool: true + lastMempoolTime: "2023-04-07T03:04:36.260327616Z" + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: "2023-04-07T03:00:04.080770962Z" + historicalFiatRatesTime: "2023-04-07T00:00:00Z" + about: "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: "47887764338536.25" + sizeOnDisk: 534828732178 + version: "240001" + subversion: "/Satoshi:24.0.1/" + protocolVersion: "70016" + + "/block/{blockHashOrHeight}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/blockHashOrHeight" + get: + summary: Block + responses: + "200": + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + hash: + type: string + previousBlockHash: + type: string + nextBlockHash: + type: string + height: + type: integer + confirmations: + type: integer + size: + type: integer + time: + type: integer + version: + type: integer + merkleRoot: + type: string + nonce: + type: string + bits: + type: string + difficulty: + type: string + txCount: + type: integer + txs: + type: array + items: + type: object + properties: + txid: + type: string + vin: + type: array + items: + type: object + properties: + "n": + type: integer + isAddress: + type: boolean + value: + type: string + vout: + type: array + items: + type: object + properties: + value: + type: string + "n": + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + blockHeight: + type: integer + confirmations: + type: integer + blockTime: + type: integer + value: + type: string + valueIn: + type: string + fees: + type: string + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: "2573394689" + bits: 1d00ffff + difficulty: "1" + txCount: 1 + txs: + - txid: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - "n": 0 + isAddress: false + value: "0" + vout: + - value: "5000000000" + "n": 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: "5000000000" + valueIn: "0" + fees: "0" + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: "2573394689" + bits: 1d00ffff + difficulty: "1" + txCount: 1 + txs: + - txid: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - "n": 0 + isAddress: false + value: "0" + vout: + - value: "5000000000" + "n": 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: "5000000000" + valueIn: "0" + fees: "0" + description: OK + operationId: getBlockV2 + description: |- + Returns information about block with transactions, subject to paging. + + Note: Blockbook always follows the main chain of the backend it is attached to. If there is a rollback-reorg in the backend, Blockbook will also do rollback. When you ask for block by height, you will always get the main chain block. If you ask for block by hash, you may get the block from another fork but it is not guaranteed (backend may not keep it) + parameters: + - $ref: "#/components/parameters/page" + - $ref: "#/components/parameters/pageSize" + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Blocks + "/block-index/{blockHeight}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/blockHeight" + get: + summary: Block hash + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + blockHash: + type: string + x-examples: + Example 1: + blockHash: ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + examples: + Example 1: + value: + blockHash: ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + operationId: getBlockHashV2 + description: |- + Get block hash by its height + + Note: Blockbook always follows the main chain of the backend it is attached to. + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Blocks + "/tx-specific/{txId}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/txId" + get: + summary: Transaction + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + zCash: + value: + hex: 040000808...8e6e73cb009 + txid: 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 + overwintered: true + version: 4 + versiongroupid: 892f2085 + locktime: 0 + expiryheight: 495680 + vin: [] + vout: [] + vjoinsplit: [] + valueBalance: 0 + vShieldedSpend: + - cv: 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 + anchor: 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a + rk: 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 + proof: aecf824dbae8eea863ec6...73878c37391f01df520aa + spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 + - cv: a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c + anchor: 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 + rk: 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 + proof: a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 + spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 + vShieldedOutput: + - cv: 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab + cmu: 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc + ephemeralKey: 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 + encCiphertext: a533d3b99b...a0204 + outCiphertext: 4baabc15199504b1...c1ad6a + proof: aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 + bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 + blockhash: 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af + confirmations: 5222 + time: 1552301566 + blocktime: 1552301566 + operationId: getTxSpecificV2 + description: "Returns transaction data in the exact format as returned by backend, including all coin specific fields" + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Transactions + "/address/{address}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/address" + get: + summary: Address + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + # properties: {} + examples: + 'Bitcoin-like, details set to "txids"': + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 + balance: "2432468097999991" + totalReceived: "3992283916999979" + totalSent: "1559815818999988" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 3 + txids: + - 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 + - bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 + - 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d + # ? 'Ethereum-like (details set to "tokenBalances", secondary set to "usd")' + # : value: + # address: "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B" + # balance: "21004631949601199" + # unconfirmedBalance: "0" + # unconfirmedTxs: 0 + # txs: 5 + # nonTokenTxs: 3 + # nonce: "1" + # tokens: + # - type: ERC20 + # name: Tether USD + # contract: "0xdAC17F958D2ee523a2206206994597C13D831ec7" + # transfers: 3 + # symbol: USDT + # decimals: 6 + # balance: "4913000000" + operationId: getAddressV2 + description: | + Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first. + + The **details** query parameter can specify the level of details returned by the request (default: "txids"). + Possible values are: + + **basic**: return only xpub balances, without any derived addresses and transactions + + **tokens**: basic + tokens (addresses) derived from the xpub, subject to tokens parameter + + **tokenBalances**: basic + tokens (addresses) derived from the xpub with balances, subject to tokens parameter + + **txids**: tokenBalances + list of txids, subject to from, to filter and paging + + **txs**: tokenBalances + list of transaction with details, subject to from, to filter and paging + parameters: + - $ref: "#/components/parameters/page" + - $ref: "#/components/parameters/pageSize" + - $ref: "#/components/parameters/fromBlock" + - $ref: "#/components/parameters/toBlock" + - $ref: "#/components/parameters/details" + "/xpub/{xpub}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/xpub" + get: + summary: Xpub + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + address: + type: string + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + unconfirmedBalance: + type: string + unconfirmedTxs: + type: integer + txs: + type: integer + txids: + type: array + items: + type: string + usedTokens: + type: integer + tokens: + type: array + items: + type: object + properties: + type: + type: string + name: + type: string + path: + type: string + transfers: + type: integer + decimals: + type: integer + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + secondaryValue: + type: number + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: "90000000" + totalReceived: "3093381250" + totalSent: "3083381250" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 5 + txids: + - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: "90000000" + totalReceived: "2903986975" + totalSent: "2803986975" + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: "0" + totalReceived: "279394275" + totalSent: "279394275" + secondaryValue: 21195.47633568 + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: "90000000" + totalReceived: "3093381250" + totalSent: "3083381250" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 5 + txids: + - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: "90000000" + totalReceived: "2903986975" + totalSent: "2803986975" + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: "0" + totalReceived: "279394275" + totalSent: "279394275" + secondaryValue: 21195.47633568 + operationId: getXpubV2 + description: |- + Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins. + + Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation schemes, using either xpubs or output descriptors (see https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) + + Note: usedTokens always returns total number of used addresses of xpub. + + Detailed documentation found here: https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub + parameters: + - $ref: "#/components/parameters/page" + - $ref: "#/components/parameters/pageSize" + - $ref: "#/components/parameters/fromBlock" + - $ref: "#/components/parameters/toBlock" + - $ref: "#/components/parameters/details" + - $ref: "#/components/parameters/tokens" + - $ref: "#/components/parameters/secondary" + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + "/utxo/{addressOrXpub}": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + parameters: + - $ref: "#/components/parameters/addressOrXpub" + get: + summary: UTXOs + responses: + "200": + description: OK + content: + application/json: + schema: + type: array + items: {} + examples: + Example 1: + value: + - txid: 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 + vout: 0 + value: "1422303206539" + confirmations: 0 + lockTime: 2648100 + - txid: a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac + vout: 1 + value: "39748685" + height: 2648043 + confirmations: 47 + coinbase: true + - txid: de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef + vout: 0 + value: "122492339065" + height: 2646043 + confirmations: 2047 + - txid: 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 + vout: 0 + value: "142771322208" + height: 2644885 + confirmations: 3205 + operationId: getUTXOV2 + description: |- + Returns array of unspent transaction outputs of address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions. The query parameter confirmed=true disables return of unconfirmed transactions. The returned utxos are sorted by block height, newest blocks first. For xpubs or output descriptors, the response also contains address and derivation path of the utxo. + + + + Unconfirmed utxos do not have field height, the field confirmations has value 0 and may contain field lockTime, if not zero. + + Coinbase utxos have field coinbase set to true, however due to performance reasons only up to minimum coinbase confirmations limit (100). After this limit, utxos are not detected as coinbase. + parameters: + - $ref: "#/components/parameters/confirmed" + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + "/sendtx": + servers: + - url: https://bitcoin-mainnet.blockfrost.io + - url: https://litecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io + post: + summary: Submit transaction + operationId: postSendTxV2 + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + result: + type: string + x-examples: + Example 1: + result: 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + examples: + Example 1: + value: + result: 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + description: | + Sends new transaction to backend for broadcasting + requestBody: + content: + text/plain: + schema: + type: object + properties: {} + description: Transaction hex as plain text + tags: + # - Transactions + - Bitcoin + - Litecoin + - Dogecoin +components: + schemas: {} + securitySchemes: + project_id: + type: apiKey + in: header + name: project_id + description: | + There are multiple token types available based on network you choose + when creating a Blockfrost a project, for a list of token types + see available networks. + parameters: + blockHashOrHeight: + name: blockHashOrHeight + in: path + required: true + schema: + type: string + example: 00000000000000000035835503f43c878ebb643f3b40bdfd0dfda760da74e73c + description: Block hash or height + page: + name: page + in: query + required: false + schema: + type: integer + example: 1 + description: "specifies page of returned transactions, starting from 1. If out of range, Blockbook returns the closest possible page." + pageSize: + name: pageSize + in: query + required: false + schema: + type: integer + example: 1000 + description: number of transactions returned by call (default and maximum 1000) + blockHeight: + name: blockHeight + in: path + required: true + schema: + type: integer + example: 15 + description: Block height/index + txId: + name: txId + in: path + required: true + schema: + type: string + example: cd8ec77174e426070d0a50779232bba7312b712e2c6843d82d963d7076c61366 + description: Transaction ID + address: + name: address + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Wallet address + details: + name: details + in: query + required: false + schema: + type: string + enum: + - basic + - tokens + - tokenBalances + - txids + - txslight + - txs + default: txids + example: basic + description: specifies level of details returned by request + fromBlock: + name: fromBlock + in: query + required: false + schema: + type: integer + example: 10 + description: filter of the returned transactions from block height to block height (default no filter) + toBlock: + name: toBlock + in: query + required: false + schema: + type: integer + example: 100 + description: filter of the returned transactions from block height to block height (default no filter) + secondary: + name: secondary + in: query + required: false + schema: + type: string + example: usd + description: specifies secondary (fiat) currency in which the token and total balances are returned in addition to crypto values + xpub: + name: xpub + in: path + required: true + schema: + type: string + example: tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN + description: "xpub or output descriptor, applicable only for Bitcoin-type coins" + tokens: + name: tokens + in: query + required: false + schema: + type: string + default: nonzero + enum: + - nonzero + - used + - derived + example: used + description: specifies what tokens (xpub addresses) are returned by the request (default nonzero) + confirmed: + name: confirmed + in: query + required: false + schema: + type: boolean + example: true + description: confirmed=true disables return of unconfirmed transactions + hex: + name: hex + in: path + required: true + schema: + type: string + example: 01000000017f9a22c9cbf54bd902400df746f138f37bcf5b4d93eb755820e974ba43ed5f42040000006a4730440220037f4ed5427cde81d55b9b6a2fd08c8a25090c2c2fff3a75c1a57625ca8a7118022076c702fe55969fa08137f71afd4851c48e31082dd3c40c919c92cdbc826758d30121029f6da5623c9f9b68a9baf9c1bc7511df88fa34c6c2f71f7c62f2f03ff48dca80feffffff019c9700000000000017a9146144d57c8aff48492c9dfb914e120b20bad72d6f8773d00700 + description: Transaction hex data + addressOrXpub: + name: addressOrXpub + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Address or XPUB +# tags: +# - name: Status +# description: " " +# - name: Blocks +# description: " " +# - name: Transactions +# description: " " +# - name: Addresses +# description: " " diff --git a/blockfrost-openapi.yaml b/blockfrost-openapi.yaml index 30c1c51a..2c0f31d4 100644 --- a/blockfrost-openapi.yaml +++ b/blockfrost-openapi.yaml @@ -57,6 +57,9 @@ info: Midnight mainnet https://midnight-mainnet.blockfrost.io/api/v0 + Bitcoin mainnet + + https://bitcoin-mainnet.blockfrost.io/api/v2 @@ -260,6 +263,36 @@ security: tags: - name: Health - name: Metrics + - name: Bitcoin + description: | + Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). + - name: Litecoin + description: | + Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). + - name: Dogecoin + description: | + Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets diff --git a/docs/blockfrost-openapi.yaml b/docs/blockfrost-openapi.yaml index 89986bae..cf0ed827 100644 --- a/docs/blockfrost-openapi.yaml +++ b/docs/blockfrost-openapi.yaml @@ -67,6 +67,9 @@ info: Midnight mainnet https://midnight-mainnet.blockfrost.io/api/v0 + Bitcoin mainnet + + https://bitcoin-mainnet.blockfrost.io/api/v2 @@ -350,6 +353,72 @@ security: tags: - name: Health - name: Metrics + - name: Bitcoin + description: > + Blockbook Bitcoin integration allows you to access Bitcoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). + - name: Litecoin + description: > + Blockbook Litecoin integration allows you to access Litecoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). + - name: Dogecoin + description: > + Blockbook Dogecoin integration allows you to access Dogecoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets @@ -6909,6 +6978,850 @@ paths: $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' + /api/v2/status: + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + get: + tags: + - Bitcoin + - Litecoin + - Dogecoin + summary: Blockchain status + operationId: getStatus + description: Get current status of Blockbook and its backend + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + blockbook: + type: object + properties: + coin: + type: string + network: + type: string + host: + type: string + version: + type: string + gitCommit: + type: string + buildTime: + type: string + syncMode: + type: boolean + initialSync: + type: boolean + inSync: + type: boolean + bestHeight: + type: integer + lastBlockTime: + type: string + inSyncMempool: + type: boolean + lastMempoolTime: + type: string + mempoolSize: + type: integer + decimals: + type: integer + dbSize: + type: integer + hasFiatRates: + type: boolean + currentFiatRatesTime: + type: string + historicalFiatRatesTime: + type: string + about: + type: string + backend: + type: object + properties: + chain: + type: string + blocks: + type: integer + headers: + type: integer + bestBlockHash: + type: string + difficulty: + type: string + sizeOnDisk: + type: integer + version: + type: string + subversion: + type: string + protocolVersion: + type: string + x-examples: + Example 1: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: '2023-02-27T02:40:48+00:00' + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: '2023-04-07T02:55:40.032567054Z' + inSyncMempool: true + lastMempoolTime: '2023-04-07T03:04:36.260327616Z' + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' + historicalFiatRatesTime: '2023-04-07T00:00:00Z' + about: >- + Blockbook blockchain indexer for https://chain49.com/ - + based on trezor/blockbook + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: >- + 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: '47887764338536.25' + sizeOnDisk: 534828732178 + version: '240001' + subversion: '/Satoshi:24.0.1/' + protocolVersion: '70016' + examples: + Example 1: + value: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: '2023-02-27T02:40:48+00:00' + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: '2023-04-07T02:55:40.032567054Z' + inSyncMempool: true + lastMempoolTime: '2023-04-07T03:04:36.260327616Z' + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' + historicalFiatRatesTime: '2023-04-07T00:00:00Z' + about: >- + Blockbook blockchain indexer for https://chain49.com/ - + based on trezor/blockbook + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: >- + 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: '47887764338536.25' + sizeOnDisk: 534828732178 + version: '240001' + subversion: '/Satoshi:24.0.1/' + protocolVersion: '70016' + '/api/v2/block/{blockHashOrHeight}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/blockHashOrHeight' + get: + summary: Block + responses: + '200': + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + hash: + type: string + previousBlockHash: + type: string + nextBlockHash: + type: string + height: + type: integer + confirmations: + type: integer + size: + type: integer + time: + type: integer + version: + type: integer + merkleRoot: + type: string + nonce: + type: string + bits: + type: string + difficulty: + type: string + txCount: + type: integer + txs: + type: array + items: + type: object + properties: + txid: + type: string + vin: + type: array + items: + type: object + properties: + 'n': + type: integer + isAddress: + type: boolean + value: + type: string + vout: + type: array + items: + type: object + properties: + value: + type: string + 'n': + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + blockHeight: + type: integer + confirmations: + type: integer + blockTime: + type: integer + value: + type: string + valueIn: + type: string + fees: + type: string + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: >- + 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: >- + 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: '2573394689' + bits: 1d00ffff + difficulty: '1' + txCount: 1 + txs: + - txid: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - 'n': 0 + isAddress: false + value: '0' + vout: + - value: '5000000000' + 'n': 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: '5000000000' + valueIn: '0' + fees: '0' + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: >- + 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: >- + 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: '2573394689' + bits: 1d00ffff + difficulty: '1' + txCount: 1 + txs: + - txid: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - 'n': 0 + isAddress: false + value: '0' + vout: + - value: '5000000000' + 'n': 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: '5000000000' + valueIn: '0' + fees: '0' + description: OK + operationId: getBlockV2 + description: >- + Returns information about block with transactions, subject to paging. + + + Note: Blockbook always follows the main chain of the backend it is + attached to. If there is a rollback-reorg in the backend, Blockbook will + also do rollback. When you ask for block by height, you will always get + the main chain block. If you ask for block by hash, you may get the + block from another fork but it is not guaranteed (backend may not keep + it) + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/block-index/{blockHeight}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/blockHeight' + get: + summary: Block hash + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + blockHash: + type: string + x-examples: + Example 1: + blockHash: >- + ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + examples: + Example 1: + value: + blockHash: >- + ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + operationId: getBlockHashV2 + description: >- + Get block hash by its height + + + Note: Blockbook always follows the main chain of the backend it is + attached to. + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/tx-specific/{txId}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/txId' + get: + summary: Transaction + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + zCash: + value: + hex: 040000808...8e6e73cb009 + txid: >- + 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 + overwintered: true + version: 4 + versiongroupid: 892f2085 + locktime: 0 + expiryheight: 495680 + vin: [] + vout: [] + vjoinsplit: [] + valueBalance: 0 + vShieldedSpend: + - cv: >- + 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 + anchor: >- + 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: >- + 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a + rk: >- + 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 + proof: aecf824dbae8eea863ec6...73878c37391f01df520aa + spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 + - cv: >- + a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c + anchor: >- + 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: >- + 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 + rk: >- + 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 + proof: >- + a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 + spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 + vShieldedOutput: + - cv: >- + 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab + cmu: >- + 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc + ephemeralKey: >- + 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 + encCiphertext: a533d3b99b...a0204 + outCiphertext: 4baabc15199504b1...c1ad6a + proof: >- + aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 + bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 + blockhash: >- + 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af + confirmations: 5222 + time: 1552301566 + blocktime: 1552301566 + operationId: getTxSpecificV2 + description: >- + Returns transaction data in the exact format as returned by backend, + including all coin specific fields + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/address/{address}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/address' + get: + summary: Address + tags: + - Bitcoin + - Litecoin + - Dogecoin + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + 'Bitcoin-like, details set to "txids"': + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 + balance: '2432468097999991' + totalReceived: '3992283916999979' + totalSent: '1559815818999988' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 3 + txids: + - >- + 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 + - >- + bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 + - >- + 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d + operationId: getAddressV2 + description: > + Returns balances and transactions of an address. The returned + transactions are sorted by block height, newest blocks first. + + + The **details** query parameter can specify the level of details + returned by the request (default: "txids"). + + Possible values are: + + + **basic**: return only xpub balances, without any derived addresses and + transactions + + + **tokens**: basic + tokens (addresses) derived from the xpub, subject to + tokens parameter + + + **tokenBalances**: basic + tokens (addresses) derived from the xpub with + balances, subject to tokens parameter + + + **txids**: tokenBalances + list of txids, subject to from, to filter and + paging + + + **txs**: tokenBalances + list of transaction with details, subject to + from, to filter and paging + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/fromBlock' + - $ref: '#/components/parameters/toBlock' + - $ref: '#/components/parameters/details' + '/api/v2/xpub/{xpub}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/xpub' + get: + summary: Xpub + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + address: + type: string + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + unconfirmedBalance: + type: string + unconfirmedTxs: + type: integer + txs: + type: integer + txids: + type: array + items: + type: string + usedTokens: + type: integer + tokens: + type: array + items: + type: object + properties: + type: + type: string + name: + type: string + path: + type: string + transfers: + type: integer + decimals: + type: integer + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + secondaryValue: + type: number + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: >- + dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: '90000000' + totalReceived: '3093381250' + totalSent: '3083381250' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 5 + txids: + - >- + 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - >- + 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - >- + e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - >- + 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - >- + 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: '90000000' + totalReceived: '2903986975' + totalSent: '2803986975' + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: '0' + totalReceived: '279394275' + totalSent: '279394275' + secondaryValue: 21195.47633568 + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: >- + dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: '90000000' + totalReceived: '3093381250' + totalSent: '3083381250' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 5 + txids: + - >- + 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - >- + 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - >- + e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - >- + 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - >- + 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: '90000000' + totalReceived: '2903986975' + totalSent: '2803986975' + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: '0' + totalReceived: '279394275' + totalSent: '279394275' + secondaryValue: 21195.47633568 + operationId: getXpubV2 + description: >- + Returns balances and transactions of an xpub or output descriptor, + applicable only for Bitcoin-type coins. + + + Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation + schemes, using either xpubs or output descriptors (see + https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) + + + Note: usedTokens always returns total number of used addresses of xpub. + + + Detailed documentation found here: + https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/fromBlock' + - $ref: '#/components/parameters/toBlock' + - $ref: '#/components/parameters/details' + - $ref: '#/components/parameters/tokens' + - $ref: '#/components/parameters/secondary' + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/utxo/{addressOrXpub}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/addressOrXpub' + get: + summary: UTXOs + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: {} + examples: + Example 1: + value: + - txid: >- + 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 + vout: 0 + value: '1422303206539' + confirmations: 0 + lockTime: 2648100 + - txid: >- + a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac + vout: 1 + value: '39748685' + height: 2648043 + confirmations: 47 + coinbase: true + - txid: >- + de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef + vout: 0 + value: '122492339065' + height: 2646043 + confirmations: 2047 + - txid: >- + 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 + vout: 0 + value: '142771322208' + height: 2644885 + confirmations: 3205 + operationId: getUTXOV2 + description: >- + Returns array of unspent transaction outputs of address or xpub, + applicable only for Bitcoin-type coins. By default, the list contains + both confirmed and unconfirmed transactions. The query parameter + confirmed=true disables return of unconfirmed transactions. The returned + utxos are sorted by block height, newest blocks first. For xpubs or + output descriptors, the response also contains address and derivation + path of the utxo. + + + + + Unconfirmed utxos do not have field height, the field confirmations has + value 0 and may contain field lockTime, if not zero. + + + Coinbase utxos have field coinbase set to true, however due to + performance reasons only up to minimum coinbase confirmations limit + (100). After this limit, utxos are not detected as coinbase. + parameters: + - $ref: '#/components/parameters/confirmed' + tags: + - Bitcoin + - Litecoin + - Dogecoin + /api/v2/sendtx: + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + post: + summary: Submit transaction + operationId: postSendTxV2 + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + result: + type: string + x-examples: + Example 1: + result: >- + 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + examples: + Example 1: + value: + result: >- + 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + description: | + Sends new transaction to backend for broadcasting + requestBody: + content: + text/plain: + schema: + type: object + properties: {} + description: Transaction hex as plain text + tags: + - Bitcoin + - Litecoin + - Dogecoin components: schemas: onchain_metadata_cip25: @@ -13698,3 +14611,149 @@ components: There are multiple token types available based on network you choose when creating a Blockfrost a project, for a list of token types see available networks. + parameters: + blockHashOrHeight: + name: blockHashOrHeight + in: path + required: true + schema: + type: string + example: 00000000000000000035835503f43c878ebb643f3b40bdfd0dfda760da74e73c + description: Block hash or height + page: + name: page + in: query + required: false + schema: + type: integer + example: 1 + description: >- + specifies page of returned transactions, starting from 1. If out of + range, Blockbook returns the closest possible page. + pageSize: + name: pageSize + in: query + required: false + schema: + type: integer + example: 1000 + description: number of transactions returned by call (default and maximum 1000) + blockHeight: + name: blockHeight + in: path + required: true + schema: + type: integer + example: 15 + description: Block height/index + txId: + name: txId + in: path + required: true + schema: + type: string + example: cd8ec77174e426070d0a50779232bba7312b712e2c6843d82d963d7076c61366 + description: Transaction ID + address: + name: address + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Wallet address + details: + name: details + in: query + required: false + schema: + type: string + enum: + - basic + - tokens + - tokenBalances + - txids + - txslight + - txs + default: txids + example: basic + description: specifies level of details returned by request + fromBlock: + name: fromBlock + in: query + required: false + schema: + type: integer + example: 10 + description: >- + filter of the returned transactions from block height to block height + (default no filter) + toBlock: + name: toBlock + in: query + required: false + schema: + type: integer + example: 100 + description: >- + filter of the returned transactions from block height to block height + (default no filter) + secondary: + name: secondary + in: query + required: false + schema: + type: string + example: usd + description: >- + specifies secondary (fiat) currency in which the token and total + balances are returned in addition to crypto values + xpub: + name: xpub + in: path + required: true + schema: + type: string + example: >- + tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN + description: 'xpub or output descriptor, applicable only for Bitcoin-type coins' + tokens: + name: tokens + in: query + required: false + schema: + type: string + default: nonzero + enum: + - nonzero + - used + - derived + example: used + description: >- + specifies what tokens (xpub addresses) are returned by the request + (default nonzero) + confirmed: + name: confirmed + in: query + required: false + schema: + type: boolean + example: true + description: confirmed=true disables return of unconfirmed transactions + hex: + name: hex + in: path + required: true + schema: + type: string + example: >- + 01000000017f9a22c9cbf54bd902400df746f138f37bcf5b4d93eb755820e974ba43ed5f42040000006a4730440220037f4ed5427cde81d55b9b6a2fd08c8a25090c2c2fff3a75c1a57625ca8a7118022076c702fe55969fa08137f71afd4851c48e31082dd3c40c919c92cdbc826758d30121029f6da5623c9f9b68a9baf9c1bc7511df88fa34c6c2f71f7c62f2f03ff48dca80feffffff019c9700000000000017a9146144d57c8aff48492c9dfb914e120b20bad72d6f8773d00700 + description: Transaction hex data + addressOrXpub: + name: addressOrXpub + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Address or XPUB diff --git a/docs/midnight/index.html b/docs/midnight/index.html index a246162a..28091f0f 100644 --- a/docs/midnight/index.html +++ b/docs/midnight/index.html @@ -788,7 +788,7 @@
Response
"data": { "block": { "hash": HexEncoded, - "height": 987, + "height": 123, "protocolVersion": 123, "timestamp": 123, "author": HexEncoded, @@ -875,13 +875,13 @@
Response
"data": { "committee": [ { - "epochNo": 987, - "position": 123, + "epochNo": 123, + "position": 987, "sidechainPubkeyHex": "abc123", "expectedSlots": 123, - "auraPubkeyHex": "xyz789", + "auraPubkeyHex": "abc123", "poolIdHex": "abc123", - "spoSkHex": "abc123" + "spoSkHex": "xyz789" } ] } @@ -1110,7 +1110,7 @@
Response
"data": { "currentEpochInfo": { "epochNo": 123, - "durationSeconds": 123, + "durationSeconds": 987, "elapsedSeconds": 123 } } @@ -1166,9 +1166,9 @@
Response
{ "blockHeight": 987, "blockHash": HexEncoded, - "timestamp": 123, + "timestamp": 987, "numPermissionedCandidates": 987, - "numRegisteredCandidates": 987 + "numRegisteredCandidates": 123 } ] } @@ -1254,12 +1254,12 @@
Response
"cardanoRewardAddress": CardanoRewardAddress, "dustAddress": DustAddress, "registered": true, - "nightBalance": "xyz789", + "nightBalance": "abc123", "generationRate": "abc123", "maxCapacity": "abc123", "currentCapacity": "xyz789", "utxoTxHash": HexEncoded, - "utxoOutputIndex": 123 + "utxoOutputIndex": 987 } ] } @@ -1354,7 +1354,7 @@
Query
Variables
-
{"epoch": 987, "limit": 987, "offset": 987}
+                  
{"epoch": 987, "limit": 987, "offset": 123}
 
@@ -1363,12 +1363,12 @@
Response
"data": { "epochPerformance": [ { - "epochNo": 123, + "epochNo": 987, "spoSkHex": "xyz789", "produced": 123, "expected": 987, "identityLabel": "abc123", - "stakeSnapshot": "xyz789", + "stakeSnapshot": "abc123", "poolIdHex": "xyz789", "validatorClass": "abc123" } @@ -1434,12 +1434,12 @@
Query
Variables
-
{"epoch": 123}
+                  
{"epoch": 987}
 
Response
-
{"data": {"epochUtilization": 987.65}}
+                  
{"data": {"epochUtilization": 123.45}}
 
@@ -1506,7 +1506,7 @@
Query
Variables
-
{"poolIdHex": "xyz789"}
+                  
{"poolIdHex": "abc123"}
 
@@ -1516,10 +1516,10 @@
Response
"poolMetadata": { "poolIdHex": "abc123", "hexId": "abc123", - "name": "xyz789", - "ticker": "abc123", + "name": "abc123", + "ticker": "xyz789", "homepageUrl": "abc123", - "logoUrl": "xyz789" + "logoUrl": "abc123" } } } @@ -1611,7 +1611,7 @@
Query
Variables
-
{"limit": 987, "offset": 123, "withNameOnly": true}
+                  
{"limit": 987, "offset": 123, "withNameOnly": false}
 
@@ -1620,12 +1620,12 @@
Response
"data": { "poolMetadataList": [ { - "poolIdHex": "xyz789", - "hexId": "xyz789", - "name": "xyz789", - "ticker": "abc123", - "homepageUrl": "xyz789", - "logoUrl": "xyz789" + "poolIdHex": "abc123", + "hexId": "abc123", + "name": "abc123", + "ticker": "xyz789", + "homepageUrl": "abc123", + "logoUrl": "abc123" } ] } @@ -1692,7 +1692,7 @@
Query
Variables
-
{"uptoEpoch": 987}
+                  
{"uptoEpoch": 123}
 
@@ -1702,7 +1702,7 @@
Response
"registeredFirstValidEpochs": [ { "idKey": "abc123", - "firstValidEpoch": 987 + "firstValidEpoch": 123 } ] } @@ -1889,11 +1889,11 @@
Response
"data": { "registeredSpoSeries": [ { - "epochNo": 987, - "federatedValidCount": 123, - "federatedInvalidCount": 987, - "registeredValidCount": 123, - "registeredInvalidCount": 987, + "epochNo": 123, + "federatedValidCount": 987, + "federatedInvalidCount": 123, + "registeredValidCount": 987, + "registeredInvalidCount": 123, "dparam": 123.45 } ] @@ -1975,7 +1975,7 @@
Query
Variables
-
{"fromEpoch": 123, "toEpoch": 987}
+                  
{"fromEpoch": 987, "toEpoch": 987}
 
@@ -1983,7 +1983,7 @@
Response
{
   "data": {
     "registeredTotalsSeries": [
-      {"epochNo": 123, "totalRegistered": 987, "newlyRegistered": 987}
+      {"epochNo": 987, "totalRegistered": 123, "newlyRegistered": 987}
     ]
   }
 }
@@ -2055,7 +2055,7 @@ 
Query
Variables
-
{"poolIdHex": "xyz789"}
+                  
{"poolIdHex": "abc123"}
 
@@ -2064,9 +2064,9 @@
Response
"data": { "spoByPoolId": { "poolIdHex": "abc123", - "validatorClass": "xyz789", + "validatorClass": "abc123", "sidechainPubkeyHex": "abc123", - "auraPubkeyHex": "abc123", + "auraPubkeyHex": "xyz789", "name": "abc123", "ticker": "xyz789", "homepageUrl": "abc123", @@ -2159,7 +2159,7 @@
Query
Variables
-
{"poolIdHex": "abc123"}
+                  
{"poolIdHex": "xyz789"}
 
@@ -2212,7 +2212,7 @@
Query
Response
-
{"data": {"spoCount": 987}}
+                  
{"data": {"spoCount": 123}}
 
@@ -2291,7 +2291,7 @@
Query
Variables
-
{"limit": 987, "offset": 987}
+                  
{"limit": 123, "offset": 123}
 
@@ -2304,7 +2304,7 @@
Response
"mainchainPubkeyHex": "abc123", "sidechainPubkeyHex": "xyz789", "auraPubkeyHex": "xyz789", - "validatorClass": "abc123" + "validatorClass": "xyz789" } ] } @@ -2385,7 +2385,7 @@
Response
"poolIdHex": "xyz789", "mainchainPubkeyHex": "xyz789", "sidechainPubkeyHex": "abc123", - "auraPubkeyHex": "xyz789", + "auraPubkeyHex": "abc123", "validatorClass": "abc123" } } @@ -2482,8 +2482,8 @@
Query
Variables
{
   "limit": 987,
-  "offset": 123,
-  "search": "abc123"
+  "offset": 987,
+  "search": "xyz789"
 }
 
@@ -2493,14 +2493,14 @@
Response
"data": { "spoList": [ { - "poolIdHex": "abc123", + "poolIdHex": "xyz789", "validatorClass": "abc123", "sidechainPubkeyHex": "xyz789", "auraPubkeyHex": "abc123", "name": "abc123", - "ticker": "xyz789", + "ticker": "abc123", "homepageUrl": "xyz789", - "logoUrl": "xyz789" + "logoUrl": "abc123" } ] } @@ -2597,7 +2597,7 @@
Query
Variables
{
   "spoSkHex": "abc123",
-  "limit": 123,
+  "limit": 987,
   "offset": 123
 }
 
@@ -2608,11 +2608,11 @@
Response
"data": { "spoPerformanceBySpoSk": [ { - "epochNo": 123, - "spoSkHex": "xyz789", + "epochNo": 987, + "spoSkHex": "abc123", "produced": 123, - "expected": 123, - "identityLabel": "abc123", + "expected": 987, + "identityLabel": "xyz789", "stakeSnapshot": "abc123", "poolIdHex": "xyz789", "validatorClass": "xyz789" @@ -2701,7 +2701,7 @@
Query
Variables
-
{"limit": 123, "offset": 123}
+                  
{"limit": 987, "offset": 987}
 
@@ -2710,13 +2710,13 @@
Response
"data": { "spoPerformanceLatest": [ { - "epochNo": 123, - "spoSkHex": "xyz789", - "produced": 123, - "expected": 123, + "epochNo": 987, + "spoSkHex": "abc123", + "produced": 987, + "expected": 987, "identityLabel": "abc123", - "stakeSnapshot": "abc123", - "poolIdHex": "abc123", + "stakeSnapshot": "xyz789", + "poolIdHex": "xyz789", "validatorClass": "xyz789" } ] @@ -2826,7 +2826,7 @@
Query
Variables
{
-  "limit": 987,
+  "limit": 123,
   "offset": 987,
   "search": "xyz789",
   "orderByStakeDesc": true
@@ -2840,16 +2840,16 @@ 
Response
"stakeDistribution": [ { "poolIdHex": "xyz789", - "name": "abc123", + "name": "xyz789", "ticker": "xyz789", - "homepageUrl": "abc123", + "homepageUrl": "xyz789", "logoUrl": "abc123", "liveStake": "abc123", - "activeStake": "xyz789", + "activeStake": "abc123", "liveDelegators": 987, - "liveSaturation": 123.45, - "declaredPledge": "xyz789", - "livePledge": "xyz789", + "liveSaturation": 987.65, + "declaredPledge": "abc123", + "livePledge": "abc123", "stakeShare": 123.45 } ] @@ -2914,12 +2914,12 @@
Query
Variables
-
{"limit": 987}
+                  
{"limit": 123}
 
Response
-
{"data": {"stakePoolOperators": ["abc123"]}}
+                  
{"data": {"stakePoolOperators": ["xyz789"]}}
 
@@ -2971,9 +2971,9 @@
Response
{ "blockHeight": 123, "blockHash": HexEncoded, - "timestamp": 123, + "timestamp": 987, "hash": HexEncoded, - "url": "xyz789" + "url": "abc123" } ] } @@ -3269,7 +3269,7 @@
Response
"data": { "transactions": [ { - "id": 123, + "id": 987, "hash": HexEncoded, "protocolVersion": 123, "raw": HexEncoded, @@ -3629,8 +3629,8 @@
Response
"data": { "blocks": { "hash": HexEncoded, - "height": 987, - "protocolVersion": 987, + "height": 123, + "protocolVersion": 123, "timestamp": 123, "author": HexEncoded, "ledgerParameters": HexEncoded, @@ -3892,7 +3892,7 @@
Response
"id": 987, "raw": HexEncoded, "maxId": 123, - "protocolVersion": 123 + "protocolVersion": 987 } } } @@ -4016,7 +4016,7 @@
Query
Variables
-
{"sessionId": HexEncoded, "index": 123}
+                  
{"sessionId": HexEncoded, "index": 987}
 
@@ -4230,7 +4230,7 @@
Query
Variables
-
{"id": 123}
+                  
{"id": 987}
 
@@ -4240,8 +4240,8 @@
Response
"zswapLedgerEvents": { "id": 123, "raw": HexEncoded, - "maxId": 987, - "protocolVersion": 123 + "maxId": 123, + "protocolVersion": 987 } } } @@ -4377,7 +4377,7 @@
Fields
Example
-
{"hash": HexEncoded, "height": 123}
+                  
{"hash": HexEncoded, "height": 987}
 
@@ -4462,9 +4462,9 @@
Fields
Example
{
   "startIndex": 987,
-  "endIndex": 987,
+  "endIndex": 123,
   "update": HexEncoded,
-  "protocolVersion": 987
+  "protocolVersion": 123
 }
 
@@ -4542,11 +4542,11 @@
Fields
Example
{
-  "epochNo": 123,
+  "epochNo": 987,
   "position": 987,
-  "sidechainPubkeyHex": "xyz789",
-  "expectedSlots": 987,
-  "auraPubkeyHex": "abc123",
+  "sidechainPubkeyHex": "abc123",
+  "expectedSlots": 123,
+  "auraPubkeyHex": "xyz789",
   "poolIdHex": "abc123",
   "spoSkHex": "xyz789"
 }
@@ -4993,7 +4993,7 @@ 
Fields
Example
-
{"numPermissionedCandidates": 123, "numRegisteredCandidates": 987}
+                  
{"numPermissionedCandidates": 987, "numRegisteredCandidates": 123}
 
@@ -5053,7 +5053,7 @@
Fields
Example
{
-  "blockHeight": 123,
+  "blockHeight": 987,
   "blockHash": HexEncoded,
   "timestamp": 987,
   "numPermissionedCandidates": 987,
@@ -5129,7 +5129,7 @@ 
Example
"id": 987, "raw": HexEncoded, "maxId": 987, - "protocolVersion": 123 + "protocolVersion": 987 }
@@ -5212,13 +5212,13 @@
Example
{
   "cardanoRewardAddress": CardanoRewardAddress,
   "dustAddress": DustAddress,
-  "registered": false,
-  "nightBalance": "abc123",
+  "registered": true,
+  "nightBalance": "xyz789",
   "generationRate": "xyz789",
   "maxCapacity": "abc123",
   "currentCapacity": "abc123",
   "utxoTxHash": HexEncoded,
-  "utxoOutputIndex": 123
+  "utxoOutputIndex": 987
 }
 
@@ -5278,7 +5278,7 @@
Example
"id": 123, "raw": HexEncoded, "maxId": 123, - "protocolVersion": 987, + "protocolVersion": 123, "output": DustOutput }
@@ -5371,10 +5371,10 @@
Possible Types
Example
{
-  "id": 123,
+  "id": 987,
   "raw": HexEncoded,
   "maxId": 123,
-  "protocolVersion": 123
+  "protocolVersion": 987
 }
 
@@ -5467,8 +5467,8 @@
Example
{
   "id": 987,
   "raw": HexEncoded,
-  "maxId": 123,
-  "protocolVersion": 123
+  "maxId": 987,
+  "protocolVersion": 987
 }
 
@@ -5521,7 +5521,7 @@
Fields
Example
-
{"epochNo": 123, "durationSeconds": 987, "elapsedSeconds": 123}
+                  
{"epochNo": 987, "durationSeconds": 987, "elapsedSeconds": 123}
 
@@ -5604,13 +5604,13 @@
Fields
Example
{
-  "epochNo": 987,
+  "epochNo": 123,
   "spoSkHex": "xyz789",
   "produced": 987,
   "expected": 123,
-  "identityLabel": "abc123",
+  "identityLabel": "xyz789",
   "stakeSnapshot": "abc123",
-  "poolIdHex": "xyz789",
+  "poolIdHex": "abc123",
   "validatorClass": "xyz789"
 }
 
@@ -5658,7 +5658,7 @@
Fields
Example
-
{"idKey": "abc123", "firstValidEpoch": 987}
+                  
{"idKey": "xyz789", "firstValidEpoch": 123}
 
@@ -5679,7 +5679,7 @@
Description
Example
-
987.65
+                  
123.45
 
@@ -5768,10 +5768,10 @@
Fields
Example
{
-  "id": 123,
+  "id": 987,
   "raw": HexEncoded,
-  "maxId": 123,
-  "protocolVersion": 987
+  "maxId": 987,
+  "protocolVersion": 123
 }
 
@@ -5846,9 +5846,9 @@
Example
"poolIdHex": "abc123", "hexId": "abc123", "name": "abc123", - "ticker": "abc123", - "homepageUrl": "abc123", - "logoUrl": "abc123" + "ticker": "xyz789", + "homepageUrl": "xyz789", + "logoUrl": "xyz789" }
@@ -5908,9 +5908,9 @@
Fields
Example
{
-  "epochNo": 987,
+  "epochNo": 123,
   "idKey": "abc123",
-  "source": "abc123",
+  "source": "xyz789",
   "status": "abc123"
 }
 
@@ -5984,8 +5984,8 @@
Fields
Example
{
   "epochNo": 123,
-  "federatedValidCount": 123,
-  "federatedInvalidCount": 987,
+  "federatedValidCount": 987,
+  "federatedInvalidCount": 123,
   "registeredValidCount": 123,
   "registeredInvalidCount": 987,
   "dparam": 123.45
@@ -6156,7 +6156,7 @@ 
Fields
Example
{
-  "id": 123,
+  "id": 987,
   "hash": HexEncoded,
   "protocolVersion": 123,
   "raw": HexEncoded,
@@ -6164,7 +6164,7 @@ 
Example
"identifiers": [HexEncoded], "merkleTreeRoot": HexEncoded, "startIndex": 123, - "endIndex": 123, + "endIndex": 987, "fees": TransactionFees, "block": Block, "contractActions": [ContractAction], @@ -6263,7 +6263,7 @@
Fields
Example
-
{"id": 123, "success": false}
+                  
{"id": 123, "success": true}
 
@@ -6356,7 +6356,7 @@
Fields
Example
{
-  "highestEndIndex": 987,
+  "highestEndIndex": 123,
   "highestCheckedEndIndex": 123,
   "highestRelevantEndIndex": 987
 }
@@ -6443,13 +6443,13 @@ 
Fields
Example
{
   "poolIdHex": "abc123",
-  "validatorClass": "abc123",
+  "validatorClass": "xyz789",
   "sidechainPubkeyHex": "xyz789",
   "auraPubkeyHex": "xyz789",
-  "name": "abc123",
-  "ticker": "abc123",
+  "name": "xyz789",
+  "ticker": "xyz789",
   "homepageUrl": "abc123",
-  "logoUrl": "abc123"
+  "logoUrl": "xyz789"
 }
 
@@ -6573,9 +6573,9 @@
Example
{
   "poolIdHex": "xyz789",
   "mainchainPubkeyHex": "xyz789",
-  "sidechainPubkeyHex": "xyz789",
-  "auraPubkeyHex": "xyz789",
-  "validatorClass": "abc123"
+  "sidechainPubkeyHex": "abc123",
+  "auraPubkeyHex": "abc123",
+  "validatorClass": "xyz789"
 }
 
@@ -6672,15 +6672,15 @@
Fields
Example
{
-  "poolIdHex": "abc123",
-  "name": "abc123",
+  "poolIdHex": "xyz789",
+  "name": "xyz789",
   "ticker": "abc123",
-  "homepageUrl": "abc123",
+  "homepageUrl": "xyz789",
   "logoUrl": "xyz789",
   "liveStake": "abc123",
-  "activeStake": "xyz789",
-  "liveDelegators": 123,
-  "liveSaturation": 987.65,
+  "activeStake": "abc123",
+  "liveDelegators": 987,
+  "liveSaturation": 123.45,
   "declaredPledge": "abc123",
   "livePledge": "xyz789",
   "stakeShare": 123.45
@@ -6839,7 +6839,7 @@ 
Example
{
   "id": 123,
   "hash": HexEncoded,
-  "protocolVersion": 123,
+  "protocolVersion": 987,
   "raw": HexEncoded,
   "block": Block,
   "contractActions": [ContractAction],
@@ -6958,7 +6958,7 @@ 
Example
"blockHash": HexEncoded, "timestamp": 987, "hash": HexEncoded, - "url": "abc123" + "url": "xyz789" }
@@ -7076,7 +7076,7 @@
Possible Types
Example
{
-  "id": 123,
+  "id": 987,
   "hash": HexEncoded,
   "protocolVersion": 987,
   "raw": HexEncoded,
@@ -7131,7 +7131,7 @@ 
Fields
Example
{
-  "paidFees": "xyz789",
+  "paidFees": "abc123",
   "estimatedFees": "xyz789"
 }
 
@@ -7452,7 +7452,7 @@
Fields
Example
-
{"highestTransactionId": 987}
+                  
{"highestTransactionId": 123}
 
@@ -7542,9 +7542,9 @@
Example
"value": "xyz789", "intentHash": HexEncoded, "outputIndex": 123, - "ctime": 987, + "ctime": 123, "initialNonce": HexEncoded, - "registeredForDustGeneration": false, + "registeredForDustGeneration": true, "createdAtTransaction": Transaction, "spentAtTransaction": Transaction } @@ -7619,10 +7619,10 @@
Fields
Example
{
-  "id": 123,
+  "id": 987,
   "raw": HexEncoded,
-  "maxId": 987,
-  "protocolVersion": 987
+  "maxId": 123,
+  "protocolVersion": 123
 }
 
diff --git a/json-schema.json b/json-schema.json index f64da8fe..5ad138b7 100644 --- a/json-schema.json +++ b/json-schema.json @@ -1 +1 @@ -{"/":{"response":{"200":{"type":"object","properties":{"url":{"type":"string","example":"https://blockfrost.io/"},"version":{"type":"string","example":"0.1.0"}},"required":["url","version"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health":{"response":{"200":{"type":"object","properties":{"is_healthy":{"type":"boolean","example":true}},"required":["is_healthy"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health/clock":{"response":{"200":{"type":"object","properties":{"server_time":{"type":"integer","format":"int64","example":1603400958947}},"required":["server_time"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/latest/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/{hash_or_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"slot_number":{"type":"integer"}}}},"/blocks/epoch/{epoch_number}/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"epoch_number":{"type":"integer"},"slot_number":{"type":"integer"}}}},"/blocks/{hash_or_number}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address that was affected in the specified block"},"transactions":{"type":"array","description":"List of transactions containing the address either in their inputs or outputs. Sorted by transaction index within a block, ascending.","items":{"type":"object","properties":{"tx_hash":{"type":"string"}},"required":["tx_hash"]}}},"required":["address","transactions"]},"example":[{"address":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157d0"}]}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/genesis":{"response":{"200":{"type":"object","properties":{"active_slots_coefficient":{"type":"number","example":0.05,"description":"The proportion of slots in which blocks should be issued"},"update_quorum":{"type":"integer","example":5,"description":"Determines the quorum needed for votes on the protocol parameter updates"},"max_lovelace_supply":{"type":"string","example":"45000000000000000","description":"The total number of lovelace in the system"},"network_magic":{"type":"integer","example":764824073,"description":"Network identifier"},"epoch_length":{"type":"integer","example":432000,"description":"Number of slots in an epoch"},"system_start":{"type":"integer","example":1506203091,"description":"Time of slot 0 in UNIX time"},"slots_per_kes_period":{"type":"integer","example":129600,"description":"Number of slots in an KES period"},"slot_length":{"type":"integer","example":1,"description":"Duration of one slot in seconds"},"max_kes_evolutions":{"type":"integer","example":62,"description":"The maximum number of time a KES key can be evolved before a pool operator must create a new operational certificate"},"security_param":{"type":"integer","example":2160,"description":"Security parameter k"}},"required":["active_slots_coefficient","update_quorum","max_lovelace_supply","network_magic","epoch_length","system_start","slots_per_kes_period","slot_length","max_kes_evolutions","security_param"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/governance/dreps":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"drep_id":{"type":"string","description":"The Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"}},"required":["drep_id","hex"]},"example":[{"drep_id":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","hex":"db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23"},{"drep_id":"drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4","hex":"c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/dreps/{drep_id}":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"amount":{"type":"string","description":"The total amount of voting power this DRep is delegated."},"active":{"type":"boolean","description":"Registration state of the DRep","deprecated":true},"active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent registration","deprecated":true},"has_script":{"type":"boolean","description":"Flag which shows if this DRep credentials are a script hash"},"retired":{"type":"boolean","description":"Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`."},"expired":{"type":"boolean","description":"Whether the DRep has been inactive for a consecutive number of epochs (determined by a epoch parameter `drep_activity`)"},"last_active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent action - registration, update, deregistration or voting"}},"required":["drep_id","hex","amount","active","active_epoch","has_script","retired","expired","last_active_epoch"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","amount":"2000000","active":true,"active_epoch":420,"has_script":true,"last_active_epoch":509,"retired":false,"expired":false}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"amount":{"type":"string","description":"Currently delegated amount"}},"required":["address","amount"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","amount":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","amount":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","amount":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/metadata":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded addresses"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"url":{"type":"string","example":"https://stakenuts.com/drep.json","description":"URL to the drep metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-119)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["drep_id","hex","url","hash","json_metadata","bytes"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","url":"https://aaa.xyz/drep.json","hash":"a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de","json_metadata":{"@context":{"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP119":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#","hashAlgorithm":"CIP100:hashAlgorithm","body":{"@id":"CIP119:body","@context":{"references":{"@id":"CIP119:references","@container":"@set","@context":{"GovernanceMetadata":"CIP100:GovernanceMetadataReference","Other":"CIP100:OtherReference","label":"CIP100:reference-label","uri":"CIP100:reference-uri"}},"paymentAddress":"CIP119:paymentAddress","givenName":"CIP119:givenName","image":{"@id":"CIP119:image","@context":{"ImageObject":"https://schema.org/ImageObject"}},"objectives":"CIP119:objectives","motivations":"CIP119:motivations","qualifications":"CIP119:qualifications"}}},"hashAlgorithm":"blake2b-256","body":{"paymentAddress":"addr1q86dnpkva4mm859c8ur7tjxn57zgsu6vg8pdetkdve3fsacnq7twy06u2ev5759vutpjgzfryx0ud8hzedhzerava35qwh3x34","givenName":"Ryan Williams","image":{"@type":"ImageObject","contentUrl":"https://avatars.githubusercontent.com/u/44342099?v=4","sha256":"2a21e4f7b20c8c72f573707b068fb8fc6d8c64d5035c4e18ecae287947fe2b2e"},"objectives":"Buy myself an island.","motivations":"I really would like to own an island.","qualifications":"I have my 100m swimming badge, so I would be qualified to be able to swim around island.","references":[{"@type":"Other","label":"A cool island for Ryan","uri":"https://www.google.com/maps/place/World's+only+5th+order+recursive+island/@62.6511465,-97.7946829,15.75z/data=!4m14!1m7!3m6!1s0x5216a167810cee39:0x11431abdfe4c7421!2sWorld's+only+5th+order+recursive+island!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n!3m5!1s0x5216a167810cee39:0x11431abdfe4c7421!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n?authuser=0&entry=ttu"},{"@type":"Link","label":"Ryan's Twitter","uri":"https://twitter.com/Ryun1_"}]}},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Index of the certificate within the update transaction."},"action":{"type":"string","enum":["registered","deregistered","updated"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"f4097fbdb87ab7c7ab44b30d4e2b81713a058488975d1ab8b05c381dd946a393","cert_index":0,"action":"registered"},{"tx_hash":"dd3243af975be4b5bedce4e5f5b483b2386d5ad207d05e0289c1df0eb261447e","cert_index":0,"action":"deregistered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the vote transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the vote transaction."},"proposal_id":{"type":"string","description":"Governance Action Identifier (CIP-0129) of the proposal being voted on."},"proposal_tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"proposal_cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","proposal_id","proposal_tx_hash","proposal_cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"proposal_id":"gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn","proposal_tx_hash":"b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5","proposal_cert_index":0,"vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"proposal_id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","proposal_tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","proposal_cert_index":1,"vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/proposals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."}},"required":["id","tx_hash","cert_index","governance_type"]},"example":[{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals"},{"id":"gov_action1zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3","tx_hash":"71317e951b20aa46e9fbf45a46a6e950d5723a481225519655bf6c60","cert_index":4,"governance_type":"no_confidence"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/proposals/{tx_hash}/{cert_index}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)"}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{gov_action_id}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/epochs/latest":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/latest/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/{number}":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 prefix of the pool delegated to"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","pool_id","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes/{pool_id}":{"response":{"200":{"type":"array","items":{"properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/blocks/{pool_id}":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/txs/{hash}":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"block":{"type":"string","example":"356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940","description":"Block hash"},"block_height":{"type":"integer","example":123456,"description":"Block number"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"},"slot":{"type":"integer","example":42000000,"description":"Slot number"},"index":{"type":"integer","example":1,"description":"Transaction index within the block"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"},"treasury_donation":{"type":"string","example":"0","description":"Treasury donation in Lovelaces"}},"required":["hash","block","block_height","block_time","slot","index","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract","treasury_donation"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/utxos":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the input","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["address","amount","tx_hash","output_index","data_hash","inline_datum","reference_script_hash","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"consumed_by_tx":{"type":"string","nullable":true,"description":"Transaction hash that consumed the UTXO or null for unconsumed UTXOs. Always null for collateral outputs.","example":"66c29b56952f6085afac3b0632d781af78d020b080063bcfd6c54b8e2b8fed41"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}}},"required":["hash","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9t3a0tcwune5xrnfjg4q7cpvjlgx9lcv0cuqf5mhfjwrvcwrulda","description":"Delegation stake address"},"registration":{"type":"boolean","example":true,"description":"Registration boolean, false if deregistration"}},"required":["cert_index","address","registration"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction","deprecated":true},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 delegation stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 ID of delegated stake pool"},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"}},"required":["index","cert_index","address","pool_id","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 withdrawal address"},"amount":{"type":"string","example":"431833601","description":"Withdrawal amount in Lovelaces"}},"required":["address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pot":{"type":"string","enum":["reserve","treasury"],"example":"reserve","description":"Source of MIR funds"},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 stake address"},"amount":{"type":"string","example":"431833601","description":"MIR amount in Lovelaces"}},"required":["pot","cert_index","address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 encoded pool ID"},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge in Lovelaces"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool in Lovelaces"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]},"relays":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the update becomes active"}},"required":["cert_index","pool_id","vrf_key","pledge","margin_cost","fixed_cost","reward_account","owners","metadata","relays","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_retires":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 stake pool ID"},"retiring_epoch":{"type":"integer","example":216,"description":"Epoch in which the pool becomes retired"}},"required":["cert_index","pool_id","retiring_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"json_metadata":{}},"required":["label","json_metadata"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["label","cbor_metadata","metadata"]},"example":[{"label":"1968","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"script_hash":{"type":"string","example":"ec26b89af41bef0f7585353831cb5da42b5b37185e0c8a526143b824","description":"Script hash"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Redeemer data hash"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","deprecated":true,"description":"Datum hash"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_index","purpose","unit_mem","unit_steps","script_hash","redeemer_data_hash","datum_hash","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/required_signers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"witness_hash":{"type":"string","example":"d52e11f3e48436dd42dbec6d88c239732e503b8b7a32af58e5f87625","description":"Hash of the witness"}},"required":["witness_hash"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized transaction"}},"required":["cbor"],"example":{"cbor":"84a40081825820203e5b61e0949ffc8fe594727cf7ed73c7396cc2bd212af9a680c9423b5880eb00018282583900f0c60254ecb0addd4c7e40c28fd05b65014ab4c8ecece06c7dcee5a0724bf93336a8225e7ef152b41aea955173be91af19250edea1ddafab1a000f42408258390014beadb876d0a2a593fe2f1b539389e00731290910170e9a1be78e847d2ccdc7af469706878018739bcfde9ae23f009c4ae38aee0a4b4f3a1b0000000253fa0f93021a0002922d031a0303c827a100818258207d3ae39f9a1c916ac7c13f10c7d67c70b870c286a1af71485455c5022a3f391d5840e2f481acd1601a3f39fa976317bba685ddd774621a92611edaaa3df9f48a3b13d8b25ecb2f28b031c1602512418efed3033e463a0dcd22a856c808033cc9e00ff5f6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/tx/submit":{"response":{"200":{"type":"string","format":"hex","minLength":64,"maxLength":64,"example":"d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/accounts/{stake_address}":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"active":{"type":"boolean","example":true,"description":"Delegation state of the account. **Note:** For registration state, use the `registered` field instead."},"registered":{"type":"boolean","example":true,"description":"Registration state of an account"},"active_epoch":{"type":"integer","nullable":true,"example":412,"description":"Epoch of the most recent action - registration or deregistration"},"controlled_amount":{"type":"string","example":"619154618165","description":"Balance of the account in Lovelaces"},"rewards_sum":{"type":"string","example":"319154618165","description":"Sum of all rewards for the account in the Lovelaces"},"withdrawals_sum":{"type":"string","example":"12125369253","description":"Sum of all the withdrawals for the account in Lovelaces"},"reserves_sum":{"type":"string","example":"319154618165","description":"Sum of all funds from reserves for the account in the Lovelaces"},"treasury_sum":{"type":"string","example":"12000000","description":"Sum of all funds from treasury for the account in the Lovelaces"},"withdrawable_amount":{"type":"string","example":"319154618165","description":"Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces"},"pool_id":{"type":"string","nullable":true,"example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID to which this account is delegated"},"drep_id":{"type":"string","nullable":true,"example":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","description":"Bech32 drep ID to which this account is delegated"}},"required":["stake_address","active","registered","active_epoch","controlled_amount","rewards_sum","withdrawals_sum","reserves_sum","treasury_sum","withdrawable_amount","pool_id","drep_id"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/rewards":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","description":"Epoch of the associated reward"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 pool ID being delegated to"},"type":{"type":"string","enum":["leader","member","pool_deposit_refund"],"description":"Type of the reward"}},"required":["epoch","amount","pool_id","type"]},"example":[{"epoch":215,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":216,"amount":"3586329","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1337","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"leader"},{"epoch":218,"amount":"1395265","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":218,"amount":"500000000","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"pool_deposit_refund"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the stake was active"},"amount":{"type":"string","description":"Stake amount in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"}},"required":["active_epoch","amount","pool_id"]},"example":[{"active_epoch":210,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"},{"active_epoch":211,"amount":"22695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"},"tx_hash":{"type":"string","description":"Hash of the transaction containing the delegation"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the delegation"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the delegation"},"block_height":{"type":"integer","description":"Block height of the transaction containing the delegation"}},"required":["active_epoch","tx_hash","amount","pool_id","tx_slot","block_time","block_height"]},"example":[{"active_epoch":210,"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"active_epoch":242,"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"12691385","pool_id":"pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/registrations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the (de)registration certificate"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the (de)registration certificate"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the (de)registration certificate"},"block_height":{"type":"integer","description":"Block height of the transaction containing the (de)registration certificate"}},"required":["tx_hash","action","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","action":"registered","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","action":"deregistered","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the withdrawal"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the withdrawal"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the withdrawal"},"block_height":{"type":"integer","description":"Block height of the transaction containing the withdrawal"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5","amount":"454541212442","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34","amount":"97846969","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the MIR"},"amount":{"type":"string","description":"MIR amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the MIR"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the MIR"},"block_height":{"type":"integer","description":"Block height of the transaction containing the MIR"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d","amount":"2193707473","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13","amount":"14520198574","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address associated with the stake key"}},"required":["address"]},"example":[{"address":"addr1qx2kd28nq8ac5prwg32hhvudlwggpgfp8utlyqxu6wqgz62f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sy0f4qd"},{"address":"addr1qys3czp8s9thc6u2fqed9yq3h24nyw28uk0m6mkgn9dkckjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9suth4w4"},{"address":"addr1q8j55h253zcvl326sk5qdt2n8z7eghzspe0ekxgncr796s2f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sjmd35m"},{"address":"addr1q8f7gxrprank3drhx8k5grlux7ene0nlwun8y9thu8mc3yjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sls6vnt"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/assets":{"response":{"200":{"type":"array","items":{"type":"object","description":"The sum of all assets of all addresses associated with a given account","properties":{"unit":{"type":"string","format":"Concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc537061636542756433343132","quantity":"1"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"125"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/total":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","description":"Bech32 encoded stake address","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions for all addresses associated with the account"}},"required":["stake_address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 address"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["address","tx_hash","tx_index","block_height","block_time"]},"example":[{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"bd78e0e73fb1691f08746a331bd764d11552c3a36ef766d4f1a3bbdc7f29918d","tx_index":34,"block_height":7900364,"block_time":1666114079},{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180},{"address":"addr1qxrrzqsqnzqx3p8sxxsry936h6c78ml4rdl224f33l7pmcnc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgqr735lq","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/mempool":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/mempool/{hash}":{"response":{"200":{"type":"object","properties":{"tx":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"}},"required":["hash","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract"]},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["tx_hash","output_index","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}},"redeemers":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"}},"required":["tx_index","purpose","unit_mem","unit_steps"]}}},"required":["tx","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/mempool/addresses/{address}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/metadata/txs/labels":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cip10":{"type":"string","nullable":true,"description":"CIP10 defined description"},"count":{"type":"string","description":"The count of metadata entries with a specific label"}},"required":["label","cip10","count"]},"example":[{"label":"1990","cip10":null,"count":"1"},{"label":"1967","cip10":"nut.link metadata oracles registry","count":"3"},{"label":"1968","cip10":"nut.link metadata oracles data points","count":"16321"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/metadata/txs/labels/{label}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata"}},"required":["tx_hash","json_metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","json_metadata":{"ADAUSD":[{"value":"0.10409800535729975","source":"ergoOracles"}]}},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","json_metadata":{"ADAUSD":[{"value":"0.15409850555139935","source":"ergoOracles"}]}},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","json_metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/metadata/txs/labels/{label}/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["tx_hash","cbor_metadata","metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cbor_metadata":null,"metadata":null},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","cbor_metadata":null,"metadata":null},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/addresses/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/extended":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"},"decimals":{"type":"integer","nullable":true,"description":"Number of decimal places of the asset unit. Primary data source is CIP68 reference NFT with a fallback to off-chain metadata."},"has_nft_onchain_metadata":{"type":"boolean","description":"True if the latest minting transaction includes metadata (best-effort)"}},"required":["unit","quantity","decimals","has_nft_onchain_metadata"]},"example":[{"unit":"lovelace","quantity":"42000000","decimals":6,"has_nft_onchain_metadata":false},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12","decimals":null,"has_nft_onchain_metadata":true}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/total":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions on the address"}},"required":["address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos/{asset}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"},"asset":{"type":"string"}}}},"/addresses/{address}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/pools":{"response":{"200":{"type":"array","items":{"type":"string","description":"Bech32 encoded pool ID"},"example":["pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288","pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/extended":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"active_stake":{"type":"string","example":"4200000000","description":"Active delegated amount"},"live_stake":{"type":"string","example":"6900000000","description":"Currently delegated amount"},"live_saturation":{"type":"number","example":0.93},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]}},"required":["pool_id","hex","active_stake","live_stake","blocks_minted","live_saturation","declared_pledge","margin_cost","fixed_cost","metadata"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","hex":"2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1","active_stake":"1541200000","live_stake":"1541400000","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}}}},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","hex":"6b3fda88053dc2cee18a7c2736f032182fcc78a2fe912e869aa4edcd","active_stake":"22200000","live_stake":"48955550","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","hex":"73318ec975cf1125a6367cbb1c9a406cbcb3e510e49d7c3aab14aa31","active_stake":"9989541215","live_stake":"168445464878","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retired":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retiring":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/{pool_id}":{"response":{"200":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"blocks_epoch":{"type":"integer","example":4,"description":"Number of blocks minted in the current epoch"},"live_stake":{"type":"string","example":"6900000000"},"live_size":{"type":"number","example":0.42},"live_saturation":{"type":"number","example":0.93},"live_delegators":{"type":"number","example":127},"active_stake":{"type":"string","example":"4200000000"},"active_size":{"type":"number","example":0.43},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"live_pledge":{"type":"string","example":"5000000001","description":"Stake pool current pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"registration":{"type":"array","items":{"type":"string","description":"Hash of the transaction including registration"},"example":["9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc","7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95","3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9"]},"retirement":{"type":"array","items":{"type":"string","description":"Hash of the transaction including retirement","example":"252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8"}},"calidus_key":{"type":"object","nullable":true,"description":"Last valid Calidus key for the pool","properties":{"id":{"type":"string","example":"calidus15yt3nqapz799tvp2lt8adttt29k6xa2xnltahn655tu4sgcph42p7","description":"A Bech32-encoded identifier derived from the calidus public key"},"pub_key":{"type":"string","example":"57758911253f6b31df2a87c10eb08a2c9b8450768cb8dd0d378d93f7c2e220f0","description":"The raw hexadecimal-encoded calidus public key used for verification purposes"},"nonce":{"type":"integer","example":149292000,"description":"A unique number used once to prevent replay attacks and ensure the uniqueness of the key registration"},"tx_hash":{"type":"string","example":"f45ed21c6bc1832cf7f11f4bd6ee47ca9684b4f6f8ff8a398aa2df065eac0ba8","description":"The transaction hash that submitted the Calidus key registration"},"block_height":{"type":"integer","example":11548408,"description":"The block height at which this key registration was recorded"},"block_time":{"type":"integer","example":1740858988,"description":"Block time of the key registration"},"epoch":{"type":"integer","example":543,"description":"Epoch number of the key registration"}},"required":["id","pub_key","nonce","tx_hash","block_height","block_time","epoch"]}},"required":["pool_id","hex","vrf_key","blocks_minted","blocks_epoch","live_stake","live_size","live_saturation","live_delegators","active_stake","active_size","declared_pledge","live_pledge","margin_cost","fixed_cost","reward_account","owners","registration","retirement","calidus_key"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":233,"description":"Epoch number"},"blocks":{"type":"integer","example":22,"description":"Number of blocks created by pool"},"active_stake":{"type":"string","example":"20485965693569","description":"Active (Snapshot of live stake 2 epochs ago) stake in Lovelaces"},"active_size":{"type":"number","example":1.2345,"description":"Pool size (percentage) of overall active stake at that epoch"},"delegators_count":{"type":"integer","example":115,"description":"Number of delegators for epoch"},"rewards":{"type":"string","example":"206936253674159","description":"Total rewards received before distribution to delegators"},"fees":{"type":"string","example":"1290968354","description":"Pool operator rewards"}},"required":["epoch","blocks","active_stake","active_size","delegators_count","rewards","fees"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/metadata":{"response":{"200":{"anyOf":[{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID"},"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["pool_id","hex","url","hash","ticker","name","description","homepage"]},{"type":"object"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/relays":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"live_stake":{"type":"string","description":"Currently delegated amount"}},"required":["address","live_stake"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","live_stake":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","live_stake":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","live_stake":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Block hashes"},"example":["d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d","026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c","bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c","86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Certificate within the transaction"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","cert_index":0,"action":"registered"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","cert_index":0,"action":"deregistered"},{"tx_hash":"e14a75b0eb2625de7055f1f580d70426311b78e0d36dd695a6bdc96c7b3d80e0","cert_index":1,"action":"registered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"vote":"yes"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/assets":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","format":"Concatenation of the policy_id and hex-encoded asset_name","description":"Asset identifier"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e75d","quantity":"100000"},{"asset":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/assets/{asset}":{"response":{"200":{"type":"object","properties":{"asset":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","description":"Hex-encoded asset full name"},"policy_id":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7","description":"Policy ID of the asset"},"asset_name":{"type":"string","nullable":true,"example":"6e7574636f696e","description":"Hex-encoded asset name of the asset"},"fingerprint":{"type":"string","example":"asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w","description":"CIP14 based user-facing fingerprint"},"quantity":{"type":"string","example":"12000","description":"Current asset quantity"},"initial_mint_tx_hash":{"type":"string","example":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","description":"ID of the initial minting transaction"},"mint_or_burn_count":{"type":"integer","example":1,"description":"Count of mint and burn transactions"},"onchain_metadata":{"type":"object","nullable":true,"additionalProperties":true,"description":"On-chain metadata which SHOULD adhere to the valid standards,\nbased on which we perform the look up and display the asset\n(best effort)\n"},"onchain_metadata_standard":{"type":"string","nullable":true,"enum":["CIP25v1","CIP25v2","CIP68v1","CIP68v2","CIP68v3"],"description":"If on-chain metadata passes validation, we display the standard\nunder which it is valid\n"},"onchain_metadata_extra":{"type":"string","nullable":true,"description":"Arbitrary plutus data (CIP68).\n"},"metadata":{"type":"object","nullable":true,"description":"Off-chain metadata fetched from GitHub based on network.\nMainnet: https://github.com/cardano-foundation/cardano-token-registry/\nTestnet: https://github.com/input-output-hk/metadata-registry-testnet/\n","properties":{"name":{"type":"string","example":"nutcoin","description":"Asset name"},"description":{"type":"string","example":"The Nut Coin","description":"Asset description"},"ticker":{"type":"string","nullable":true,"example":"nutc"},"url":{"type":"string","nullable":true,"example":"https://www.stakenuts.com/","description":"Asset website"},"logo":{"type":"string","nullable":true,"example":"iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII=","description":"Base64 encoded logo of the asset"},"decimals":{"type":"integer","nullable":true,"maximum":255,"example":6,"description":"Number of decimal places of the asset unit"}},"required":["name","description","ticker","url","logo","decimals"]}},"required":["asset","policy_id","asset_name","fingerprint","quantity","initial_mint_tx_hash","mint_or_burn_count","metadata","onchain_metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the asset action"},"action":{"type":"string","enum":["minted","burned"],"description":"Action executed upon the asset policy"},"amount":{"type":"string","description":"Asset amount of the specific action"}},"required":["tx_hash","action","amount"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"10","action":"minted"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","amount":"5","action":"burned"},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"5","action":"burned"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address containing the specific asset"},"quantity":{"type":"string","description":"Asset quantity on the specific address"}},"required":["address","quantity"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","quantity":"1"},{"address":"addr1qyhr4exrgavdcn3qhfcc9f939fzsch2re5ry9cwvcdyh4x4re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qdpvhza","quantity":"100000"},{"address":"addr1q8zup8m9ue3p98kxlxl9q8rnyan8hw3ul282tsl9s326dfj088lvedv4zckcj24arcpasr0gua4c5gq4zw2rpcpjk2lq8cmd9l","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/policy/{policy_id}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"Concatenation of the policy_id and hex-encoded asset_name"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a766e","quantity":"100000"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb574636f696e","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"policy_id":{"type":"string"}}}},"/scripts":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"script_hash":{"type":"string","description":"Script hash"}},"required":["script_hash"]},"example":[{"script_hash":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},{"script_hash":"e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e"},{"script_hash":"a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/scripts/{script_hash}":{"response":{"200":{"type":"object","properties":{"script_hash":{"type":"string","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1","description":"Script hash"},"type":{"type":"string","enum":["timelock","plutusV1","plutusV2","plutusV3"],"example":"plutusV1","description":"Type of the script language"},"serialised_size":{"type":"integer","nullable":true,"description":"The size of the CBOR serialised script, if a Plutus script","example":3119}},"required":["script_hash","type","serialised_size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/json":{"response":{"200":{"type":"object","properties":{"json":{"nullable":true}},"required":["json"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","nullable":true,"description":"CBOR contents of the `plutus` script, null for `timelocks`"}},"required":["cbor"],"example":{"cbor":"4e4d01000033222220051200120011"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the transaction"},"tx_index":{"type":"integer","example":0,"description":"The index of the redeemer pointer in the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash of the redeemer"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash","deprecated":true},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_hash","tx_index","purpose","redeemer_data_hash","datum_hash","unit_mem","unit_steps","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}":{"response":{"200":{"type":"object","properties":{"json_value":{"type":"object","additionalProperties":true,"description":"JSON content of the datum"}},"required":["json_value"],"example":{"json_value":{"int":42}}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized datum"}},"required":["cbor"],"example":{"cbor":"19a6aa"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/utils/addresses/xpub/{xpub}/{role}/{index}":{"response":{"200":{"type":"object","properties":{"xpub":{"type":"string","description":"Script hash"},"role":{"type":"integer","description":"Account role"},"index":{"type":"integer","description":"Address index"},"address":{"type":"string","description":"Derived address"}},"required":["xpub","role","index","address"],"example":[{"xpub":"d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a","role":0,"index":0,"address":"addr1q90sqnljxky88s0jsnps48jd872p7znzwym0jpzqnax6qs5nfrlkaatu28n0qzmqh7f2cpksxhpc9jefx3wrl0a2wu8q5amen7"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"xpub":{"type":"string"},"role":{"type":"integer"},"index":{"type":"integer"}}}},"/utils/txs/evaluate":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/utils/txs/evaluate/utxos":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/ipfs/add":{"response":{"200":{"type":"object","properties":{"name":{"type":"string","example":"README.md","description":"Name of the file"},"ipfs_hash":{"type":"string","example":"QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr","description":"IPFS hash of the file"},"size":{"type":"string","example":"125297","description":"IPFS node size in Bytes"}},"required":["name","ipfs_hash","size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/ipfs/gateway/{IPFS_path}":{"response":{"200":{"type":"string","format":"binary"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/add/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"queued","description":"State of the pin action"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["ipfs_hash","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"filecoin":{"type":"boolean"}}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/list":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time_created":{"type":"integer","description":"Creation time of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Pin time of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object, which is `queued` when we are retriving object. If this\nis successful the state is changed to `pinned` or `failed` if not. The state `gc` means the\npinned item has been garbage collected due to account being over storage quota or after it has\nbeen moved to `unpinned` state by removing the object pin.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/ipfs/pin/list/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"time_created":{"type":"integer","description":"Time of the creation of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Time of the pin of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`.\nWhen the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`.\nIf the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise.\nWhen object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection.\nState `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/ipfs/pin/remove/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"unpinned","description":"State of the pin action"}},"required":["ipfs_hash","state"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/metrics":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day"}},"required":["time","calls"]},"example":[{"time":1612543884,"calls":42},{"time":1614523884,"calls":6942}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/metrics/endpoints":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day and endpoint"},"endpoint":{"type":"string","description":"Endpoint parent name"}},"required":["time","calls","endpoint"]},"example":[{"time":1612543814,"calls":182,"endpoint":"block"},{"time":1612543814,"calls":42,"endpoint":"epoch"},{"time":1612543812,"calls":775,"endpoint":"block"},{"time":1612523884,"calls":4,"endpoint":"epoch"},{"time":1612553884,"calls":89794,"endpoint":"block"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network":{"response":{"200":{"type":"object","properties":{"supply":{"type":"object","properties":{"max":{"type":"string","description":"Maximum supply in Lovelaces","example":"45000000000000000"},"total":{"type":"string","description":"Current total (max supply - reserves) supply in Lovelaces","example":"32890715183299160"},"circulating":{"type":"string","description":"Current circulating (UTXOs + withdrawables) supply in Lovelaces","example":"32412601976210393"},"locked":{"type":"string","description":"Current supply locked by scripts in Lovelaces","example":"125006953355"},"treasury":{"type":"string","description":"Current supply locked in treasury","example":"98635632000000"},"reserves":{"type":"string","description":"Current supply locked in reserves","example":"46635632000000"}},"required":["max","total","circulating","locked","treasury","reserves"]},"stake":{"type":"object","properties":{"live":{"type":"string","example":"23204950463991654","description":"Current live stake in Lovelaces"},"active":{"type":"string","description":"Current active stake in Lovelaces","example":"22210233523456321"}},"required":["live","active"]}},"required":["supply","stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network/eras":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"start":{"type":"object","description":"Start of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"end":{"type":"object","description":"End of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"parameters":{"type":"object","description":"Era parameters","properties":{"epoch_length":{"type":"integer","description":"Epoch length in number of slots"},"slot_length":{"type":"integer","description":"Slot length in seconds"},"safe_zone":{"type":"integer","description":"Zone in which it is guaranteed that no hard fork can take place"}},"required":["epoch_length","slot_length","safe_zone"]}},"required":["start","end","parameters"]},"example":[{"start":{"time":0,"slot":0,"epoch":0},"end":{"time":89856000,"slot":4492800,"epoch":208},"parameters":{"epoch_length":21600,"slot_length":20,"safe_zone":4320}},{"start":{"time":89856000,"slot":4492800,"epoch":208},"end":{"time":101952000,"slot":16588800,"epoch":236},"parameters":{"epoch_length":432000,"slot_length":1,"safe_zone":129600}}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/nutlink/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"metadata_url":{"type":"string","description":"URL of the specific metadata file","example":"https://nut.link/metadata.json"},"metadata_hash":{"type":"string","description":"Hash of the metadata file","example":"6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af"},"metadata":{"type":"object","nullable":true,"description":"The cached metadata of the `metadata_url` file.","additionalProperties":true}},"required":["address","metadata_url","metadata_hash","metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the ticker"},"count":{"type":"integer","description":"Number of ticker records"},"latest_block":{"type":"integer","description":"Block height of the latest record"}},"required":["name","count","latest_block"]},"example":[{"name":"ADAUSD","count":1980038,"latest_block":2657092},{"name":"ADAEUR","count":1980038,"latest_block":2657092},{"name":"ADABTC","count":1980038,"latest_block":2657092}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_height":{"type":"integer"},"tx_index":{"type":"integer"},"payload":{}},"required":["tx_hash","tx_index","block_height","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/nutlink/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"block_height":{"type":"integer","description":"Block height of the record"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"payload":{}},"required":["address","tx_hash","block_height","tx_index","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker for the pool record"}}}}} +{"/":{"response":{"200":{"type":"object","properties":{"url":{"type":"string","example":"https://blockfrost.io/"},"version":{"type":"string","example":"0.1.0"}},"required":["url","version"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health":{"response":{"200":{"type":"object","properties":{"is_healthy":{"type":"boolean","example":true}},"required":["is_healthy"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health/clock":{"response":{"200":{"type":"object","properties":{"server_time":{"type":"integer","format":"int64","example":1603400958947}},"required":["server_time"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/latest/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/{hash_or_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"slot_number":{"type":"integer"}}}},"/blocks/epoch/{epoch_number}/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"epoch_number":{"type":"integer"},"slot_number":{"type":"integer"}}}},"/blocks/{hash_or_number}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address that was affected in the specified block"},"transactions":{"type":"array","description":"List of transactions containing the address either in their inputs or outputs. Sorted by transaction index within a block, ascending.","items":{"type":"object","properties":{"tx_hash":{"type":"string"}},"required":["tx_hash"]}}},"required":["address","transactions"]},"example":[{"address":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157d0"}]}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/genesis":{"response":{"200":{"type":"object","properties":{"active_slots_coefficient":{"type":"number","example":0.05,"description":"The proportion of slots in which blocks should be issued"},"update_quorum":{"type":"integer","example":5,"description":"Determines the quorum needed for votes on the protocol parameter updates"},"max_lovelace_supply":{"type":"string","example":"45000000000000000","description":"The total number of lovelace in the system"},"network_magic":{"type":"integer","example":764824073,"description":"Network identifier"},"epoch_length":{"type":"integer","example":432000,"description":"Number of slots in an epoch"},"system_start":{"type":"integer","example":1506203091,"description":"Time of slot 0 in UNIX time"},"slots_per_kes_period":{"type":"integer","example":129600,"description":"Number of slots in an KES period"},"slot_length":{"type":"integer","example":1,"description":"Duration of one slot in seconds"},"max_kes_evolutions":{"type":"integer","example":62,"description":"The maximum number of time a KES key can be evolved before a pool operator must create a new operational certificate"},"security_param":{"type":"integer","example":2160,"description":"Security parameter k"}},"required":["active_slots_coefficient","update_quorum","max_lovelace_supply","network_magic","epoch_length","system_start","slots_per_kes_period","slot_length","max_kes_evolutions","security_param"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/governance/dreps":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"drep_id":{"type":"string","description":"The Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"}},"required":["drep_id","hex"]},"example":[{"drep_id":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","hex":"db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23"},{"drep_id":"drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4","hex":"c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/dreps/{drep_id}":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"amount":{"type":"string","description":"The total amount of voting power this DRep is delegated."},"active":{"type":"boolean","description":"Registration state of the DRep","deprecated":true},"active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent registration","deprecated":true},"has_script":{"type":"boolean","description":"Flag which shows if this DRep credentials are a script hash"},"retired":{"type":"boolean","description":"Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`."},"expired":{"type":"boolean","description":"Whether the DRep has been inactive for a consecutive number of epochs (determined by a epoch parameter `drep_activity`)"},"last_active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent action - registration, update, deregistration or voting"}},"required":["drep_id","hex","amount","active","active_epoch","has_script","retired","expired","last_active_epoch"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","amount":"2000000","active":true,"active_epoch":420,"has_script":true,"last_active_epoch":509,"retired":false,"expired":false}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"amount":{"type":"string","description":"Currently delegated amount"}},"required":["address","amount"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","amount":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","amount":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","amount":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/metadata":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded addresses"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"url":{"type":"string","example":"https://stakenuts.com/drep.json","description":"URL to the drep metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-119)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["drep_id","hex","url","hash","json_metadata","bytes"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","url":"https://aaa.xyz/drep.json","hash":"a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de","json_metadata":{"@context":{"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP119":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#","hashAlgorithm":"CIP100:hashAlgorithm","body":{"@id":"CIP119:body","@context":{"references":{"@id":"CIP119:references","@container":"@set","@context":{"GovernanceMetadata":"CIP100:GovernanceMetadataReference","Other":"CIP100:OtherReference","label":"CIP100:reference-label","uri":"CIP100:reference-uri"}},"paymentAddress":"CIP119:paymentAddress","givenName":"CIP119:givenName","image":{"@id":"CIP119:image","@context":{"ImageObject":"https://schema.org/ImageObject"}},"objectives":"CIP119:objectives","motivations":"CIP119:motivations","qualifications":"CIP119:qualifications"}}},"hashAlgorithm":"blake2b-256","body":{"paymentAddress":"addr1q86dnpkva4mm859c8ur7tjxn57zgsu6vg8pdetkdve3fsacnq7twy06u2ev5759vutpjgzfryx0ud8hzedhzerava35qwh3x34","givenName":"Ryan Williams","image":{"@type":"ImageObject","contentUrl":"https://avatars.githubusercontent.com/u/44342099?v=4","sha256":"2a21e4f7b20c8c72f573707b068fb8fc6d8c64d5035c4e18ecae287947fe2b2e"},"objectives":"Buy myself an island.","motivations":"I really would like to own an island.","qualifications":"I have my 100m swimming badge, so I would be qualified to be able to swim around island.","references":[{"@type":"Other","label":"A cool island for Ryan","uri":"https://www.google.com/maps/place/World's+only+5th+order+recursive+island/@62.6511465,-97.7946829,15.75z/data=!4m14!1m7!3m6!1s0x5216a167810cee39:0x11431abdfe4c7421!2sWorld's+only+5th+order+recursive+island!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n!3m5!1s0x5216a167810cee39:0x11431abdfe4c7421!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n?authuser=0&entry=ttu"},{"@type":"Link","label":"Ryan's Twitter","uri":"https://twitter.com/Ryun1_"}]}},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Index of the certificate within the update transaction."},"action":{"type":"string","enum":["registered","deregistered","updated"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"f4097fbdb87ab7c7ab44b30d4e2b81713a058488975d1ab8b05c381dd946a393","cert_index":0,"action":"registered"},{"tx_hash":"dd3243af975be4b5bedce4e5f5b483b2386d5ad207d05e0289c1df0eb261447e","cert_index":0,"action":"deregistered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the vote transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the vote transaction."},"proposal_id":{"type":"string","description":"Governance Action Identifier (CIP-0129) of the proposal being voted on."},"proposal_tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"proposal_cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","proposal_id","proposal_tx_hash","proposal_cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"proposal_id":"gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn","proposal_tx_hash":"b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5","proposal_cert_index":0,"vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"proposal_id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","proposal_tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","proposal_cert_index":1,"vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/proposals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."}},"required":["id","tx_hash","cert_index","governance_type"]},"example":[{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals"},{"id":"gov_action1zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3","tx_hash":"71317e951b20aa46e9fbf45a46a6e950d5723a481225519655bf6c60","cert_index":4,"governance_type":"no_confidence"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/proposals/{tx_hash}/{cert_index}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)"}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{gov_action_id}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/epochs/latest":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/latest/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/{number}":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 prefix of the pool delegated to"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","pool_id","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes/{pool_id}":{"response":{"200":{"type":"array","items":{"properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/blocks/{pool_id}":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/txs/{hash}":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"block":{"type":"string","example":"356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940","description":"Block hash"},"block_height":{"type":"integer","example":123456,"description":"Block number"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"},"slot":{"type":"integer","example":42000000,"description":"Slot number"},"index":{"type":"integer","example":1,"description":"Transaction index within the block"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"},"treasury_donation":{"type":"string","example":"0","description":"Treasury donation in Lovelaces"}},"required":["hash","block","block_height","block_time","slot","index","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract","treasury_donation"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/utxos":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the input","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["address","amount","tx_hash","output_index","data_hash","inline_datum","reference_script_hash","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"consumed_by_tx":{"type":"string","nullable":true,"description":"Transaction hash that consumed the UTXO or null for unconsumed UTXOs. Always null for collateral outputs.","example":"66c29b56952f6085afac3b0632d781af78d020b080063bcfd6c54b8e2b8fed41"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}}},"required":["hash","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9t3a0tcwune5xrnfjg4q7cpvjlgx9lcv0cuqf5mhfjwrvcwrulda","description":"Delegation stake address"},"registration":{"type":"boolean","example":true,"description":"Registration boolean, false if deregistration"}},"required":["cert_index","address","registration"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction","deprecated":true},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 delegation stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 ID of delegated stake pool"},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"}},"required":["index","cert_index","address","pool_id","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 withdrawal address"},"amount":{"type":"string","example":"431833601","description":"Withdrawal amount in Lovelaces"}},"required":["address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pot":{"type":"string","enum":["reserve","treasury"],"example":"reserve","description":"Source of MIR funds"},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 stake address"},"amount":{"type":"string","example":"431833601","description":"MIR amount in Lovelaces"}},"required":["pot","cert_index","address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 encoded pool ID"},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge in Lovelaces"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool in Lovelaces"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]},"relays":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the update becomes active"}},"required":["cert_index","pool_id","vrf_key","pledge","margin_cost","fixed_cost","reward_account","owners","metadata","relays","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_retires":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 stake pool ID"},"retiring_epoch":{"type":"integer","example":216,"description":"Epoch in which the pool becomes retired"}},"required":["cert_index","pool_id","retiring_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"json_metadata":{}},"required":["label","json_metadata"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["label","cbor_metadata","metadata"]},"example":[{"label":"1968","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"script_hash":{"type":"string","example":"ec26b89af41bef0f7585353831cb5da42b5b37185e0c8a526143b824","description":"Script hash"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Redeemer data hash"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","deprecated":true,"description":"Datum hash"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_index","purpose","unit_mem","unit_steps","script_hash","redeemer_data_hash","datum_hash","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/required_signers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"witness_hash":{"type":"string","example":"d52e11f3e48436dd42dbec6d88c239732e503b8b7a32af58e5f87625","description":"Hash of the witness"}},"required":["witness_hash"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized transaction"}},"required":["cbor"],"example":{"cbor":"84a40081825820203e5b61e0949ffc8fe594727cf7ed73c7396cc2bd212af9a680c9423b5880eb00018282583900f0c60254ecb0addd4c7e40c28fd05b65014ab4c8ecece06c7dcee5a0724bf93336a8225e7ef152b41aea955173be91af19250edea1ddafab1a000f42408258390014beadb876d0a2a593fe2f1b539389e00731290910170e9a1be78e847d2ccdc7af469706878018739bcfde9ae23f009c4ae38aee0a4b4f3a1b0000000253fa0f93021a0002922d031a0303c827a100818258207d3ae39f9a1c916ac7c13f10c7d67c70b870c286a1af71485455c5022a3f391d5840e2f481acd1601a3f39fa976317bba685ddd774621a92611edaaa3df9f48a3b13d8b25ecb2f28b031c1602512418efed3033e463a0dcd22a856c808033cc9e00ff5f6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/tx/submit":{"response":{"200":{"type":"string","format":"hex","minLength":64,"maxLength":64,"example":"d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/accounts/{stake_address}":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"active":{"type":"boolean","example":true,"description":"Delegation state of the account. **Note:** For registration state, use the `registered` field instead."},"registered":{"type":"boolean","example":true,"description":"Registration state of an account"},"active_epoch":{"type":"integer","nullable":true,"example":412,"description":"Epoch of the most recent action - registration or deregistration"},"controlled_amount":{"type":"string","example":"619154618165","description":"Balance of the account in Lovelaces"},"rewards_sum":{"type":"string","example":"319154618165","description":"Sum of all rewards for the account in the Lovelaces"},"withdrawals_sum":{"type":"string","example":"12125369253","description":"Sum of all the withdrawals for the account in Lovelaces"},"reserves_sum":{"type":"string","example":"319154618165","description":"Sum of all funds from reserves for the account in the Lovelaces"},"treasury_sum":{"type":"string","example":"12000000","description":"Sum of all funds from treasury for the account in the Lovelaces"},"withdrawable_amount":{"type":"string","example":"319154618165","description":"Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces"},"pool_id":{"type":"string","nullable":true,"example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID to which this account is delegated"},"drep_id":{"type":"string","nullable":true,"example":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","description":"Bech32 drep ID to which this account is delegated"}},"required":["stake_address","active","registered","active_epoch","controlled_amount","rewards_sum","withdrawals_sum","reserves_sum","treasury_sum","withdrawable_amount","pool_id","drep_id"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/rewards":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","description":"Epoch of the associated reward"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 pool ID being delegated to"},"type":{"type":"string","enum":["leader","member","pool_deposit_refund"],"description":"Type of the reward"}},"required":["epoch","amount","pool_id","type"]},"example":[{"epoch":215,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":216,"amount":"3586329","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1337","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"leader"},{"epoch":218,"amount":"1395265","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":218,"amount":"500000000","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"pool_deposit_refund"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the stake was active"},"amount":{"type":"string","description":"Stake amount in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"}},"required":["active_epoch","amount","pool_id"]},"example":[{"active_epoch":210,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"},{"active_epoch":211,"amount":"22695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"},"tx_hash":{"type":"string","description":"Hash of the transaction containing the delegation"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the delegation"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the delegation"},"block_height":{"type":"integer","description":"Block height of the transaction containing the delegation"}},"required":["active_epoch","tx_hash","amount","pool_id","tx_slot","block_time","block_height"]},"example":[{"active_epoch":210,"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"active_epoch":242,"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"12691385","pool_id":"pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/registrations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the (de)registration certificate"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the (de)registration certificate"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the (de)registration certificate"},"block_height":{"type":"integer","description":"Block height of the transaction containing the (de)registration certificate"}},"required":["tx_hash","action","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","action":"registered","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","action":"deregistered","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the withdrawal"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the withdrawal"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the withdrawal"},"block_height":{"type":"integer","description":"Block height of the transaction containing the withdrawal"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5","amount":"454541212442","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34","amount":"97846969","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the MIR"},"amount":{"type":"string","description":"MIR amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the MIR"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the MIR"},"block_height":{"type":"integer","description":"Block height of the transaction containing the MIR"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d","amount":"2193707473","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13","amount":"14520198574","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address associated with the stake key"}},"required":["address"]},"example":[{"address":"addr1qx2kd28nq8ac5prwg32hhvudlwggpgfp8utlyqxu6wqgz62f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sy0f4qd"},{"address":"addr1qys3czp8s9thc6u2fqed9yq3h24nyw28uk0m6mkgn9dkckjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9suth4w4"},{"address":"addr1q8j55h253zcvl326sk5qdt2n8z7eghzspe0ekxgncr796s2f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sjmd35m"},{"address":"addr1q8f7gxrprank3drhx8k5grlux7ene0nlwun8y9thu8mc3yjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sls6vnt"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/assets":{"response":{"200":{"type":"array","items":{"type":"object","description":"The sum of all assets of all addresses associated with a given account","properties":{"unit":{"type":"string","format":"Concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc537061636542756433343132","quantity":"1"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"125"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/total":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","description":"Bech32 encoded stake address","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions for all addresses associated with the account"}},"required":["stake_address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 address"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["address","tx_hash","tx_index","block_height","block_time"]},"example":[{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"bd78e0e73fb1691f08746a331bd764d11552c3a36ef766d4f1a3bbdc7f29918d","tx_index":34,"block_height":7900364,"block_time":1666114079},{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180},{"address":"addr1qxrrzqsqnzqx3p8sxxsry936h6c78ml4rdl224f33l7pmcnc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgqr735lq","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/mempool":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/mempool/{hash}":{"response":{"200":{"type":"object","properties":{"tx":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"}},"required":["hash","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract"]},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["tx_hash","output_index","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}},"redeemers":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"}},"required":["tx_index","purpose","unit_mem","unit_steps"]}}},"required":["tx","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/mempool/addresses/{address}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/metadata/txs/labels":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cip10":{"type":"string","nullable":true,"description":"CIP10 defined description"},"count":{"type":"string","description":"The count of metadata entries with a specific label"}},"required":["label","cip10","count"]},"example":[{"label":"1990","cip10":null,"count":"1"},{"label":"1967","cip10":"nut.link metadata oracles registry","count":"3"},{"label":"1968","cip10":"nut.link metadata oracles data points","count":"16321"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/metadata/txs/labels/{label}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata"}},"required":["tx_hash","json_metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","json_metadata":{"ADAUSD":[{"value":"0.10409800535729975","source":"ergoOracles"}]}},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","json_metadata":{"ADAUSD":[{"value":"0.15409850555139935","source":"ergoOracles"}]}},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","json_metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/metadata/txs/labels/{label}/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["tx_hash","cbor_metadata","metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cbor_metadata":null,"metadata":null},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","cbor_metadata":null,"metadata":null},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/addresses/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/extended":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"},"decimals":{"type":"integer","nullable":true,"description":"Number of decimal places of the asset unit. Primary data source is CIP68 reference NFT with a fallback to off-chain metadata."},"has_nft_onchain_metadata":{"type":"boolean","description":"True if the latest minting transaction includes metadata (best-effort)"}},"required":["unit","quantity","decimals","has_nft_onchain_metadata"]},"example":[{"unit":"lovelace","quantity":"42000000","decimals":6,"has_nft_onchain_metadata":false},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12","decimals":null,"has_nft_onchain_metadata":true}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/total":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions on the address"}},"required":["address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos/{asset}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"},"asset":{"type":"string"}}}},"/addresses/{address}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/pools":{"response":{"200":{"type":"array","items":{"type":"string","description":"Bech32 encoded pool ID"},"example":["pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288","pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/extended":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"active_stake":{"type":"string","example":"4200000000","description":"Active delegated amount"},"live_stake":{"type":"string","example":"6900000000","description":"Currently delegated amount"},"live_saturation":{"type":"number","example":0.93},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]}},"required":["pool_id","hex","active_stake","live_stake","blocks_minted","live_saturation","declared_pledge","margin_cost","fixed_cost","metadata"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","hex":"2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1","active_stake":"1541200000","live_stake":"1541400000","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}}}},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","hex":"6b3fda88053dc2cee18a7c2736f032182fcc78a2fe912e869aa4edcd","active_stake":"22200000","live_stake":"48955550","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","hex":"73318ec975cf1125a6367cbb1c9a406cbcb3e510e49d7c3aab14aa31","active_stake":"9989541215","live_stake":"168445464878","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retired":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retiring":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/{pool_id}":{"response":{"200":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"blocks_epoch":{"type":"integer","example":4,"description":"Number of blocks minted in the current epoch"},"live_stake":{"type":"string","example":"6900000000"},"live_size":{"type":"number","example":0.42},"live_saturation":{"type":"number","example":0.93},"live_delegators":{"type":"number","example":127},"active_stake":{"type":"string","example":"4200000000"},"active_size":{"type":"number","example":0.43},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"live_pledge":{"type":"string","example":"5000000001","description":"Stake pool current pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"registration":{"type":"array","items":{"type":"string","description":"Hash of the transaction including registration"},"example":["9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc","7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95","3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9"]},"retirement":{"type":"array","items":{"type":"string","description":"Hash of the transaction including retirement","example":"252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8"}},"calidus_key":{"type":"object","nullable":true,"description":"Last valid Calidus key for the pool","properties":{"id":{"type":"string","example":"calidus15yt3nqapz799tvp2lt8adttt29k6xa2xnltahn655tu4sgcph42p7","description":"A Bech32-encoded identifier derived from the calidus public key"},"pub_key":{"type":"string","example":"57758911253f6b31df2a87c10eb08a2c9b8450768cb8dd0d378d93f7c2e220f0","description":"The raw hexadecimal-encoded calidus public key used for verification purposes"},"nonce":{"type":"integer","example":149292000,"description":"A unique number used once to prevent replay attacks and ensure the uniqueness of the key registration"},"tx_hash":{"type":"string","example":"f45ed21c6bc1832cf7f11f4bd6ee47ca9684b4f6f8ff8a398aa2df065eac0ba8","description":"The transaction hash that submitted the Calidus key registration"},"block_height":{"type":"integer","example":11548408,"description":"The block height at which this key registration was recorded"},"block_time":{"type":"integer","example":1740858988,"description":"Block time of the key registration"},"epoch":{"type":"integer","example":543,"description":"Epoch number of the key registration"}},"required":["id","pub_key","nonce","tx_hash","block_height","block_time","epoch"]}},"required":["pool_id","hex","vrf_key","blocks_minted","blocks_epoch","live_stake","live_size","live_saturation","live_delegators","active_stake","active_size","declared_pledge","live_pledge","margin_cost","fixed_cost","reward_account","owners","registration","retirement","calidus_key"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":233,"description":"Epoch number"},"blocks":{"type":"integer","example":22,"description":"Number of blocks created by pool"},"active_stake":{"type":"string","example":"20485965693569","description":"Active (Snapshot of live stake 2 epochs ago) stake in Lovelaces"},"active_size":{"type":"number","example":1.2345,"description":"Pool size (percentage) of overall active stake at that epoch"},"delegators_count":{"type":"integer","example":115,"description":"Number of delegators for epoch"},"rewards":{"type":"string","example":"206936253674159","description":"Total rewards received before distribution to delegators"},"fees":{"type":"string","example":"1290968354","description":"Pool operator rewards"}},"required":["epoch","blocks","active_stake","active_size","delegators_count","rewards","fees"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/metadata":{"response":{"200":{"anyOf":[{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID"},"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["pool_id","hex","url","hash","ticker","name","description","homepage"]},{"type":"object"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/relays":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"live_stake":{"type":"string","description":"Currently delegated amount"}},"required":["address","live_stake"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","live_stake":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","live_stake":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","live_stake":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Block hashes"},"example":["d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d","026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c","bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c","86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Certificate within the transaction"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","cert_index":0,"action":"registered"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","cert_index":0,"action":"deregistered"},{"tx_hash":"e14a75b0eb2625de7055f1f580d70426311b78e0d36dd695a6bdc96c7b3d80e0","cert_index":1,"action":"registered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"vote":"yes"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/assets":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","format":"Concatenation of the policy_id and hex-encoded asset_name","description":"Asset identifier"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e75d","quantity":"100000"},{"asset":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/assets/{asset}":{"response":{"200":{"type":"object","properties":{"asset":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","description":"Hex-encoded asset full name"},"policy_id":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7","description":"Policy ID of the asset"},"asset_name":{"type":"string","nullable":true,"example":"6e7574636f696e","description":"Hex-encoded asset name of the asset"},"fingerprint":{"type":"string","example":"asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w","description":"CIP14 based user-facing fingerprint"},"quantity":{"type":"string","example":"12000","description":"Current asset quantity"},"initial_mint_tx_hash":{"type":"string","example":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","description":"ID of the initial minting transaction"},"mint_or_burn_count":{"type":"integer","example":1,"description":"Count of mint and burn transactions"},"onchain_metadata":{"type":"object","nullable":true,"additionalProperties":true,"description":"On-chain metadata which SHOULD adhere to the valid standards,\nbased on which we perform the look up and display the asset\n(best effort)\n"},"onchain_metadata_standard":{"type":"string","nullable":true,"enum":["CIP25v1","CIP25v2","CIP68v1","CIP68v2","CIP68v3"],"description":"If on-chain metadata passes validation, we display the standard\nunder which it is valid\n"},"onchain_metadata_extra":{"type":"string","nullable":true,"description":"Arbitrary plutus data (CIP68).\n"},"metadata":{"type":"object","nullable":true,"description":"Off-chain metadata fetched from GitHub based on network.\nMainnet: https://github.com/cardano-foundation/cardano-token-registry/\nTestnet: https://github.com/input-output-hk/metadata-registry-testnet/\n","properties":{"name":{"type":"string","example":"nutcoin","description":"Asset name"},"description":{"type":"string","example":"The Nut Coin","description":"Asset description"},"ticker":{"type":"string","nullable":true,"example":"nutc"},"url":{"type":"string","nullable":true,"example":"https://www.stakenuts.com/","description":"Asset website"},"logo":{"type":"string","nullable":true,"example":"iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII=","description":"Base64 encoded logo of the asset"},"decimals":{"type":"integer","nullable":true,"maximum":255,"example":6,"description":"Number of decimal places of the asset unit"}},"required":["name","description","ticker","url","logo","decimals"]}},"required":["asset","policy_id","asset_name","fingerprint","quantity","initial_mint_tx_hash","mint_or_burn_count","metadata","onchain_metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the asset action"},"action":{"type":"string","enum":["minted","burned"],"description":"Action executed upon the asset policy"},"amount":{"type":"string","description":"Asset amount of the specific action"}},"required":["tx_hash","action","amount"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"10","action":"minted"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","amount":"5","action":"burned"},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"5","action":"burned"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address containing the specific asset"},"quantity":{"type":"string","description":"Asset quantity on the specific address"}},"required":["address","quantity"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","quantity":"1"},{"address":"addr1qyhr4exrgavdcn3qhfcc9f939fzsch2re5ry9cwvcdyh4x4re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qdpvhza","quantity":"100000"},{"address":"addr1q8zup8m9ue3p98kxlxl9q8rnyan8hw3ul282tsl9s326dfj088lvedv4zckcj24arcpasr0gua4c5gq4zw2rpcpjk2lq8cmd9l","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/policy/{policy_id}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"Concatenation of the policy_id and hex-encoded asset_name"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a766e","quantity":"100000"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb574636f696e","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"policy_id":{"type":"string"}}}},"/scripts":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"script_hash":{"type":"string","description":"Script hash"}},"required":["script_hash"]},"example":[{"script_hash":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},{"script_hash":"e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e"},{"script_hash":"a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/scripts/{script_hash}":{"response":{"200":{"type":"object","properties":{"script_hash":{"type":"string","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1","description":"Script hash"},"type":{"type":"string","enum":["timelock","plutusV1","plutusV2","plutusV3"],"example":"plutusV1","description":"Type of the script language"},"serialised_size":{"type":"integer","nullable":true,"description":"The size of the CBOR serialised script, if a Plutus script","example":3119}},"required":["script_hash","type","serialised_size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/json":{"response":{"200":{"type":"object","properties":{"json":{"nullable":true}},"required":["json"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","nullable":true,"description":"CBOR contents of the `plutus` script, null for `timelocks`"}},"required":["cbor"],"example":{"cbor":"4e4d01000033222220051200120011"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the transaction"},"tx_index":{"type":"integer","example":0,"description":"The index of the redeemer pointer in the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash of the redeemer"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash","deprecated":true},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_hash","tx_index","purpose","redeemer_data_hash","datum_hash","unit_mem","unit_steps","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}":{"response":{"200":{"type":"object","properties":{"json_value":{"type":"object","additionalProperties":true,"description":"JSON content of the datum"}},"required":["json_value"],"example":{"json_value":{"int":42}}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized datum"}},"required":["cbor"],"example":{"cbor":"19a6aa"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/utils/addresses/xpub/{xpub}/{role}/{index}":{"response":{"200":{"type":"object","properties":{"xpub":{"type":"string","description":"Script hash"},"role":{"type":"integer","description":"Account role"},"index":{"type":"integer","description":"Address index"},"address":{"type":"string","description":"Derived address"}},"required":["xpub","role","index","address"],"example":[{"xpub":"d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a","role":0,"index":0,"address":"addr1q90sqnljxky88s0jsnps48jd872p7znzwym0jpzqnax6qs5nfrlkaatu28n0qzmqh7f2cpksxhpc9jefx3wrl0a2wu8q5amen7"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"xpub":{"type":"string"},"role":{"type":"integer"},"index":{"type":"integer"}}}},"/utils/txs/evaluate":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/utils/txs/evaluate/utxos":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/ipfs/add":{"response":{"200":{"type":"object","properties":{"name":{"type":"string","example":"README.md","description":"Name of the file"},"ipfs_hash":{"type":"string","example":"QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr","description":"IPFS hash of the file"},"size":{"type":"string","example":"125297","description":"IPFS node size in Bytes"}},"required":["name","ipfs_hash","size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/ipfs/gateway/{IPFS_path}":{"response":{"200":{"type":"string","format":"binary"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/add/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"queued","description":"State of the pin action"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["ipfs_hash","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"filecoin":{"type":"boolean"}}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/list":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time_created":{"type":"integer","description":"Creation time of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Pin time of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object, which is `queued` when we are retriving object. If this\nis successful the state is changed to `pinned` or `failed` if not. The state `gc` means the\npinned item has been garbage collected due to account being over storage quota or after it has\nbeen moved to `unpinned` state by removing the object pin.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/ipfs/pin/list/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"time_created":{"type":"integer","description":"Time of the creation of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Time of the pin of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`.\nWhen the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`.\nIf the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise.\nWhen object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection.\nState `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/ipfs/pin/remove/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"unpinned","description":"State of the pin action"}},"required":["ipfs_hash","state"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/metrics":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day"}},"required":["time","calls"]},"example":[{"time":1612543884,"calls":42},{"time":1614523884,"calls":6942}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/metrics/endpoints":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day and endpoint"},"endpoint":{"type":"string","description":"Endpoint parent name"}},"required":["time","calls","endpoint"]},"example":[{"time":1612543814,"calls":182,"endpoint":"block"},{"time":1612543814,"calls":42,"endpoint":"epoch"},{"time":1612543812,"calls":775,"endpoint":"block"},{"time":1612523884,"calls":4,"endpoint":"epoch"},{"time":1612553884,"calls":89794,"endpoint":"block"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network":{"response":{"200":{"type":"object","properties":{"supply":{"type":"object","properties":{"max":{"type":"string","description":"Maximum supply in Lovelaces","example":"45000000000000000"},"total":{"type":"string","description":"Current total (max supply - reserves) supply in Lovelaces","example":"32890715183299160"},"circulating":{"type":"string","description":"Current circulating (UTXOs + withdrawables) supply in Lovelaces","example":"32412601976210393"},"locked":{"type":"string","description":"Current supply locked by scripts in Lovelaces","example":"125006953355"},"treasury":{"type":"string","description":"Current supply locked in treasury","example":"98635632000000"},"reserves":{"type":"string","description":"Current supply locked in reserves","example":"46635632000000"}},"required":["max","total","circulating","locked","treasury","reserves"]},"stake":{"type":"object","properties":{"live":{"type":"string","example":"23204950463991654","description":"Current live stake in Lovelaces"},"active":{"type":"string","description":"Current active stake in Lovelaces","example":"22210233523456321"}},"required":["live","active"]}},"required":["supply","stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network/eras":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"start":{"type":"object","description":"Start of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"end":{"type":"object","description":"End of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"parameters":{"type":"object","description":"Era parameters","properties":{"epoch_length":{"type":"integer","description":"Epoch length in number of slots"},"slot_length":{"type":"integer","description":"Slot length in seconds"},"safe_zone":{"type":"integer","description":"Zone in which it is guaranteed that no hard fork can take place"}},"required":["epoch_length","slot_length","safe_zone"]}},"required":["start","end","parameters"]},"example":[{"start":{"time":0,"slot":0,"epoch":0},"end":{"time":89856000,"slot":4492800,"epoch":208},"parameters":{"epoch_length":21600,"slot_length":20,"safe_zone":4320}},{"start":{"time":89856000,"slot":4492800,"epoch":208},"end":{"time":101952000,"slot":16588800,"epoch":236},"parameters":{"epoch_length":432000,"slot_length":1,"safe_zone":129600}}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/nutlink/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"metadata_url":{"type":"string","description":"URL of the specific metadata file","example":"https://nut.link/metadata.json"},"metadata_hash":{"type":"string","description":"Hash of the metadata file","example":"6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af"},"metadata":{"type":"object","nullable":true,"description":"The cached metadata of the `metadata_url` file.","additionalProperties":true}},"required":["address","metadata_url","metadata_hash","metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the ticker"},"count":{"type":"integer","description":"Number of ticker records"},"latest_block":{"type":"integer","description":"Block height of the latest record"}},"required":["name","count","latest_block"]},"example":[{"name":"ADAUSD","count":1980038,"latest_block":2657092},{"name":"ADAEUR","count":1980038,"latest_block":2657092},{"name":"ADABTC","count":1980038,"latest_block":2657092}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_height":{"type":"integer"},"tx_index":{"type":"integer"},"payload":{}},"required":["tx_hash","tx_index","block_height","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/nutlink/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"block_height":{"type":"integer","description":"Block height of the record"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"payload":{}},"required":["address","tx_hash","block_height","tx_index","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/api/v2/status":{"response":{"200":{"type":"object","properties":{"blockbook":{"type":"object","properties":{"coin":{"type":"string"},"network":{"type":"string"},"host":{"type":"string"},"version":{"type":"string"},"gitCommit":{"type":"string"},"buildTime":{"type":"string"},"syncMode":{"type":"boolean"},"initialSync":{"type":"boolean"},"inSync":{"type":"boolean"},"bestHeight":{"type":"integer"},"lastBlockTime":{"type":"string"},"inSyncMempool":{"type":"boolean"},"lastMempoolTime":{"type":"string"},"mempoolSize":{"type":"integer"},"decimals":{"type":"integer"},"dbSize":{"type":"integer"},"hasFiatRates":{"type":"boolean"},"currentFiatRatesTime":{"type":"string"},"historicalFiatRatesTime":{"type":"string"},"about":{"type":"string"}}},"backend":{"type":"object","properties":{"chain":{"type":"string"},"blocks":{"type":"integer"},"headers":{"type":"integer"},"bestBlockHash":{"type":"string"},"difficulty":{"type":"string"},"sizeOnDisk":{"type":"integer"},"version":{"type":"string"},"subversion":{"type":"string"},"protocolVersion":{"type":"string"}}}},"x-examples":{"Example 1":{"blockbook":{"coin":"Bitcoin","host":"s4","version":"0.4.0","gitCommit":"83fe6672","buildTime":"2023-02-27T02:40:48+00:00","syncMode":true,"initialSync":false,"inSync":true,"bestHeight":784299,"lastBlockTime":"2023-04-07T02:55:40.032567054Z","inSyncMempool":true,"lastMempoolTime":"2023-04-07T03:04:36.260327616Z","mempoolSize":30785,"decimals":8,"dbSize":399834379691,"hasFiatRates":true,"currentFiatRatesTime":"2023-04-07T03:00:04.080770962Z","historicalFiatRatesTime":"2023-04-07T00:00:00Z","about":"Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook"},"backend":{"chain":"main","blocks":784299,"headers":784299,"bestBlockHash":"00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719","difficulty":"47887764338536.25","sizeOnDisk":534828732178,"version":"240001","subversion":"/Satoshi:24.0.1/","protocolVersion":"70016"}}}}}},"/api/v2/block/{blockHashOrHeight}":{"response":{"200":{"type":"object","properties":{"page":{"type":"integer"},"totalPages":{"type":"integer"},"itemsOnPage":{"type":"integer"},"hash":{"type":"string"},"previousBlockHash":{"type":"string"},"nextBlockHash":{"type":"string"},"height":{"type":"integer"},"confirmations":{"type":"integer"},"size":{"type":"integer"},"time":{"type":"integer"},"version":{"type":"integer"},"merkleRoot":{"type":"string"},"nonce":{"type":"string"},"bits":{"type":"string"},"difficulty":{"type":"string"},"txCount":{"type":"integer"},"txs":{"type":"array","items":{"type":"object","properties":{"txid":{"type":"string"},"vin":{"type":"array","items":{"type":"object","properties":{"n":{"type":"integer"},"isAddress":{"type":"boolean"},"value":{"type":"string"}}}},"vout":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"n":{"type":"integer"},"addresses":{"type":"array","items":{"type":"string"}},"isAddress":{"type":"boolean"}}}},"blockHash":{"type":"string"},"blockHeight":{"type":"integer"},"confirmations":{"type":"integer"},"blockTime":{"type":"integer"},"value":{"type":"string"},"valueIn":{"type":"string"},"fees":{"type":"string"}}}}},"x-examples":{"Example 1":{"page":1,"totalPages":1,"itemsOnPage":1000,"hash":"00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048","previousBlockHash":"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f","nextBlockHash":"000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd","height":1,"confirmations":784303,"size":215,"time":1231469665,"version":1,"merkleRoot":"0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098","nonce":"2573394689","bits":"1d00ffff","difficulty":"1","txCount":1,"txs":[{"txid":"0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098","vin":[{"n":0,"isAddress":false,"value":"0"}],"vout":[{"value":"5000000000","n":0,"addresses":["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"isAddress":true}],"blockHash":"00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048","blockHeight":1,"confirmations":784303,"blockTime":1231469665,"value":"5000000000","valueIn":"0","fees":"0"}]}}}}},"/api/v2/block-index/{blockHeight}":{"response":{"200":{"type":"object","properties":{"blockHash":{"type":"string"}},"x-examples":{"Example 1":{"blockHash":"ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e"}}}}},"/api/v2/tx-specific/{txId}":{"response":{"200":{"type":"object","additionalProperties":true}}},"/api/v2/address/{address}":{"response":{"200":{"type":"object","additionalProperties":true}}},"/api/v2/xpub/{xpub}":{"response":{"200":{"type":"object","properties":{"page":{"type":"integer"},"totalPages":{"type":"integer"},"itemsOnPage":{"type":"integer"},"address":{"type":"string"},"balance":{"type":"string"},"totalReceived":{"type":"string"},"totalSent":{"type":"string"},"unconfirmedBalance":{"type":"string"},"unconfirmedTxs":{"type":"integer"},"txs":{"type":"integer"},"txids":{"type":"array","items":{"type":"string"}},"usedTokens":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"transfers":{"type":"integer"},"decimals":{"type":"integer"},"balance":{"type":"string"},"totalReceived":{"type":"string"},"totalSent":{"type":"string"}}}},"secondaryValue":{"type":"number"}},"x-examples":{"Example 1":{"page":1,"totalPages":1,"itemsOnPage":1000,"address":"dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF","balance":"90000000","totalReceived":"3093381250","totalSent":"3083381250","unconfirmedBalance":"0","unconfirmedTxs":0,"txs":5,"txids":["383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c","75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798","e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876","57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23","9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f"],"usedTokens":2,"tokens":[{"type":"XPUBAddress","name":"DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS","path":"m/44'/3'/0'/0/0","transfers":3,"decimals":8,"balance":"90000000","totalReceived":"2903986975","totalSent":"2803986975"},{"type":"XPUBAddress","name":"DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj","path":"m/44'/3'/0'/1/0","transfers":2,"decimals":8,"balance":"0","totalReceived":"279394275","totalSent":"279394275"}],"secondaryValue":21195.47633568}}}}},"/api/v2/utxo/{addressOrXpub}":{"response":{"200":{"type":"array","items":{}}}},"/api/v2/sendtx":{"response":{"200":{"type":"object","properties":{"result":{"type":"string"}},"x-examples":{"Example 1":{"result":"7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"}}}}}} diff --git a/openapi-merge.json b/openapi-merge.json index 590694a3..77630936 100644 --- a/openapi-merge.json +++ b/openapi-merge.json @@ -3,6 +3,18 @@ { "inputFile": "./blockfrost-openapi.yaml" }, + { + "inputFile": "./blockbook.yaml", + "pathModification": { + "prepend": "/api/v2" + }, + "operationSelection": { + "includeTags": ["Bitcoin", "Litecoin", "Dogecoin"] + }, + "description": { + "append": false + } + }, { "inputFile": "./mithril.yaml", "pathModification": { diff --git a/openapi.json b/openapi.json index cbd13646..2223eacb 100644 --- a/openapi.json +++ b/openapi.json @@ -17,7 +17,7 @@ "url": "https://opensource.org/licenses/MIT" }, "termsOfService": "https://blockfrost.io/terms", - "description": "Blockfrost is an API as a service that allows users to interact with the Cardano blockchain, Midnight blockchain, and parts of their ecosystems.\n\n## Tokens\n\nAfter signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project.\nHTTP header of your request MUST include this `project_id` in order to authenticate against Blockfrost servers.\n\n## Available networks\n\nAt the moment, you can use the following networks. Please, note that each network has its own `project_id`.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n Network\n \n Endpoint\n
Cardano mainnet\n https://cardano-mainnet.blockfrost.io/api/v0\n
Cardano preprod\n https://cardano-preprod.blockfrost.io/api/v0\n
Cardano preview\n https://cardano-preview.blockfrost.io/api/v0\n
Midnight mainnet\n https://midnight-mainnet.blockfrost.io/api/v0\n
InterPlanetary File System\n https://ipfs.blockfrost.io/api/v0\n
\n\n## Concepts\n\n* All endpoints return either a JSON object or an array.\n* Data is returned in *ascending* (oldest first, newest last) order, if not stated otherwise.\n * You might use the `?order=desc` query parameter to reverse this order.\n* By default, we return 100 results at a time. You have to use `?page=2` to list through the results.\n* All time and timestamp related fields (except `server_time`) are in seconds of UNIX time.\n* All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces.\n* Addresses, accounts and pool IDs are in Bech32 format.\n* All values are case sensitive.\n* All hex encoded values are lower case.\n* Examples are not based on real data. Any resemblance to actual events is purely coincidental.\n* We allow to upload files up to 100MB of size to IPFS. This might increase in the future.\n* Only pinned IPFS files are counted towards the IPFS quota.\n* Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.\n* We allow maximum of 100 queued pins per IPFS user.\n\n## Errors\n\n### HTTP Status codes\n\nThe following are HTTP status code your application might receive when reaching Blockfrost endpoints and\nit should handle all of these cases.\n\n* HTTP `400` return code is used when the request is not valid.\n* HTTP `402` return code is used when the projects exceed their daily request limit.\n* HTTP `403` return code is used when the request is not authenticated.\n* HTTP `404` return code is used when the resource doesn't exist.\n* HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`.\n* HTTP `425` return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.\n* HTTP `425` return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.\n* HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.\n* HTTP `500` return code is used when our endpoints are having a problem.\n\n### Error codes\n\nAn internal error code number is used for better indication of the error in question. It is passed using the following payload.\n\n```json\n{\n \"status_code\": 403,\n \"error\": \"Forbidden\",\n \"message\": \"Invalid project token.\"\n}\n```\n## Limits\n\nThere are two types of limits we are enforcing:\n\nThe first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time.\n\nThe second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow\neach user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another\nwhole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed.\nWe believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and\nwe will make sure to take it into account as much as we can.\n\n## SDKs\n\nWe support a number of SDKs that will help you in developing your application on top of Blockfrost.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Programming languageSDK
JavaScript\n blockfrost-js\n
Haskell\n blockfrost-haskell\n
Python\n blockfrost-python\n
Rust\n blockfrost-rust\n
Golang\n blockfrost-go\n
Ruby\n blockfrost-ruby\n
Java\n blockfrost-java\n
Scala\n blockfrost-scala\n
Swift\n blockfrost-swift\n
Kotlin\n blockfrost-kotlin\n
Elixir\n blockfrost-elixir\n
.NET\n blockfrost-dotnet\n
Arduino\n blockfrost-arduino\n
PHP\n blockfrost-php\n
Crystal\n blockfrost-crystal\n
\n\n\n## Midnight API\n\n\nThe Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data — blocks, transactions, contracts, and wallet-related events — indexed from the Midnight blockchain.\n\nAvailable networks: `mainnet`, `preprod`, `preview`\n\n| Service | URL | Protocol |\n|---------|-----|----------|\n| **Indexer HTTP API** | `https://midnight-{network}.blockfrost.io/api/v0` | HTTP POST (GraphQL) |\n| **Indexer Subscriptions API** | `wss://midnight-{network}.blockfrost.io/api/v0/ws` | WebSocket |\n| **Node RPC** | `https://rpc.midnight-{network}.blockfrost.io` | JSON-RPC |\n\n\nFor the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference:\n\n[![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/)\n" + "description": "Blockfrost is an API as a service that allows users to interact with the Cardano blockchain, Midnight blockchain, and parts of their ecosystems.\n\n## Tokens\n\nAfter signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project.\nHTTP header of your request MUST include this `project_id` in order to authenticate against Blockfrost servers.\n\n## Available networks\n\nAt the moment, you can use the following networks. Please, note that each network has its own `project_id`.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n Network\n \n Endpoint\n
Cardano mainnet\n https://cardano-mainnet.blockfrost.io/api/v0\n
Cardano preprod\n https://cardano-preprod.blockfrost.io/api/v0\n
Cardano preview\n https://cardano-preview.blockfrost.io/api/v0\n
Midnight mainnet\n https://midnight-mainnet.blockfrost.io/api/v0\n Bitcoin mainnet\n https://bitcoin-mainnet.blockfrost.io/api/v2\n
InterPlanetary File System\n https://ipfs.blockfrost.io/api/v0\n
\n\n## Concepts\n\n* All endpoints return either a JSON object or an array.\n* Data is returned in *ascending* (oldest first, newest last) order, if not stated otherwise.\n * You might use the `?order=desc` query parameter to reverse this order.\n* By default, we return 100 results at a time. You have to use `?page=2` to list through the results.\n* All time and timestamp related fields (except `server_time`) are in seconds of UNIX time.\n* All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces.\n* Addresses, accounts and pool IDs are in Bech32 format.\n* All values are case sensitive.\n* All hex encoded values are lower case.\n* Examples are not based on real data. Any resemblance to actual events is purely coincidental.\n* We allow to upload files up to 100MB of size to IPFS. This might increase in the future.\n* Only pinned IPFS files are counted towards the IPFS quota.\n* Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.\n* We allow maximum of 100 queued pins per IPFS user.\n\n## Errors\n\n### HTTP Status codes\n\nThe following are HTTP status code your application might receive when reaching Blockfrost endpoints and\nit should handle all of these cases.\n\n* HTTP `400` return code is used when the request is not valid.\n* HTTP `402` return code is used when the projects exceed their daily request limit.\n* HTTP `403` return code is used when the request is not authenticated.\n* HTTP `404` return code is used when the resource doesn't exist.\n* HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`.\n* HTTP `425` return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.\n* HTTP `425` return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.\n* HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.\n* HTTP `500` return code is used when our endpoints are having a problem.\n\n### Error codes\n\nAn internal error code number is used for better indication of the error in question. It is passed using the following payload.\n\n```json\n{\n \"status_code\": 403,\n \"error\": \"Forbidden\",\n \"message\": \"Invalid project token.\"\n}\n```\n## Limits\n\nThere are two types of limits we are enforcing:\n\nThe first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time.\n\nThe second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow\neach user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another\nwhole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed.\nWe believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and\nwe will make sure to take it into account as much as we can.\n\n## SDKs\n\nWe support a number of SDKs that will help you in developing your application on top of Blockfrost.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Programming languageSDK
JavaScript\n blockfrost-js\n
Haskell\n blockfrost-haskell\n
Python\n blockfrost-python\n
Rust\n blockfrost-rust\n
Golang\n blockfrost-go\n
Ruby\n blockfrost-ruby\n
Java\n blockfrost-java\n
Scala\n blockfrost-scala\n
Swift\n blockfrost-swift\n
Kotlin\n blockfrost-kotlin\n
Elixir\n blockfrost-elixir\n
.NET\n blockfrost-dotnet\n
Arduino\n blockfrost-arduino\n
PHP\n blockfrost-php\n
Crystal\n blockfrost-crystal\n
\n\n\n## Midnight API\n\n\nThe Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data — blocks, transactions, contracts, and wallet-related events — indexed from the Midnight blockchain.\n\nAvailable networks: `mainnet`, `preprod`, `preview`\n\n| Service | URL | Protocol |\n|---------|-----|----------|\n| **Indexer HTTP API** | `https://midnight-{network}.blockfrost.io/api/v0` | HTTP POST (GraphQL) |\n| **Indexer Subscriptions API** | `wss://midnight-{network}.blockfrost.io/api/v0/ws` | WebSocket |\n| **Node RPC** | `https://rpc.midnight-{network}.blockfrost.io` | JSON-RPC |\n\n\nFor the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference:\n\n[![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/)\n" }, "servers": [ { @@ -49,6 +49,18 @@ { "name": "Metrics" }, + { + "name": "Bitcoin", + "description": "Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://bitcoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" + }, + { + "name": "Litecoin", + "description": "Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://litecoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" + }, + { + "name": "Dogecoin", + "description": "Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://dogecoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" + }, { "name": "Cardano » Accounts" }, @@ -9016,6 +9028,1086 @@ } } } + }, + "/api/v2/status": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "get": { + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ], + "summary": "Blockchain status", + "operationId": "getStatus", + "description": "Get current status of Blockbook and its backend", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "blockbook": { + "type": "object", + "properties": { + "coin": { + "type": "string" + }, + "network": { + "type": "string" + }, + "host": { + "type": "string" + }, + "version": { + "type": "string" + }, + "gitCommit": { + "type": "string" + }, + "buildTime": { + "type": "string" + }, + "syncMode": { + "type": "boolean" + }, + "initialSync": { + "type": "boolean" + }, + "inSync": { + "type": "boolean" + }, + "bestHeight": { + "type": "integer" + }, + "lastBlockTime": { + "type": "string" + }, + "inSyncMempool": { + "type": "boolean" + }, + "lastMempoolTime": { + "type": "string" + }, + "mempoolSize": { + "type": "integer" + }, + "decimals": { + "type": "integer" + }, + "dbSize": { + "type": "integer" + }, + "hasFiatRates": { + "type": "boolean" + }, + "currentFiatRatesTime": { + "type": "string" + }, + "historicalFiatRatesTime": { + "type": "string" + }, + "about": { + "type": "string" + } + } + }, + "backend": { + "type": "object", + "properties": { + "chain": { + "type": "string" + }, + "blocks": { + "type": "integer" + }, + "headers": { + "type": "integer" + }, + "bestBlockHash": { + "type": "string" + }, + "difficulty": { + "type": "string" + }, + "sizeOnDisk": { + "type": "integer" + }, + "version": { + "type": "string" + }, + "subversion": { + "type": "string" + }, + "protocolVersion": { + "type": "string" + } + } + } + }, + "x-examples": { + "Example 1": { + "blockbook": { + "coin": "Bitcoin", + "host": "s4", + "version": "0.4.0", + "gitCommit": "83fe6672", + "buildTime": "2023-02-27T02:40:48+00:00", + "syncMode": true, + "initialSync": false, + "inSync": true, + "bestHeight": 784299, + "lastBlockTime": "2023-04-07T02:55:40.032567054Z", + "inSyncMempool": true, + "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", + "mempoolSize": 30785, + "decimals": 8, + "dbSize": 399834379691, + "hasFiatRates": true, + "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", + "historicalFiatRatesTime": "2023-04-07T00:00:00Z", + "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + }, + "backend": { + "chain": "main", + "blocks": 784299, + "headers": 784299, + "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", + "difficulty": "47887764338536.25", + "sizeOnDisk": 534828732178, + "version": "240001", + "subversion": "/Satoshi:24.0.1/", + "protocolVersion": "70016" + } + } + } + }, + "examples": { + "Example 1": { + "value": { + "blockbook": { + "coin": "Bitcoin", + "host": "s4", + "version": "0.4.0", + "gitCommit": "83fe6672", + "buildTime": "2023-02-27T02:40:48+00:00", + "syncMode": true, + "initialSync": false, + "inSync": true, + "bestHeight": 784299, + "lastBlockTime": "2023-04-07T02:55:40.032567054Z", + "inSyncMempool": true, + "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", + "mempoolSize": 30785, + "decimals": 8, + "dbSize": 399834379691, + "hasFiatRates": true, + "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", + "historicalFiatRatesTime": "2023-04-07T00:00:00Z", + "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + }, + "backend": { + "chain": "main", + "blocks": 784299, + "headers": 784299, + "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", + "difficulty": "47887764338536.25", + "sizeOnDisk": 534828732178, + "version": "240001", + "subversion": "/Satoshi:24.0.1/", + "protocolVersion": "70016" + } + } + } + } + } + } + } + } + } + }, + "/api/v2/block/{blockHashOrHeight}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/blockHashOrHeight" + } + ], + "get": { + "summary": "Block", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "page": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + }, + "itemsOnPage": { + "type": "integer" + }, + "hash": { + "type": "string" + }, + "previousBlockHash": { + "type": "string" + }, + "nextBlockHash": { + "type": "string" + }, + "height": { + "type": "integer" + }, + "confirmations": { + "type": "integer" + }, + "size": { + "type": "integer" + }, + "time": { + "type": "integer" + }, + "version": { + "type": "integer" + }, + "merkleRoot": { + "type": "string" + }, + "nonce": { + "type": "string" + }, + "bits": { + "type": "string" + }, + "difficulty": { + "type": "string" + }, + "txCount": { + "type": "integer" + }, + "txs": { + "type": "array", + "items": { + "type": "object", + "properties": { + "txid": { + "type": "string" + }, + "vin": { + "type": "array", + "items": { + "type": "object", + "properties": { + "n": { + "type": "integer" + }, + "isAddress": { + "type": "boolean" + }, + "value": { + "type": "string" + } + } + } + }, + "vout": { + "type": "array", + "items": { + "type": "object", + "properties": { + "value": { + "type": "string" + }, + "n": { + "type": "integer" + }, + "addresses": { + "type": "array", + "items": { + "type": "string" + } + }, + "isAddress": { + "type": "boolean" + } + } + } + }, + "blockHash": { + "type": "string" + }, + "blockHeight": { + "type": "integer" + }, + "confirmations": { + "type": "integer" + }, + "blockTime": { + "type": "integer" + }, + "value": { + "type": "string" + }, + "valueIn": { + "type": "string" + }, + "fees": { + "type": "string" + } + } + } + } + }, + "x-examples": { + "Example 1": { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", + "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", + "height": 1, + "confirmations": 784303, + "size": 215, + "time": 1231469665, + "version": 1, + "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "nonce": "2573394689", + "bits": "1d00ffff", + "difficulty": "1", + "txCount": 1, + "txs": [ + { + "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "vin": [ + { + "n": 0, + "isAddress": false, + "value": "0" + } + ], + "vout": [ + { + "value": "5000000000", + "n": 0, + "addresses": [ + "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX" + ], + "isAddress": true + } + ], + "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "blockHeight": 1, + "confirmations": 784303, + "blockTime": 1231469665, + "value": "5000000000", + "valueIn": "0", + "fees": "0" + } + ] + } + } + }, + "examples": { + "Example 1": { + "value": { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", + "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", + "height": 1, + "confirmations": 784303, + "size": 215, + "time": 1231469665, + "version": 1, + "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "nonce": "2573394689", + "bits": "1d00ffff", + "difficulty": "1", + "txCount": 1, + "txs": [ + { + "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "vin": [ + { + "n": 0, + "isAddress": false, + "value": "0" + } + ], + "vout": [ + { + "value": "5000000000", + "n": 0, + "addresses": [ + "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX" + ], + "isAddress": true + } + ], + "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "blockHeight": 1, + "confirmations": 784303, + "blockTime": 1231469665, + "value": "5000000000", + "valueIn": "0", + "fees": "0" + } + ] + } + } + } + } + }, + "description": "OK" + } + }, + "operationId": "getBlockV2", + "description": "Returns information about block with transactions, subject to paging.\n\nNote: Blockbook always follows the main chain of the backend it is attached to. If there is a rollback-reorg in the backend, Blockbook will also do rollback. When you ask for block by height, you will always get the main chain block. If you ask for block by hash, you may get the block from another fork but it is not guaranteed (backend may not keep it)", + "parameters": [ + { + "$ref": "#/components/parameters/page" + }, + { + "$ref": "#/components/parameters/pageSize" + } + ], + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } + }, + "/api/v2/block-index/{blockHeight}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/blockHeight" + } + ], + "get": { + "summary": "Block hash", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "blockHash": { + "type": "string" + } + }, + "x-examples": { + "Example 1": { + "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e" + } + } + }, + "examples": { + "Example 1": { + "value": { + "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e" + } + } + } + } + } + } + }, + "operationId": "getBlockHashV2", + "description": "Get block hash by its height\n\nNote: Blockbook always follows the main chain of the backend it is attached to.", + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } + }, + "/api/v2/tx-specific/{txId}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/txId" + } + ], + "get": { + "summary": "Transaction", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true + }, + "examples": { + "zCash": { + "value": { + "hex": "040000808...8e6e73cb009", + "txid": "7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913", + "overwintered": true, + "version": 4, + "versiongroupid": "892f2085", + "locktime": 0, + "expiryheight": 495680, + "vin": [], + "vout": [], + "vjoinsplit": [], + "valueBalance": 0, + "vShieldedSpend": [ + { + "cv": "50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962", + "anchor": "6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b", + "nullifier": "08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a", + "rk": "36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2", + "proof": "aecf824dbae8eea863ec6...73878c37391f01df520aa", + "spendAuthSig": "65b9477cb1ec5da...1178fe402e5702c646945197108339609" + }, + { + "cv": "a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c", + "anchor": "6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b", + "nullifier": "60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9", + "rk": "2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117", + "proof": "a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7", + "spendAuthSig": "feea902e01eac9ebd...b43b4af6b607ce5b0b38f708" + } + ], + "vShieldedOutput": [ + { + "cv": "23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab", + "cmu": "3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc", + "ephemeralKey": "057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870", + "encCiphertext": "a533d3b99b...a0204", + "outCiphertext": "4baabc15199504b1...c1ad6a", + "proof": "aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1" + } + ], + "bindingSig": "bc018af8808387...5130bb382ad8e6e73cb009", + "blockhash": "0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af", + "confirmations": 5222, + "time": 1552301566, + "blocktime": 1552301566 + } + } + } + } + } + } + }, + "operationId": "getTxSpecificV2", + "description": "Returns transaction data in the exact format as returned by backend, including all coin specific fields", + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } + }, + "/api/v2/address/{address}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/address" + } + ], + "get": { + "summary": "Address", + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ], + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "additionalProperties": true + }, + "examples": { + "Bitcoin-like, details set to \"txids\"": { + "value": { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "address": "D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7", + "balance": "2432468097999991", + "totalReceived": "3992283916999979", + "totalSent": "1559815818999988", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 3, + "txids": [ + "461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308", + "bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10", + "5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d" + ] + } + } + } + } + } + } + }, + "operationId": "getAddressV2", + "description": "Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.\n\nThe **details** query parameter can specify the level of details returned by the request (default: \"txids\").\nPossible values are:\n\n**basic**: return only xpub balances, without any derived addresses and transactions\n\n**tokens**: basic + tokens (addresses) derived from the xpub, subject to tokens parameter\n\n**tokenBalances**: basic + tokens (addresses) derived from the xpub with balances, subject to tokens parameter\n\n**txids**: tokenBalances + list of txids, subject to from, to filter and paging\n\n**txs**: tokenBalances + list of transaction with details, subject to from, to filter and paging\n", + "parameters": [ + { + "$ref": "#/components/parameters/page" + }, + { + "$ref": "#/components/parameters/pageSize" + }, + { + "$ref": "#/components/parameters/fromBlock" + }, + { + "$ref": "#/components/parameters/toBlock" + }, + { + "$ref": "#/components/parameters/details" + } + ] + } + }, + "/api/v2/xpub/{xpub}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/xpub" + } + ], + "get": { + "summary": "Xpub", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "page": { + "type": "integer" + }, + "totalPages": { + "type": "integer" + }, + "itemsOnPage": { + "type": "integer" + }, + "address": { + "type": "string" + }, + "balance": { + "type": "string" + }, + "totalReceived": { + "type": "string" + }, + "totalSent": { + "type": "string" + }, + "unconfirmedBalance": { + "type": "string" + }, + "unconfirmedTxs": { + "type": "integer" + }, + "txs": { + "type": "integer" + }, + "txids": { + "type": "array", + "items": { + "type": "string" + } + }, + "usedTokens": { + "type": "integer" + }, + "tokens": { + "type": "array", + "items": { + "type": "object", + "properties": { + "type": { + "type": "string" + }, + "name": { + "type": "string" + }, + "path": { + "type": "string" + }, + "transfers": { + "type": "integer" + }, + "decimals": { + "type": "integer" + }, + "balance": { + "type": "string" + }, + "totalReceived": { + "type": "string" + }, + "totalSent": { + "type": "string" + } + } + } + }, + "secondaryValue": { + "type": "number" + } + }, + "x-examples": { + "Example 1": { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", + "balance": "90000000", + "totalReceived": "3093381250", + "totalSent": "3083381250", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 5, + "txids": [ + "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", + "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", + "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", + "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", + "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f" + ], + "usedTokens": 2, + "tokens": [ + { + "type": "XPUBAddress", + "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", + "path": "m/44'/3'/0'/0/0", + "transfers": 3, + "decimals": 8, + "balance": "90000000", + "totalReceived": "2903986975", + "totalSent": "2803986975" + }, + { + "type": "XPUBAddress", + "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", + "path": "m/44'/3'/0'/1/0", + "transfers": 2, + "decimals": 8, + "balance": "0", + "totalReceived": "279394275", + "totalSent": "279394275" + } + ], + "secondaryValue": 21195.47633568 + } + } + }, + "examples": { + "Example 1": { + "value": { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", + "balance": "90000000", + "totalReceived": "3093381250", + "totalSent": "3083381250", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 5, + "txids": [ + "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", + "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", + "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", + "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", + "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f" + ], + "usedTokens": 2, + "tokens": [ + { + "type": "XPUBAddress", + "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", + "path": "m/44'/3'/0'/0/0", + "transfers": 3, + "decimals": 8, + "balance": "90000000", + "totalReceived": "2903986975", + "totalSent": "2803986975" + }, + { + "type": "XPUBAddress", + "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", + "path": "m/44'/3'/0'/1/0", + "transfers": 2, + "decimals": 8, + "balance": "0", + "totalReceived": "279394275", + "totalSent": "279394275" + } + ], + "secondaryValue": 21195.47633568 + } + } + } + } + } + } + }, + "operationId": "getXpubV2", + "description": "Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins.\n\nBlockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation schemes, using either xpubs or output descriptors (see https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md)\n\nNote: usedTokens always returns total number of used addresses of xpub.\n\nDetailed documentation found here: https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub", + "parameters": [ + { + "$ref": "#/components/parameters/page" + }, + { + "$ref": "#/components/parameters/pageSize" + }, + { + "$ref": "#/components/parameters/fromBlock" + }, + { + "$ref": "#/components/parameters/toBlock" + }, + { + "$ref": "#/components/parameters/details" + }, + { + "$ref": "#/components/parameters/tokens" + }, + { + "$ref": "#/components/parameters/secondary" + } + ], + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } + }, + "/api/v2/utxo/{addressOrXpub}": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "parameters": [ + { + "$ref": "#/components/parameters/addressOrXpub" + } + ], + "get": { + "summary": "UTXOs", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": {} + }, + "examples": { + "Example 1": { + "value": [ + { + "txid": "13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9", + "vout": 0, + "value": "1422303206539", + "confirmations": 0, + "lockTime": 2648100 + }, + { + "txid": "a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac", + "vout": 1, + "value": "39748685", + "height": 2648043, + "confirmations": 47, + "coinbase": true + }, + { + "txid": "de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef", + "vout": 0, + "value": "122492339065", + "height": 2646043, + "confirmations": 2047 + }, + { + "txid": "9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9", + "vout": 0, + "value": "142771322208", + "height": 2644885, + "confirmations": 3205 + } + ] + } + } + } + } + } + }, + "operationId": "getUTXOV2", + "description": "Returns array of unspent transaction outputs of address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions. The query parameter confirmed=true disables return of unconfirmed transactions. The returned utxos are sorted by block height, newest blocks first. For xpubs or output descriptors, the response also contains address and derivation path of the utxo.\n\n\n\nUnconfirmed utxos do not have field height, the field confirmations has value 0 and may contain field lockTime, if not zero.\n\nCoinbase utxos have field coinbase set to true, however due to performance reasons only up to minimum coinbase confirmations limit (100). After this limit, utxos are not detected as coinbase.", + "parameters": [ + { + "$ref": "#/components/parameters/confirmed" + } + ], + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } + }, + "/api/v2/sendtx": { + "servers": [ + { + "url": "https://bitcoin-mainnet.blockfrost.io" + }, + { + "url": "https://litecoin-mainnet.blockfrost.io" + }, + { + "url": "https://dogecoin-mainnet.blockfrost.io" + } + ], + "post": { + "summary": "Submit transaction", + "operationId": "postSendTxV2", + "responses": { + "200": { + "description": "OK", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "result": { + "type": "string" + } + }, + "x-examples": { + "Example 1": { + "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25" + } + } + }, + "examples": { + "Example 1": { + "value": { + "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25" + } + } + } + } + } + } + }, + "description": "Sends new transaction to backend for broadcasting\n", + "requestBody": { + "content": { + "text/plain": { + "schema": { + "type": "object", + "properties": {} + } + } + }, + "description": "Transaction hex as plain text" + }, + "tags": [ + "Bitcoin", + "Litecoin", + "Dogecoin" + ] + } } }, "components": { @@ -17643,6 +18735,173 @@ "name": "project_id", "description": "There are multiple token types available based on network you choose\nwhen creating a Blockfrost a project, for a list of token types\nsee available networks.\n" } + }, + "parameters": { + "blockHashOrHeight": { + "name": "blockHashOrHeight", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "00000000000000000035835503f43c878ebb643f3b40bdfd0dfda760da74e73c" + }, + "description": "Block hash or height" + }, + "page": { + "name": "page", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "example": 1 + }, + "description": "specifies page of returned transactions, starting from 1. If out of range, Blockbook returns the closest possible page." + }, + "pageSize": { + "name": "pageSize", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "example": 1000 + }, + "description": "number of transactions returned by call (default and maximum 1000)" + }, + "blockHeight": { + "name": "blockHeight", + "in": "path", + "required": true, + "schema": { + "type": "integer", + "example": 15 + }, + "description": "Block height/index" + }, + "txId": { + "name": "txId", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "cd8ec77174e426070d0a50779232bba7312b712e2c6843d82d963d7076c61366" + }, + "description": "Transaction ID" + }, + "address": { + "name": "address", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL" + }, + "description": "Wallet address" + }, + "details": { + "name": "details", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": [ + "basic", + "tokens", + "tokenBalances", + "txids", + "txslight", + "txs" + ], + "default": "txids", + "example": "basic" + }, + "description": "specifies level of details returned by request" + }, + "fromBlock": { + "name": "fromBlock", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "example": 10 + }, + "description": "filter of the returned transactions from block height to block height (default no filter)" + }, + "toBlock": { + "name": "toBlock", + "in": "query", + "required": false, + "schema": { + "type": "integer", + "example": 100 + }, + "description": "filter of the returned transactions from block height to block height (default no filter)" + }, + "secondary": { + "name": "secondary", + "in": "query", + "required": false, + "schema": { + "type": "string", + "example": "usd" + }, + "description": "specifies secondary (fiat) currency in which the token and total balances are returned in addition to crypto values" + }, + "xpub": { + "name": "xpub", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN" + }, + "description": "xpub or output descriptor, applicable only for Bitcoin-type coins" + }, + "tokens": { + "name": "tokens", + "in": "query", + "required": false, + "schema": { + "type": "string", + "default": "nonzero", + "enum": [ + "nonzero", + "used", + "derived" + ], + "example": "used" + }, + "description": "specifies what tokens (xpub addresses) are returned by the request (default nonzero)" + }, + "confirmed": { + "name": "confirmed", + "in": "query", + "required": false, + "schema": { + "type": "boolean", + "example": true + }, + "description": "confirmed=true disables return of unconfirmed transactions" + }, + "hex": { + "name": "hex", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "01000000017f9a22c9cbf54bd902400df746f138f37bcf5b4d93eb755820e974ba43ed5f42040000006a4730440220037f4ed5427cde81d55b9b6a2fd08c8a25090c2c2fff3a75c1a57625ca8a7118022076c702fe55969fa08137f71afd4851c48e31082dd3c40c919c92cdbc826758d30121029f6da5623c9f9b68a9baf9c1bc7511df88fa34c6c2f71f7c62f2f03ff48dca80feffffff019c9700000000000017a9146144d57c8aff48492c9dfb914e120b20bad72d6f8773d00700" + }, + "description": "Transaction hex data" + }, + "addressOrXpub": { + "name": "addressOrXpub", + "in": "path", + "required": true, + "schema": { + "type": "string", + "example": "321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL" + }, + "description": "Address or XPUB" + } } } } \ No newline at end of file diff --git a/openapi.yaml b/openapi.yaml index 89986bae..cf0ed827 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -67,6 +67,9 @@ info: Midnight mainnet https://midnight-mainnet.blockfrost.io/api/v0 + Bitcoin mainnet + + https://bitcoin-mainnet.blockfrost.io/api/v2 @@ -350,6 +353,72 @@ security: tags: - name: Health - name: Metrics + - name: Bitcoin + description: > + Blockbook Bitcoin integration allows you to access Bitcoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). + - name: Litecoin + description: > + Blockbook Litecoin integration allows you to access Litecoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). + - name: Dogecoin + description: > + Blockbook Dogecoin integration allows you to access Dogecoin blockchain + using Blockbook API. + + + > **Please note that Blockfrost acts as a proxy for the subset of + Blockbook API endpoints. The API version in the URL corresponds to the + deployed Blockbook API version, which is currently V2..** + + + > For example, to retrieve a block data for the first block, you would + use: + + `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` + + + In addition to error responses listed in Blockbook endpoints (such as + `404`, `412` and `500`), the API may also return error responses related + to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated + request). For the full list of Blockfrost error status codes, please see + [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets @@ -6909,6 +6978,850 @@ paths: $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' + /api/v2/status: + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + get: + tags: + - Bitcoin + - Litecoin + - Dogecoin + summary: Blockchain status + operationId: getStatus + description: Get current status of Blockbook and its backend + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + blockbook: + type: object + properties: + coin: + type: string + network: + type: string + host: + type: string + version: + type: string + gitCommit: + type: string + buildTime: + type: string + syncMode: + type: boolean + initialSync: + type: boolean + inSync: + type: boolean + bestHeight: + type: integer + lastBlockTime: + type: string + inSyncMempool: + type: boolean + lastMempoolTime: + type: string + mempoolSize: + type: integer + decimals: + type: integer + dbSize: + type: integer + hasFiatRates: + type: boolean + currentFiatRatesTime: + type: string + historicalFiatRatesTime: + type: string + about: + type: string + backend: + type: object + properties: + chain: + type: string + blocks: + type: integer + headers: + type: integer + bestBlockHash: + type: string + difficulty: + type: string + sizeOnDisk: + type: integer + version: + type: string + subversion: + type: string + protocolVersion: + type: string + x-examples: + Example 1: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: '2023-02-27T02:40:48+00:00' + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: '2023-04-07T02:55:40.032567054Z' + inSyncMempool: true + lastMempoolTime: '2023-04-07T03:04:36.260327616Z' + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' + historicalFiatRatesTime: '2023-04-07T00:00:00Z' + about: >- + Blockbook blockchain indexer for https://chain49.com/ - + based on trezor/blockbook + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: >- + 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: '47887764338536.25' + sizeOnDisk: 534828732178 + version: '240001' + subversion: '/Satoshi:24.0.1/' + protocolVersion: '70016' + examples: + Example 1: + value: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: '2023-02-27T02:40:48+00:00' + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: '2023-04-07T02:55:40.032567054Z' + inSyncMempool: true + lastMempoolTime: '2023-04-07T03:04:36.260327616Z' + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' + historicalFiatRatesTime: '2023-04-07T00:00:00Z' + about: >- + Blockbook blockchain indexer for https://chain49.com/ - + based on trezor/blockbook + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: >- + 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: '47887764338536.25' + sizeOnDisk: 534828732178 + version: '240001' + subversion: '/Satoshi:24.0.1/' + protocolVersion: '70016' + '/api/v2/block/{blockHashOrHeight}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/blockHashOrHeight' + get: + summary: Block + responses: + '200': + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + hash: + type: string + previousBlockHash: + type: string + nextBlockHash: + type: string + height: + type: integer + confirmations: + type: integer + size: + type: integer + time: + type: integer + version: + type: integer + merkleRoot: + type: string + nonce: + type: string + bits: + type: string + difficulty: + type: string + txCount: + type: integer + txs: + type: array + items: + type: object + properties: + txid: + type: string + vin: + type: array + items: + type: object + properties: + 'n': + type: integer + isAddress: + type: boolean + value: + type: string + vout: + type: array + items: + type: object + properties: + value: + type: string + 'n': + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + blockHeight: + type: integer + confirmations: + type: integer + blockTime: + type: integer + value: + type: string + valueIn: + type: string + fees: + type: string + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: >- + 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: >- + 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: '2573394689' + bits: 1d00ffff + difficulty: '1' + txCount: 1 + txs: + - txid: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - 'n': 0 + isAddress: false + value: '0' + vout: + - value: '5000000000' + 'n': 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: '5000000000' + valueIn: '0' + fees: '0' + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: >- + 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: >- + 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: '2573394689' + bits: 1d00ffff + difficulty: '1' + txCount: 1 + txs: + - txid: >- + 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - 'n': 0 + isAddress: false + value: '0' + vout: + - value: '5000000000' + 'n': 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: >- + 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: '5000000000' + valueIn: '0' + fees: '0' + description: OK + operationId: getBlockV2 + description: >- + Returns information about block with transactions, subject to paging. + + + Note: Blockbook always follows the main chain of the backend it is + attached to. If there is a rollback-reorg in the backend, Blockbook will + also do rollback. When you ask for block by height, you will always get + the main chain block. If you ask for block by hash, you may get the + block from another fork but it is not guaranteed (backend may not keep + it) + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/block-index/{blockHeight}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/blockHeight' + get: + summary: Block hash + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + blockHash: + type: string + x-examples: + Example 1: + blockHash: >- + ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + examples: + Example 1: + value: + blockHash: >- + ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + operationId: getBlockHashV2 + description: >- + Get block hash by its height + + + Note: Blockbook always follows the main chain of the backend it is + attached to. + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/tx-specific/{txId}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/txId' + get: + summary: Transaction + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + zCash: + value: + hex: 040000808...8e6e73cb009 + txid: >- + 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 + overwintered: true + version: 4 + versiongroupid: 892f2085 + locktime: 0 + expiryheight: 495680 + vin: [] + vout: [] + vjoinsplit: [] + valueBalance: 0 + vShieldedSpend: + - cv: >- + 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 + anchor: >- + 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: >- + 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a + rk: >- + 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 + proof: aecf824dbae8eea863ec6...73878c37391f01df520aa + spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 + - cv: >- + a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c + anchor: >- + 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b + nullifier: >- + 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 + rk: >- + 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 + proof: >- + a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 + spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 + vShieldedOutput: + - cv: >- + 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab + cmu: >- + 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc + ephemeralKey: >- + 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 + encCiphertext: a533d3b99b...a0204 + outCiphertext: 4baabc15199504b1...c1ad6a + proof: >- + aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 + bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 + blockhash: >- + 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af + confirmations: 5222 + time: 1552301566 + blocktime: 1552301566 + operationId: getTxSpecificV2 + description: >- + Returns transaction data in the exact format as returned by backend, + including all coin specific fields + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/address/{address}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/address' + get: + summary: Address + tags: + - Bitcoin + - Litecoin + - Dogecoin + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + 'Bitcoin-like, details set to "txids"': + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 + balance: '2432468097999991' + totalReceived: '3992283916999979' + totalSent: '1559815818999988' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 3 + txids: + - >- + 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 + - >- + bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 + - >- + 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d + operationId: getAddressV2 + description: > + Returns balances and transactions of an address. The returned + transactions are sorted by block height, newest blocks first. + + + The **details** query parameter can specify the level of details + returned by the request (default: "txids"). + + Possible values are: + + + **basic**: return only xpub balances, without any derived addresses and + transactions + + + **tokens**: basic + tokens (addresses) derived from the xpub, subject to + tokens parameter + + + **tokenBalances**: basic + tokens (addresses) derived from the xpub with + balances, subject to tokens parameter + + + **txids**: tokenBalances + list of txids, subject to from, to filter and + paging + + + **txs**: tokenBalances + list of transaction with details, subject to + from, to filter and paging + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/fromBlock' + - $ref: '#/components/parameters/toBlock' + - $ref: '#/components/parameters/details' + '/api/v2/xpub/{xpub}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/xpub' + get: + summary: Xpub + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + address: + type: string + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + unconfirmedBalance: + type: string + unconfirmedTxs: + type: integer + txs: + type: integer + txids: + type: array + items: + type: string + usedTokens: + type: integer + tokens: + type: array + items: + type: object + properties: + type: + type: string + name: + type: string + path: + type: string + transfers: + type: integer + decimals: + type: integer + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + secondaryValue: + type: number + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: >- + dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: '90000000' + totalReceived: '3093381250' + totalSent: '3083381250' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 5 + txids: + - >- + 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - >- + 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - >- + e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - >- + 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - >- + 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: '90000000' + totalReceived: '2903986975' + totalSent: '2803986975' + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: '0' + totalReceived: '279394275' + totalSent: '279394275' + secondaryValue: 21195.47633568 + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: >- + dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: '90000000' + totalReceived: '3093381250' + totalSent: '3083381250' + unconfirmedBalance: '0' + unconfirmedTxs: 0 + txs: 5 + txids: + - >- + 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - >- + 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - >- + e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - >- + 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - >- + 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: '90000000' + totalReceived: '2903986975' + totalSent: '2803986975' + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: '0' + totalReceived: '279394275' + totalSent: '279394275' + secondaryValue: 21195.47633568 + operationId: getXpubV2 + description: >- + Returns balances and transactions of an xpub or output descriptor, + applicable only for Bitcoin-type coins. + + + Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation + schemes, using either xpubs or output descriptors (see + https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) + + + Note: usedTokens always returns total number of used addresses of xpub. + + + Detailed documentation found here: + https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub + parameters: + - $ref: '#/components/parameters/page' + - $ref: '#/components/parameters/pageSize' + - $ref: '#/components/parameters/fromBlock' + - $ref: '#/components/parameters/toBlock' + - $ref: '#/components/parameters/details' + - $ref: '#/components/parameters/tokens' + - $ref: '#/components/parameters/secondary' + tags: + - Bitcoin + - Litecoin + - Dogecoin + '/api/v2/utxo/{addressOrXpub}': + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + parameters: + - $ref: '#/components/parameters/addressOrXpub' + get: + summary: UTXOs + responses: + '200': + description: OK + content: + application/json: + schema: + type: array + items: {} + examples: + Example 1: + value: + - txid: >- + 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 + vout: 0 + value: '1422303206539' + confirmations: 0 + lockTime: 2648100 + - txid: >- + a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac + vout: 1 + value: '39748685' + height: 2648043 + confirmations: 47 + coinbase: true + - txid: >- + de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef + vout: 0 + value: '122492339065' + height: 2646043 + confirmations: 2047 + - txid: >- + 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 + vout: 0 + value: '142771322208' + height: 2644885 + confirmations: 3205 + operationId: getUTXOV2 + description: >- + Returns array of unspent transaction outputs of address or xpub, + applicable only for Bitcoin-type coins. By default, the list contains + both confirmed and unconfirmed transactions. The query parameter + confirmed=true disables return of unconfirmed transactions. The returned + utxos are sorted by block height, newest blocks first. For xpubs or + output descriptors, the response also contains address and derivation + path of the utxo. + + + + + Unconfirmed utxos do not have field height, the field confirmations has + value 0 and may contain field lockTime, if not zero. + + + Coinbase utxos have field coinbase set to true, however due to + performance reasons only up to minimum coinbase confirmations limit + (100). After this limit, utxos are not detected as coinbase. + parameters: + - $ref: '#/components/parameters/confirmed' + tags: + - Bitcoin + - Litecoin + - Dogecoin + /api/v2/sendtx: + servers: + - url: 'https://bitcoin-mainnet.blockfrost.io' + - url: 'https://litecoin-mainnet.blockfrost.io' + - url: 'https://dogecoin-mainnet.blockfrost.io' + post: + summary: Submit transaction + operationId: postSendTxV2 + responses: + '200': + description: OK + content: + application/json: + schema: + type: object + properties: + result: + type: string + x-examples: + Example 1: + result: >- + 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + examples: + Example 1: + value: + result: >- + 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + description: | + Sends new transaction to backend for broadcasting + requestBody: + content: + text/plain: + schema: + type: object + properties: {} + description: Transaction hex as plain text + tags: + - Bitcoin + - Litecoin + - Dogecoin components: schemas: onchain_metadata_cip25: @@ -13698,3 +14611,149 @@ components: There are multiple token types available based on network you choose when creating a Blockfrost a project, for a list of token types see available networks. + parameters: + blockHashOrHeight: + name: blockHashOrHeight + in: path + required: true + schema: + type: string + example: 00000000000000000035835503f43c878ebb643f3b40bdfd0dfda760da74e73c + description: Block hash or height + page: + name: page + in: query + required: false + schema: + type: integer + example: 1 + description: >- + specifies page of returned transactions, starting from 1. If out of + range, Blockbook returns the closest possible page. + pageSize: + name: pageSize + in: query + required: false + schema: + type: integer + example: 1000 + description: number of transactions returned by call (default and maximum 1000) + blockHeight: + name: blockHeight + in: path + required: true + schema: + type: integer + example: 15 + description: Block height/index + txId: + name: txId + in: path + required: true + schema: + type: string + example: cd8ec77174e426070d0a50779232bba7312b712e2c6843d82d963d7076c61366 + description: Transaction ID + address: + name: address + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Wallet address + details: + name: details + in: query + required: false + schema: + type: string + enum: + - basic + - tokens + - tokenBalances + - txids + - txslight + - txs + default: txids + example: basic + description: specifies level of details returned by request + fromBlock: + name: fromBlock + in: query + required: false + schema: + type: integer + example: 10 + description: >- + filter of the returned transactions from block height to block height + (default no filter) + toBlock: + name: toBlock + in: query + required: false + schema: + type: integer + example: 100 + description: >- + filter of the returned transactions from block height to block height + (default no filter) + secondary: + name: secondary + in: query + required: false + schema: + type: string + example: usd + description: >- + specifies secondary (fiat) currency in which the token and total + balances are returned in addition to crypto values + xpub: + name: xpub + in: path + required: true + schema: + type: string + example: >- + tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN + description: 'xpub or output descriptor, applicable only for Bitcoin-type coins' + tokens: + name: tokens + in: query + required: false + schema: + type: string + default: nonzero + enum: + - nonzero + - used + - derived + example: used + description: >- + specifies what tokens (xpub addresses) are returned by the request + (default nonzero) + confirmed: + name: confirmed + in: query + required: false + schema: + type: boolean + example: true + description: confirmed=true disables return of unconfirmed transactions + hex: + name: hex + in: path + required: true + schema: + type: string + example: >- + 01000000017f9a22c9cbf54bd902400df746f138f37bcf5b4d93eb755820e974ba43ed5f42040000006a4730440220037f4ed5427cde81d55b9b6a2fd08c8a25090c2c2fff3a75c1a57625ca8a7118022076c702fe55969fa08137f71afd4851c48e31082dd3c40c919c92cdbc826758d30121029f6da5623c9f9b68a9baf9c1bc7511df88fa34c6c2f71f7c62f2f03ff48dca80feffffff019c9700000000000017a9146144d57c8aff48492c9dfb914e120b20bad72d6f8773d00700 + description: Transaction hex data + addressOrXpub: + name: addressOrXpub + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Address or XPUB diff --git a/package.json b/package.json index a1a09c86..b766d690 100644 --- a/package.json +++ b/package.json @@ -17,7 +17,7 @@ "lint": "scalar validate ./src/definitions.yaml", "bundle": "yarn redocly bundle -o ./blockfrost-openapi.yaml src/definitions.yaml && yarn openapi-merge-cli && yarn redocly bundle -o ./openapi.json ./openapi.yaml && yarn copy-spec && yarn build:midnight-docs", "build:midnight-docs": "yarn spectaql ./spectaql.yaml && cp ./midnight-indexer-api.graphql ./docs/midnight/midnight-indexer-api.graphql", - "generate-types": "yarn openapi-typescript ./openapi.yaml --output ./src/generated-types.ts", + "generate-types": "yarn openapi-typescript ./blockfrost-openapi.yaml --output ./src/generated-types.ts", "generate-types:rust": "openapi-generator-cli generate -i openapi.yaml -g rust -o ./rust -c rust/openapi-generator.json --global-property models,modelDocs=false,apis=false,apiDocs=false,supportingFiles && node rust/fix-cargo.js", "generate-json-schema": "node lib/scripts/generate-json-schema.js > json-schema.json", "sync-version": "ts-node ./src/scripts/sync-version.ts", diff --git a/src/definitions.yaml b/src/definitions.yaml index a9fa80ad..3529e06c 100644 --- a/src/definitions.yaml +++ b/src/definitions.yaml @@ -57,6 +57,9 @@ info: Midnight mainnet https://midnight-mainnet.blockfrost.io/api/v0 + Bitcoin mainnet + + https://bitcoin-mainnet.blockfrost.io/api/v2 @@ -263,6 +266,36 @@ security: tags: - name: Health - name: Metrics + - name: Bitcoin + description: | + Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). + - name: Litecoin + description: | + Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). + - name: Dogecoin + description: | + Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API. + + > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** + + > For example, to retrieve a block data for the first block, you would use: + `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` + + In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets diff --git a/src/generated-types.ts b/src/generated-types.ts index f801010b..4f6111ed 100644 --- a/src/generated-types.ts +++ b/src/generated-types.ts @@ -11327,1045 +11327,6 @@ export interface components { } & { [key: string]: unknown; }; - /** - * @description Represents general information about Aggregator public information and signing capabilities - * @example { - * "open_api_version": "0.1.17", - * "documentation_url": "https://mithril.network", - * "capabilities": { - * "signed_entity_types": [ - * "MithrilStakeDistribution", - * "CardanoImmutableFilesFull", - * "CardanoTransactions" - * ], - * "cardano_transactions_prover": { - * "max_hashes_allowed_by_request": 100 - * } - * } - * } - */ - AggregatorFeaturesMessage: { - /** - * Format: byte - * @description Open API version - */ - open_api_version: string; - /** - * Format: byte - * @description Mithril documentation - */ - documentation_url: string; - /** @description Capabilities of the aggregator */ - capabilities: { - /** @description Signed entity types that are signed by the aggregator */ - signed_entity_types: ("MithrilStakeDistribution" | "CardanoStakeDistribution" | "CardanoImmutableFilesFull" | "CardanoTransactions")[]; - /** @description Cardano transactions prover capabilities */ - cardano_transactions_prover?: { - /** - * Format: int64 - * @description Maximum number of hashes allowed for a single request - */ - max_hashes_allowed_by_request: number; - }; - }; - }; - /** - * Format: int64 - * @description Cardano chain epoch number - */ - Epoch: number; - /** - * @description Epoch settings - * @example { - * "epoch": 329, - * "protocol": { - * "k": 857, - * "m": 6172, - * "phi_f": 0.2 - * }, - * "next_protocol": { - * "k": 2422, - * "m": 20973, - * "phi_f": 0.2 - * } - * } - */ - EpochSettingsMessage: { - epoch: components["schemas"]["Epoch"]; - protocol: components["schemas"]["ProtocolParameters"]; - next_protocol: components["schemas"]["ProtocolParameters"]; - }; - /** - * @description Protocol cryptographic parameters - * @example { - * "k": 857, - * "m": 6172, - * "phi_f": 0.2 - * } - */ - ProtocolParameters: { - /** - * Format: int64 - * @description Quorum parameter - */ - k: number; - /** - * Format: int64 - * @description Security parameter (number of lotteries) - */ - m: number; - /** - * Format: double - * @description f in phi(w) = 1 - (1 - f)^w, where w is the stake of a participant - */ - phi_f: number; - } & { - [key: string]: unknown; - }; - /** - * @description A point in the Cardano chain at which a Mithril certificate of the Cardano Database should be produced - * @example { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * } - */ - CardanoDbBeacon: { - /** @description Cardano network */ - network: string; - epoch: components["schemas"]["Epoch"]; - /** - * Format: int64 - * @description Number of the last immutable file that should be included the snapshot - */ - immutable_file_number: number; - } & { - [key: string]: unknown; - }; - /** - * @description Entity type of the message that is signed - * @example { - * "MithrilStakeDistribution": 246 - * } - */ - SignedEntityType: { - [key: string]: unknown; - }; - /** - * @description CertificatePendingMessage represents all the information related to the certificate currently expecting to receive quorum of single signatures - * @example { - * "epoch": 329, - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "entity_type": { - * "MithrilStakeDistribution": 246 - * }, - * "protocol": { - * "k": 857, - * "m": 6172, - * "phi_f": 0.2 - * }, - * "next_protocol": { - * "k": 2422, - * "m": 20973, - * "phi_f": 0.2 - * }, - * "signers": [ - * { - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123 - * }, - * { - * "party_id": "2345678900", - * "verification_key": "7b392c39392c13131312766b223a5c39382c313342b39302c252c32352c31353328342c32", - * "verification_key_signature": "2c33302c3133312c3138322c34362c3133352c372c3139302c3235322c35352c32322c39", - * "operational_certificate": "3231342c3137372c37312c3232352c3233332c3135335d2c322c3139322c5b3133352c34312c3230332c3131332c3c33352c3234302c3230392c312c32392c3233332c33342c3138382c3134312c3130342c3234382c3231392c3", - * "kes_period": 456 - * } - * ], - * "next_signers": [ - * { - * "party_id": "3456789000", - * "verification_key": "7b22766b223a5b3133382c32392c3137332c3134342c36332c3233352c39372c3138302c3", - * "verification_key_signature": "7b227369676d61223a7b227369676d61223a7b227369676d61223a7b227369676d612239", - * "operational_certificate": "5b5b5b3232352c3230332c3235352c3130302c3136372c38302c37342c3136362c3135362c38322c39382c3232312c36332c3137372c3232332c3232332c31392c35372c39332c312c35302c3133392c3233342c3137332c32352", - * "kes_period": 789 - * }, - * { - * "party_id": "4567890000", - * "verification_key": "34302c3132332c3139302c3134352c3132342c35342c3133302c37302c3136332c3139332", - * "verification_key_signature": "302c3230312c38362c3139312c36302c3234352c3138332c3134342c3139392c3130335f", - * "operational_certificate": "2c38382c3138372c3233332c34302c37322c31362c36365d2c312c3132332c5b31362c3136392c3134312c3138332c32322c3137342c3131312c33322c36342c35322c2c3232382c37392c3137352c32395312c3838282c323030", - * "kes_period": 876 - * } - * ] - * } - */ - CertificatePendingMessage: { - epoch: components["schemas"]["Epoch"]; - /** @deprecated */ - beacon?: components["schemas"]["CardanoDbBeacon"]; - entity_type: components["schemas"]["SignedEntityType"]; - protocol: components["schemas"]["ProtocolParameters"]; - next_protocol: components["schemas"]["ProtocolParameters"]; - signers: components["schemas"]["Signer"][]; - next_signers: components["schemas"]["Signer"][]; - }; - /** - * @description Stake represents the stakes of a participant in the Cardano chain - * @example { - * "stake": 1234 - * } - */ - Stake: { - /** - * Format: int64 - * @description Stake share as computed in the 'stake distribution' by the Cardano Node, multiplied by a billion (1.0e9) - */ - stake: number; - } & { - [key: string]: unknown; - }; - /** - * @description Signer represents a signing participant in the network - * @example { - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123 - * } - */ - Signer: { - /** @description The unique identifier of the signer */ - party_id: string; - /** - * Format: byte - * @description The public key used to authenticate signer signature - */ - verification_key: string; - /** - * Format: byte - * @description The signature of the verification_key (signed by the Cardano node KES secret key) - */ - verification_key_signature?: string; - /** - * Format: byte - * @description The operational certificate of the stake pool operator attached to the signer node - */ - operational_certificate?: string; - /** - * Format: int64 - * @description The number of updates of the KES secret key that signed the verification key - */ - kes_period?: number; - } & { - [key: string]: unknown; - }; - /** - * @description This message represents a signing participant in the network. - * @example { - * "epoch": 329, - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123 - * } - */ - RegisterSignerMessage: ({ - epoch?: components["schemas"]["Epoch"]; - } & { - [key: string]: unknown; - }) & components["schemas"]["Signer"]; - /** - * @description Signer represents a signing party in the network (including its stakes) - * @example { - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123, - * "stake": 1234 - * } - */ - SignerWithStake: { - [key: string]: unknown; - } & (components["schemas"]["Signer"] & components["schemas"]["Stake"]); - /** - * @description Signer registered to a signature round. - * - * @example { - * "party_id": "1234567890", - * "stake": 1234 - * } - */ - StakeDistributionParty: { - /** @description The unique identifier of the signer */ - party_id?: string; - /** - * Format: int64 - * @description Stake share as computed in the 'stake distribution' by the Cardano Node, multiplied by a billion (1.0e9) - */ - stake?: number; - } & { - [key: string]: unknown; - }; - /** - * @description This message holds the registered signers at a given epoch. - * - * @example { - * "registered_at": 420, - * "signing_at": 422, - * "registrations": [ - * { - * "party_id": "1234567890", - * "stake": 1234 - * } - * ] - * } - */ - SignerRegistrationsMessage: { - registered_at?: components["schemas"]["Epoch"]; - signing_at?: components["schemas"]["Epoch"]; - registrations?: components["schemas"]["SignerRegistrationsListItemMessage"][]; - }; - /** @description represents an item of a SignerRegistrationsMessage registration */ - SignerRegistrationsListItemMessage: ({ - /** @description The unique identifier of the signer */ - party_id?: string; - } & { - [key: string]: unknown; - }) & components["schemas"]["Stake"]; - /** - * @description represents the list of signers known by the aggregator - * @example { - * "network": "mainnet", - * "signers": [ - * { - * "party_id": "pool1234567890", - * "pool_ticker": "[Pool_Name]", - * "has_registered": true - * }, - * { - * "party_id": "pool0987654321", - * "has_registered": false - * } - * ] - * } - */ - SignersTickersMessage: { - /** - * Format: bytes - * @description Cardano network of the aggregator - */ - network: string; - /** @description Known signers */ - signers: unknown; - }; - /** - * @description represents a known signer with its pool ticker - * @example { - * "party_id": "pool1234567890", - * "pool_ticker": "[Pool_Name]", - * "has_registered": true - * } - */ - SignerTickerListItemMessage: { - /** @description The unique identifier of the signer */ - party_id: string; - /** @description The signer pool ticker */ - pool_ticker?: string; - /** @description The signer has registered at least once */ - has_registered: boolean; - } & { - [key: string]: unknown; - }; - /** - * @description This message holds a Signer Single Signature with the - * list of won indexes in the lottery. - * - * @example { - * "entity_type": { - * "MithrilStakeDistribution": 246 - * }, - * "party_id": "1234567890", - * "signature": "7b2c36322c3130352c3232322c31302c3131302c33312c37312c39372c22766b223a5b3136342c2c31393137352c313834", - * "indexes": [ - * 25, - * 35 - * ] - * } - */ - RegisterSingleSignatureMessage: { - entity_type: components["schemas"]["SignedEntityType"]; - /** @description The unique identifier of the signer */ - party_id: string; - /** - * Format: byte - * @description The single signature of the digest - */ - signature: string; - /** @description The indexes of the lottery won that lead to the single signature */ - indexes: number[]; - }; - /** - * @description ProtocolMessage represents a message that is signed (or verified) by the Mithril protocol - * @example { - * "snapshot_digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "next_aggregate_verification_key": "b132362c3232352c36392c31373133352c31323235392c3235332c3233342c34226d745f636f6d6d69746d656e74223a7b22726f6f74223a5b33382c3382c3138322c3231322c2c363", - * "latest_block_number": "123456" - * } - */ - ProtocolMessageParts: { - /** - * Format: bytes - * @description Digest of the snapshot archive - */ - snapshot_digest?: string; - /** - * Format: bytes - * @description Aggregate verification key (AVK) that will be used to create the next multi signature - */ - next_aggregate_verification_key: string; - /** @description The latest signed block number */ - latest_block_number?: string; - } & { - [key: string]: unknown; - }; - /** - * @description ProtocolMessage represents a message that is signed (or verified) by the Mithril protocol - * @example { - * "message_parts": { - * "snapshot_digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "next_aggregate_verification_key": "b132362c3232352c36392c31373133352c31323235392c3235332c3233342c34226d745f636f6d6d69746d656e74223a7b22726f6f74223a5b33382c3382c3138322c3231322c2c363" - * } - * } - */ - ProtocolMessage: { - message_parts: components["schemas"]["ProtocolMessageParts"]; - }; - /** - * @description CertificateListItemMessageMetadata represents the metadata associated to a CertificateListItemMessage - * @example { - * "network": "mainnet", - * "version": "0.1.0", - * "parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * }, - * "initiated_at": "2022-07-17T18:51:23.192811338Z", - * "sealed_at": "2022-07-17T18:51:35.830832580Z", - * "total_signers": 3 - * } - */ - CertificateListItemMessageMetadata: { - /** @description Cardano network */ - network: string; - /** - * Format: bytes - * @description Version of the protocol - */ - version: string; - parameters: components["schemas"]["ProtocolParameters"]; - /** - * Format: date-time - * @description Date and time at which the certificate was initialized and ready to accept single signatures from signers - */ - initiated_at: string; - /** - * Format: date-time - * @description Date and time at which the certificate was sealed (when the quorum of single signatures was reached so that a multi signature could be aggregated from them) - */ - sealed_at: string; - /** - * Format: int64 - * @description The number of the signers with their stakes and verification keys - */ - total_signers: number; - }; - /** - * @description CertificateListMessage represents a list of Mithril certificates - * @example [ - * { - * "hash": "9dc998101590f733f7a50e7c03b5b336e69a751cc02d811395d49618db3ba3d7", - * "previous_hash": "aa2ddfb87a17103bdf15bfb21a2941b3f3223a3c8d710910496c392b14f8c403", - * "epoch": 329, - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "signed_entity_type": { - * "MithrilStakeDistribution": 246 - * }, - * "metadata": { - * "network": "mainnet", - * "version": "0.1.0", - * "parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * }, - * "initiated_at": "2022-07-17T18:51:23.192811338Z", - * "sealed_at": "2022-07-17T18:51:35.830832580Z", - * "total_signers": 3 - * }, - * "protocol_message": { - * "message_parts": { - * "snapshot_digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "next_aggregate_verification_key": "b132362c3232352c36392c31373133352c31323235392c3235332c3233342c34226d745f636f6d6d69746d656e74223a7b22726f6f74223a5b33382c3382c3138322c3231322c2c363" - * } - * }, - * "signed_message": "07ed7c9e128744c1a4797b7eb34c54823cc7a21fc95c19876122ab4bb0fe796d6bba2bc", - * "aggregate_verification_key": "7b232392c3130342c34392c35312c3130332c3136352c37364223a7b22726f6f74223a5b3137392c3135312c3135382c37332c37372c2c3135392c3226d745f636f6d6d69746d656e7" - * } - * ] - */ - CertificateListMessage: components["schemas"]["CertificateListItemMessage"][]; - /** - * @description CertificateListItemMessage represents an item of a list of Mithril certificates - * @example { - * "hash": "9dc998101590f733f7a50e7c03b5b336e69a751cc02d811395d49618db3ba3d7", - * "previous_hash": "aa2ddfb87a17103bdf15bfb21a2941b3f3223a3c8d710910496c392b14f8c403", - * "epoch": 32, - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "signed_entity_type": { - * "MithrilStakeDistribution": 246 - * }, - * "metadata": { - * "network": "mainnet", - * "version": "0.1.0", - * "parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * }, - * "initiated_at": "2022-07-17T18:51:23.192811338Z", - * "sealed_at": "2022-07-17T18:51:35.830832580Z", - * "total_signers": 3 - * }, - * "protocol_message": { - * "message_parts": { - * "snapshot_digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "next_aggregate_verification_key": "b132362c3232352c36392c31373133352c31323235392c3235332c3233342c34226d745f636f6d6d69746d656e74223a7b22726f6f74223a5b33382c3382c3138322c3231322c2c363" - * } - * }, - * "signed_message": "07ed7c9e128744c1a4797b7eb34c54823cc7a21fc95c19876122ab4bb0fe796d6bba2bc", - * "aggregate_verification_key": "7b232392c3130342c34392c35312c3130332c3136352c37364223a7b22726f6f74223a5b3137392c3135312c3135382c37332c37372c2c3135392c3226d745f636f6d6d69746d656e7" - * } - */ - CertificateListItemMessage: { - /** - * Format: bytes - * @description Hash of the current certificate - */ - hash: string; - /** - * Format: bytes - * @description Hash of the previous certificate - */ - previous_hash: string; - epoch: components["schemas"]["Epoch"]; - /** @deprecated */ - beacon?: components["schemas"]["CardanoDbBeacon"]; - signed_entity_type: components["schemas"]["SignedEntityType"]; - metadata: components["schemas"]["CertificateListItemMessageMetadata"]; - protocol_message: components["schemas"]["ProtocolMessage"]; - /** - * Format: bytes - * @description Hash of the protocol message that is signed by the signer participants - */ - signed_message: string; - /** - * Format: bytes - * @description Aggregate verification key used to verify the multi signature - */ - aggregate_verification_key: string; - }; - /** - * @description CertificateMetadata represents the metadata associated to a Certificate - * @example { - * "network": "mainnet", - * "version": "0.1.0", - * "parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * }, - * "initiated_at": "2022-07-17T18:51:23.192811338Z", - * "sealed_at": "2022-07-17T18:51:35.830832580Z", - * "signers": [ - * { - * "party_id": "1234567890", - * "stake": 1234 - * }, - * { - * "party_id": "2345678900", - * "stake": 2345 - * } - * ] - * } - */ - CertificateMetadata: { - /** @description Cardano network */ - network: string; - /** - * Format: bytes - * @description Version of the protocol - */ - version: string; - parameters: components["schemas"]["ProtocolParameters"]; - /** - * Format: date-time - * @description Date and time at which the certificate was initialized and ready to accept single signatures from signers - */ - initiated_at: string; - /** - * Format: date-time - * @description Date and time at which the certificate was sealed (when the quorum of single signatures was reached so that a multi signature could be aggregated from them) - */ - sealed_at: string; - /** @description The list of the signers identifiers with their stakes and verification keys */ - signers: components["schemas"]["StakeDistributionParty"][]; - }; - /** - * @description Certificate represents a Mithril certificate embedding a Mithril STM multi signature - * @example { - * "hash": "9dc998101590f733f7a50e7c03b5b336e69a751cc02d811395d49618db3ba3d7", - * "previous_hash": "aa2ddfb87a17103bdf15bfb21a2941b3f3223a3c8d710910496c392b14f8c403", - * "epoch": 329, - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "signed_entity_type": { - * "MithrilStakeDistribution": 246 - * }, - * "metadata": { - * "network": "mainnet", - * "version": "0.1.0", - * "parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * }, - * "initiated_at": "2022-07-17T18:51:23.192811338Z", - * "sealed_at": "2022-07-17T18:51:35.830832580Z", - * "signers": [ - * { - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123, - * "stake": 1234 - * }, - * { - * "party_id": "2345678900", - * "verification_key": "7b392c39392c13131312766b223a5c39382c313342b39302c252c32352c31353328342c32", - * "verification_key_signature": "2c33302c3133312c3138322c34362c3133352c372c3139302c3235322c35352c32322c39", - * "operational_certificate": "3231342c3137372c37312c3232352c3233332c3135335d2c322c3139322c5b3133352c34312c3230332c3131332c3c33352c3234302c3230392c312c32392c3233332c33342c3138382c3134312c3130342c3234382c3231392c3", - * "kes_period": 456, - * "stake": 2345 - * } - * ] - * }, - * "protocol_message": { - * "message_parts": { - * "snapshot_digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "next_aggregate_verification_key": "b132362c3232352c36392c31373133352c31323235392c3235332c3233342c34226d745f636f6d6d69746d656e74223a7b22726f6f74223a5b33382c3382c3138322c3231322c2c363" - * } - * }, - * "signed_message": "07ed7c9e128744c1a4797b7eb34c54823cc7a21fc95c19876122ab4bb0fe796d6bba2bc", - * "aggregate_verification_key": "7b232392c3130342c34392c35312c3130332c3136352c37364223a7b22726f6f74223a5b3137392c3135312c3135382c37332c37372c2c3135392c3226d745f636f6d6d69746d656e7", - * "multi_signature": "7bc3139392c3135392c3235342c3231392c3133362c3132392c38342c353227369676e617475726573223a5b5b7b227369676d61223a5b3135312c362c3131222c33382c3135382c3137312c3137312c3234392c32342c3232382c3133302c38352c32362c38382c3135382c32303c323337322c323339362c32342c313530342c313532302c3135323737302c323830372c323831392c323834302c323834342c323836302c323837322c323838362c323839312c323839382c3239333533332c343538352c343632342c343634322c343634372c343636362c334312c31343636382c31343637352c31343639352c31343639392c31343730312c31343730352c31343733302c31343733382c31343733392c31343734362c31343735342c31343736312c31343738362c31343739352c31343739362c31343832362c31343835392c31343836302c31343836322c31343837312c31343837322c31343837392c31343838392c31343839332c31343839372c31343839392c31343932362c31343937372c31343939312c31353032332c31353033382c31353034342c31353036332c31353039312c31353039322c31353039382c31353131392c31353132312c31353136362c31353139362c31353230322c31353231302c31353231392c31353233392c31353234362c31353235322c31353237352c31353238312c31353334372c31353335372c31353338372c31353431372c31353434352c31353434382c31353435332c31353435342c31353530382c31353534352c31353536302c31353537302c31353538392c31353631302c31353631312c31353631322c31353632382c31353633302c31353633392c31353636302c31353636312c31353637392c31353731372c31353731392c31353732362c31353733382c31353734382c31353735392c31353736312c31353739312c31353830312c31353830332c31353831342c31353831392c31353832372c31353832392c31353834392c31353835332c31353835372c31353835392c31353836372c31353839362c31353930312c31353930372c31353931302c31353931332c31353931352c31353935352c31353937362c31353938372c31363031372c31363036332c31363131382c31363132382c31363135352c31363136372c31363230312c31363230362c31363231392c31363232312c31363232392c31363233342c31363234362c31363333302c31363335302c31363336362c31353739312c31353830312c31353830332c31353831342c31353831392c31353832372c31353832392c31353834392c31353835332c31353835372c31353835392c31353836372c31353839362c31353930312c31353930372c31353931302c31353931332c31353931352c31353935352c31353937362c31353938372c31363031372c31363036332c31363131382c31363132382c31363135352c31363136372c31363230312c31363230362c31363231392c31363232312c31363232392c31363233342c31363234362c31363333302c31363335302c31363336362c31363339302c31363430342c31363435342c31363437392c31363533302c31363533382c31363534372c31363535322c31363630382c31363631312c31363631382c31363633312c31363635382c31363637312c31363639352c31363730302c31363731332c31363732372c31363733312c31363733322c31363734322c31363736302c31363737342c31363739322c31363739362c31363739382c31363830342c31363831302c31363834302c31363834382c31363835392c31363836332c31363838362c31363838382c31363930302c31363932372c31363932382c31363932392c31363933372c31363934302c31363934362c31363935302c31363936312c31363938312c31373033302c31373035332c31373036322c31373038322c31373130312c31373130332c31373130352c31373130362c31373132302c31373132312c31373133322c31373133332c31373135312c31373135392c31373138332c31373232302c31373239322c31373331312c31373331332c31373332362c31373333362c31373334352c31373334392c31373335372c31373337352c31373338332c31373338352c31373430302c31373430362c31373431342c31373432322c31373434362c31373435312c31373436362c31373530322c31373531392c31373535382c31373536352c31373537332c31373538302c31373630362c31373632332c31373636382c31373639352c31373732392c31373733312c31373733352c31373733372c31373734342c31373734352c31373734372c31373736382c31373737302c31373737332c31373737352c31373739362c31373830342c31373831302c31373831332c31373832332c31373834352c31373834362c31373838382c31373839342c31373930352c31373931302c31373935372c31373936372c31373938372c31373939342c31383030322c31383030332c31383031312c31383032302c31383032392c31383034362c31383036382c31383037322c31383131372c31383133372c31383134302c31383134332c31383136322c31383137302c31383137342c31383138342c31383138392c31383139392c31383230382c31383232302c31383235312c31383235332c31383237392c31383238312c31383239312c31383239382c31383330312c31383331362c31383332382c31383334312c31383336332c31383337342c31383338352c31383338372c31383434392c31383437362c31383438322c31383439382c31383530352c31383530362c31383531342c31383532362c31383532382c31383533382c31383535322c31383535382c31383537342c31383538342c31383539322c31383631392c32c3832392c3834382c3835312c3835342c3836352c3838332c3838342c3839332c3839372c3930392c3937312c3938362c3939352c313032312c313032362c313035312c313036322c313036382c313038322c313038332c313038352c313133312c313134392c313135392c313136342c313137322c313137332c313231372c313231382c313234372c313239332c313330382c313331352c313333302c313335302c313336342c313337392c313430302c313430362c313432372c313434392c313436342c313436362c313436372c313437362c313530312c313530342c313532302c313532352c313533322c313534322c313536372c313537362c313538322c313538332c313632362c313633322c313633332c313634312c313635322c313730302c313732392c313831322c313832302c313834322c313835392c313837312c313930352c313930372c313931322c313931332c313935362c313936302c313937342c323030302c323031302c323033322c323033372c323037372c323038372c323039382c323130372c323131382c323133322c323133382c323135312c323230332c323230392c323231312c323233372c323234382c323235332c323237372c323238302c323330382c323331342c323333322c323334332c323334382c373535362c373535382c373537372c373630392c373631382c373633392c373635342c373635352c373731392c373732322c373732332c373830342c373832372c373833362c373833372c373835302c373835332c373835362c373837382c373839362c373931392c373933312c373933332c373934332c373934362c373935342c383030302c383031302c383031342c383033302c383034332c383035352c383036342c383036382c383037362c383132322c383134332c383134382c383136362c383139302c383234372c383235312c383236302c383237352c383238312c383238352c383330362c383332352c383337332c383337372c383338372c383339372c383339382c383431362c383433312c383436362c383436372c383437372c383438332c383438392c383439322c383439382c383531372c383533302c383533352c383534302c383536392c383539392c383631322c383634322c383635322c383637302c383730312c383733342c383738382c383739312c383832372c383834352c383835312c383836312c383837362c383932392c383933372c383935322c383937362c393031362c393032302c393032372c393032392c393034382c393036302c393038392c393130332c393130362c393131312c393131322c393131382c393133342c393134392c393137372c393137382c393231312c393231322c393232392c393234332c393236312c393236322c393238362c393239372c393331382c393333392c393338312c393339352c393339362c393431372c393433302c393436332c393439322c393532342c393633332c393633352c393634322c393639322c393731382c393732342c393732362c393733352c393735362c393738302c393738322c393739332c393831332c393837312c393839382c393931382c393932332c393932362c393934312c393934392c393935322c393935382c393936312c393936342c393937352c31303030362c31303032362c31303032392c31303035382c31303037342c31303037392c31303131302c31303132332c31303133392c31303134382c31303135362c31303136392c31303230362c31303235352c31303235372c31303235382c31303237332c31303237342c31303239312c31303239332c31303239342c31303330352c31303334312c31303334332c31303338322c31303338332c31303430342c31303431312c31303431332c31303432302c31303434322c31303434342c31303435372c31303436302c31303437322c31303438372c31303532322c31303535312c31303536342c31303636352c31303638352c31303730302c31303730362c31303733322c31303734332c31303737322c31303831352c31303833332c31303834332c31303836362c31303839322c31303930382c31303938382c31313033362c31313034312c31313037312c31313038322c31313039322c31313039392c31313130392c31313131352c31313134362c31313139332c31313230302c31313232382c31313232392c31313235342c31313236372c31313238302c31313239332c31313239352c31313331312c31313331382c31313332322c31313334302c31313334342c31313335322c31313335342c31313335352c31313335362c31313338352c31313430322c31313431332c31313433342c31313434322c31313436382c31313437322c31313437372c31313439362c31313439392c31313530362c31313531302c31313532342c31313532372c31313534342c31313538312c31313539322c31313630342c31313633352c31313635382c31313733332c31313733362c31313735342c31313739342c31313831332c31313831392c31313832342c31313832372c31313836392c31313837312c31313931342c31313937302c31313937342c31323031362c31323031392c31323034302c31323034342c31323035342c31323036382c31323037302c31323037372c31323039392c31323130342c31323133302c31323133392c31323135302c31323135392c31323136302c31323137352c31323230302c31323230322c31323232382c31323233392c31323330352c31323336382c31323337352c31323337392c31323338392c31323430372c31323431302c31323433322c31323434302c31323434312c31323437352c31323530362c31323531322c31323531332c31323531372c31323532312c31323533302c31323538302c31323633362c31323636392c31323637322c31323637362c31323637372c31323638332c31323638372c31323730352c31323732342c31323734362c31323734382c31323737362c31323739392c31323838352c31323839392c31323930372c31323933302c31323933322c31323935382c31323939332c31333030332c31333033302c31333036312c31333038302c31333038332c31333130352c31333132372c31333133312c31333136392c31333138312c31333138322c31333138352c3133323231231333236352c31333238362c31333234322cc31333239342c3131333438362c1e233332362c31333333392c31333336352c31333337332c31333338352c31333339392c31333433332c31333435312c31333437382c3", - * "genesis_signature": "" - * } - */ - CertificateMessage: { - /** - * Format: bytes - * @description Hash of the current certificate - */ - hash: string; - /** - * Format: bytes - * @description Hash of the previous certificate - */ - previous_hash: string; - epoch: components["schemas"]["Epoch"]; - /** @deprecated */ - beacon?: components["schemas"]["CardanoDbBeacon"]; - signed_entity_type: components["schemas"]["SignedEntityType"]; - metadata: components["schemas"]["CertificateMetadata"]; - protocol_message: components["schemas"]["ProtocolMessage"]; - /** - * Format: bytes - * @description Hash of the protocol message that is signed by the signer participants - */ - signed_message: string; - /** - * Format: bytes - * @description Aggregate verification key used to verify the multi signature - */ - aggregate_verification_key: string; - /** - * Format: bytes - * @description STM multi signature created from a quorum of single signatures from the signers - */ - multi_signature: string; - /** - * Format: bytes - * @description Genesis signature created to bootstrap the certificate chain with the Cardano Genesis Keys - */ - genesis_signature: string; - }; - /** - * @description SnapshotListMessage represents a list of snapshots - * @example [ - * { - * "digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "size": 26058531636, - * "created_at": "2022-07-21T17:32:28Z", - * "locations": [ - * "https://mithril-cdn-us.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "https://mithril-cdn-eu.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "magnet:?xt=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C", - * "ipfs:QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT" - * ] - * } - * ] - */ - SnapshotListMessage: components["schemas"]["Snapshot"][]; - /** - * @description Snapshot represents a snapshot file and its metadata - * @example { - * "digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "size": 26058531636, - * "created_at": "2022-07-21T17:32:28Z", - * "locations": [ - * "https://mithril-cdn-us.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "https://mithril-cdn-eu.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "magnet:?xt=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C", - * "ipfs:QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT" - * ], - * "compression_algorithm": "zstandard", - * "cardano_node_version": "1.0.0" - * } - */ - Snapshot: { - /** - * Format: bytes - * @description Digest that is signed by the signer participants - */ - digest: string; - beacon: components["schemas"]["CardanoDbBeacon"]; - /** - * Format: bytes - * @description Hash of the associated certificate - */ - certificate_hash: string; - /** - * Format: int64 - * @description Size of the snapshot file in Bytes - */ - size: number; - /** - * Format: date-time - * @description Date and time at which the snapshot was created - */ - created_at: string; - /** @description Locations where the binary content of the snapshot can be retrieved */ - locations: string[]; - /** @description Compression algorithm for the snapshot archive */ - compression_algorithm?: string; - /** @description Version of the Cardano node which is used to create snapshot archives. */ - cardano_node_version?: string; - }; - /** - * @description This message represents a snapshot file and its metadata. - * @example { - * "digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "size": 26058531636, - * "created_at": "2022-07-21T17:32:28Z", - * "locations": [ - * "https://mithril-cdn-us.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "https://mithril-cdn-eu.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "magnet:?xt=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C", - * "ipfs:QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT" - * ], - * "compression_algorithm": "zstandard", - * "cardano_node_version": "1.0.0" - * } - */ - SnapshotMessage: components["schemas"]["Snapshot"]; - /** - * @description SnapshotDownloadMessage represents a downloaded snapshot event - * @example { - * "digest": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "beacon": { - * "network": "mainnet", - * "epoch": 329, - * "immutable_file_number": 7060000 - * }, - * "size": 26058531636, - * "locations": [ - * "https://mithril-cdn-us.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "https://mithril-cdn-eu.iohk.io/snapshot/6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "magnet:?xt=urn:sha1:YNCKHTQCWBTRNJIV4WNAE52SJUQCZO5C", - * "ipfs:QmPXME1oRtoT627YKaDPDQ3PwA8tdP9rWuAAweLzqSwAWT" - * ], - * "compression_algorithm": "zstandard", - * "cardano_node_version": "1.0.0" - * } - */ - SnapshotDownloadMessage: { - /** - * Format: bytes - * @description Digest that is signed by the signer participants - */ - digest: string; - beacon: components["schemas"]["CardanoDbBeacon"]; - /** - * Format: int64 - * @description Size of the snapshot file in Bytes - */ - size: number; - /** @description Locations where the binary content of the snapshot can be retrieved */ - locations: string[]; - /** @description Compression algorithm for the snapshot archive */ - compression_algorithm: string; - /** @description Version of the Cardano node which is used to create snapshot archives. */ - cardano_node_version: string; - }; - /** @description MithrilStakeDistributionListMessage represents a list of Mithril stake distribution */ - MithrilStakeDistributionListMessage: { - epoch: components["schemas"]["Epoch"]; - /** - * Format: bytes - * @description Hash of the Mithril stake distribution - */ - hash: string; - /** - * Format: bytes - * @description Hash of the associated certificate - */ - certificate_hash?: string; - /** - * Format: date-time, - * @description Date and time at which the Mithril stake distribution was created - */ - created_at: string; - }[]; - /** - * @description This message represents a Mithril stake distribution. - * @example { - * "epoch": 123, - * "hash": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "signers": [ - * { - * "party_id": "1234567890", - * "verification_key": "7b12766b223a5c342b39302c32392c39392c39382c3131313138342c32252c32352c31353", - * "verification_key_signature": "7b5473693727369676d61223a7b227369676d6d61223a7b261223a9b227369676d61213a", - * "operational_certificate": "5b73136372c38302c37342c3136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537", - * "kes_period": 123, - * "stake": 1234 - * }, - * { - * "party_id": "2345678900", - * "verification_key": "7b392c39392c13131312766b223a5c39382c313342b39302c252c32352c31353328342c32", - * "verification_key_signature": "2c33302c3133312c3138322c34362c3133352c372c3139302c3235322c35352c32322c39", - * "operational_certificate": "3231342c3137372c37312c3232352c3233332c3135335d2c322c3139322c5b3133352c34312c3230332c3131332c3c33352c3234302c3230392c312c32392c3233332c33342c3138382c3134312c3130342c3234382c3231392c3", - * "kes_period": 456, - * "stake": 2345 - * } - * ], - * "created_at": "2022-06-14T10:52:31Z", - * "protocol_parameters": { - * "k": 5, - * "m": 100, - * "phi_f": 0.65 - * } - * } - */ - MithrilStakeDistributionMessage: { - epoch: components["schemas"]["Epoch"]; - /** - * Format: bytes - * @description Hash of the Mithril stake distribution - */ - hash: string; - /** - * Format: bytes - * @description Hash of the associated certificate - */ - certificate_hash?: string; - /** @description The list of the signers with their stakes and verification keys */ - signers: components["schemas"]["SignerWithStake"][]; - /** - * Format: date-time, - * @description Date and time of the entity creation - */ - created_at: string; - protocol_parameters: components["schemas"]["ProtocolParameters"]; - }; - /** @description CardanoTransactionSnapshotListMessage represents a list of Cardano transactions set snapshots */ - CardanoTransactionSnapshotListMessage: { - /** - * Format: bytes - * @description Hash of the Cardano transactions set - */ - hash: string; - /** - * Format: bytes - * @description Hash of the associated certificate - */ - certificate_hash: string; - /** - * Format: bytes - * @description Merkle root of the Cardano transactions set - */ - merkle_root: string; - epoch: components["schemas"]["Epoch"]; - /** - * Format: int64 - * @description Cardano block number - */ - block_number: number; - /** - * Format: date-time, - * @description Date and time at which the Cardano transactions set was created - */ - created_at: string; - }[]; - /** - * @description This message represents a Cardano transactions set snapshot. - * @example { - * "hash": "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "merkle_root": "33bfd17bc082ab5dd1fc0788241c70aa5325241c70aa532530d190809c5391bbc307905e8372", - * "epoch": 123, - * "block_number": 1234, - * "created_at": "2022-06-14T10:52:31Z" - * } - */ - CardanoTransactionSnapshotMessage: { - /** - * Format: bytes - * @description Hash of the Cardano transactions set - */ - hash: string; - /** - * Format: bytes - * @description Hash of the associated certificate - */ - certificate_hash: string; - /** - * Format: bytes - * @description Merkle root of the Cardano transactions set - */ - merkle_root: string; - epoch: components["schemas"]["Epoch"]; - /** - * Format: int64 - * @description Cardano block number - */ - block_number: number; - /** - * Format: date-time, - * @description Date and time at which the Cardano transactions set was created - */ - created_at: string; - }; - /** - * @description This message represents proofs for Cardano Transactions. - * @example { - * "certificate_hash": "7905e83ab5d7bc082c1bbc3033bfd19c539078830d19080d1f241c70aa532572", - * "certified_transactions": [ - * { - * "transactions_hashes": [ - * "6367ee65d0d1272e6e70736a1ea2cae34015874517f6328364f6b73930966732", - * "5d0d1272e6e70736a1ea2cae34015876367ee64517f6328364f6b73930966732" - * ], - * "proof": "5b73136372c38302c37342c3136362c313535b5b323136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c313532352c3230332c3235352c313030262c33136362c313535b5b3232352c3230332c3235352c313030262c38322c39382c32c39332c3138342c31358322c39382c32c39332c3138342c3135362c3136362c32312c3131312c3232312c36332c3137372c3232332c3232332c31392c3537" - * } - * ], - * "non_certified_transactions": [ - * "732d0d1272e6e70736367ee6f6328364f6b739309666a1ea2cae34015874517" - * ], - * "latest_block_number": 7060000 - * } - */ - CardanoTransactionProofMessage: { - /** - * Format: bytes - * @description Hash of the certificate that validate the merkle root of this proof - */ - certificate_hash: string; - /** @description Proofs for certified Cardano transactions */ - certified_transactions: { - transactions_hashes: string[]; - /** - * Format: bytes - * @description Proof for the Cardano transactions - */ - proof: string; - }[]; - non_certified_transactions: string[]; - /** - * Format: int64 - * @description Last block number - */ - latest_block_number: number; - }; - /** - * @description Internal error representation - * @example { - * "label": "Internal error", - * "message": "An error occurred, the operation could not be completed" - * } - */ - Error: { - /** @description optional label */ - label?: string; - /** - * @description error message - * @example An error occurred, the operation could not be completed - */ - message: string; - }; }; responses: { /** @description Bad request */ diff --git a/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap b/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap index b75fffde..99873ab5 100644 --- a/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap +++ b/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap @@ -4546,6 +4546,526 @@ exports[`getSchemaForEndpoint > generateSchemas 1`] = ` }, }, }, + "/api/v2/": { + "response": { + "200": { + "properties": { + "backend": { + "properties": { + "bestBlockHash": { + "type": "string", + }, + "blocks": { + "type": "integer", + }, + "chain": { + "type": "string", + }, + "difficulty": { + "type": "string", + }, + "headers": { + "type": "integer", + }, + "protocolVersion": { + "type": "string", + }, + "sizeOnDisk": { + "type": "integer", + }, + "subversion": { + "type": "string", + }, + "version": { + "type": "string", + }, + }, + "type": "object", + }, + "blockbook": { + "properties": { + "about": { + "type": "string", + }, + "bestHeight": { + "type": "integer", + }, + "buildTime": { + "type": "string", + }, + "coin": { + "type": "string", + }, + "currentFiatRatesTime": { + "type": "string", + }, + "dbSize": { + "type": "integer", + }, + "decimals": { + "type": "integer", + }, + "gitCommit": { + "type": "string", + }, + "hasFiatRates": { + "type": "boolean", + }, + "historicalFiatRatesTime": { + "type": "string", + }, + "host": { + "type": "string", + }, + "inSync": { + "type": "boolean", + }, + "inSyncMempool": { + "type": "boolean", + }, + "initialSync": { + "type": "boolean", + }, + "lastBlockTime": { + "type": "string", + }, + "lastMempoolTime": { + "type": "string", + }, + "mempoolSize": { + "type": "integer", + }, + "syncMode": { + "type": "boolean", + }, + "version": { + "type": "string", + }, + }, + "type": "object", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "backend": { + "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", + "blocks": 784299, + "chain": "main", + "difficulty": "47887764338536.25", + "headers": 784299, + "protocolVersion": "70016", + "sizeOnDisk": 534828732178, + "subversion": "/Satoshi:24.0.1/", + "version": "240001", + }, + "blockbook": { + "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook", + "bestHeight": 784299, + "buildTime": "2023-02-27T02:40:48+00:00", + "coin": "Bitcoin", + "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", + "dbSize": 399834379691, + "decimals": 8, + "gitCommit": "83fe6672", + "hasFiatRates": true, + "historicalFiatRatesTime": "2023-04-07T00:00:00Z", + "host": "s4", + "inSync": true, + "inSyncMempool": true, + "initialSync": false, + "lastBlockTime": "2023-04-07T02:55:40.032567054Z", + "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", + "mempoolSize": 30785, + "syncMode": true, + "version": "0.4.0", + }, + }, + }, + }, + }, + }, + "/api/v2/address/{address}": { + "response": { + "200": { + "additionalProperties": true, + "type": "object", + }, + }, + }, + "/api/v2/block-index/{blockHeight}": { + "response": { + "200": { + "properties": { + "blockHash": { + "type": "string", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e", + }, + }, + }, + }, + }, + "/api/v2/block/{blockHashOrHeight}": { + "response": { + "200": { + "properties": { + "bits": { + "type": "string", + }, + "confirmations": { + "type": "integer", + }, + "difficulty": { + "type": "string", + }, + "hash": { + "type": "string", + }, + "height": { + "type": "integer", + }, + "itemsOnPage": { + "type": "integer", + }, + "merkleRoot": { + "type": "string", + }, + "nextBlockHash": { + "type": "string", + }, + "nonce": { + "type": "string", + }, + "page": { + "type": "integer", + }, + "previousBlockHash": { + "type": "string", + }, + "size": { + "type": "integer", + }, + "time": { + "type": "integer", + }, + "totalPages": { + "type": "integer", + }, + "txCount": { + "type": "integer", + }, + "txs": { + "items": { + "properties": { + "blockHash": { + "type": "string", + }, + "blockHeight": { + "type": "integer", + }, + "blockTime": { + "type": "integer", + }, + "confirmations": { + "type": "integer", + }, + "fees": { + "type": "string", + }, + "txid": { + "type": "string", + }, + "value": { + "type": "string", + }, + "valueIn": { + "type": "string", + }, + "vin": { + "items": { + "properties": { + "isAddress": { + "type": "boolean", + }, + "n": { + "type": "integer", + }, + "value": { + "type": "string", + }, + }, + "type": "object", + }, + "type": "array", + }, + "vout": { + "items": { + "properties": { + "addresses": { + "items": { + "type": "string", + }, + "type": "array", + }, + "isAddress": { + "type": "boolean", + }, + "n": { + "type": "integer", + }, + "value": { + "type": "string", + }, + }, + "type": "object", + }, + "type": "array", + }, + }, + "type": "object", + }, + "type": "array", + }, + "version": { + "type": "integer", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "bits": "1d00ffff", + "confirmations": 784303, + "difficulty": "1", + "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "height": 1, + "itemsOnPage": 1000, + "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", + "nonce": "2573394689", + "page": 1, + "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", + "size": 215, + "time": 1231469665, + "totalPages": 1, + "txCount": 1, + "txs": [ + { + "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "blockHeight": 1, + "blockTime": 1231469665, + "confirmations": 784303, + "fees": "0", + "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "value": "5000000000", + "valueIn": "0", + "vin": [ + { + "isAddress": false, + "n": 0, + "value": "0", + }, + ], + "vout": [ + { + "addresses": [ + "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX", + ], + "isAddress": true, + "n": 0, + "value": "5000000000", + }, + ], + }, + ], + "version": 1, + }, + }, + }, + }, + }, + "/api/v2/sendtx": { + "response": { + "200": { + "properties": { + "result": { + "type": "string", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25", + }, + }, + }, + }, + }, + "/api/v2/sendtx/{hex}": { + "response": { + "200": { + "properties": { + "result": { + "type": "string", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25", + }, + }, + }, + }, + }, + "/api/v2/tx-specific/{txId}": { + "response": { + "200": { + "additionalProperties": true, + "type": "object", + }, + }, + }, + "/api/v2/utxo/{addressOrXpub}": { + "response": { + "200": { + "items": {}, + "type": "array", + }, + }, + }, + "/api/v2/xpub/{xpub}": { + "response": { + "200": { + "properties": { + "address": { + "type": "string", + }, + "balance": { + "type": "string", + }, + "itemsOnPage": { + "type": "integer", + }, + "page": { + "type": "integer", + }, + "secondaryValue": { + "type": "number", + }, + "tokens": { + "items": { + "properties": { + "balance": { + "type": "string", + }, + "decimals": { + "type": "integer", + }, + "name": { + "type": "string", + }, + "path": { + "type": "string", + }, + "totalReceived": { + "type": "string", + }, + "totalSent": { + "type": "string", + }, + "transfers": { + "type": "integer", + }, + "type": { + "type": "string", + }, + }, + "type": "object", + }, + "type": "array", + }, + "totalPages": { + "type": "integer", + }, + "totalReceived": { + "type": "string", + }, + "totalSent": { + "type": "string", + }, + "txids": { + "items": { + "type": "string", + }, + "type": "array", + }, + "txs": { + "type": "integer", + }, + "unconfirmedBalance": { + "type": "string", + }, + "unconfirmedTxs": { + "type": "integer", + }, + "usedTokens": { + "type": "integer", + }, + }, + "type": "object", + "x-examples": { + "Example 1": { + "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", + "balance": "90000000", + "itemsOnPage": 1000, + "page": 1, + "secondaryValue": 21195.47633568, + "tokens": [ + { + "balance": "90000000", + "decimals": 8, + "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", + "path": "m/44'/3'/0'/0/0", + "totalReceived": "2903986975", + "totalSent": "2803986975", + "transfers": 3, + "type": "XPUBAddress", + }, + { + "balance": "0", + "decimals": 8, + "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", + "path": "m/44'/3'/0'/1/0", + "totalReceived": "279394275", + "totalSent": "279394275", + "transfers": 2, + "type": "XPUBAddress", + }, + ], + "totalPages": 1, + "totalReceived": "3093381250", + "totalSent": "3083381250", + "txids": [ + "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", + "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", + "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", + "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", + "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f", + ], + "txs": 5, + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "usedTokens": 2, + }, + }, + }, + }, + }, "/assets": { "querystring": { "properties": { From 416fc992f3aa2e4f179abcac625c1d09733ab7bc Mon Sep 17 00:00:00 2001 From: slowbackspace Date: Tue, 21 Apr 2026 13:10:02 +0200 Subject: [PATCH 2/2] chore: bitcoin-like networks on /blockbook --- blockbook.yaml | 608 ++++++-- blockfrost-openapi.yaml | 122 +- docs/blockbook/blockbook-openapi.yaml | 1308 +++++++++++++++++ docs/blockbook/index.html | 55 + docs/blockfrost-openapi.yaml | 1058 ++----------- docs/midnight/index.html | 294 ++-- json-schema.json | 2 +- openapi-merge.json | 2 +- openapi.json | 1115 +------------- openapi.yaml | 1058 ++----------- package.json | 3 +- src/definitions.yaml | 122 +- .../get-schema-for-endpoint.test.ts.snap | 520 ------- vercel.json | 5 + 14 files changed, 2362 insertions(+), 3910 deletions(-) create mode 100644 docs/blockbook/blockbook-openapi.yaml create mode 100644 docs/blockbook/index.html diff --git a/blockbook.yaml b/blockbook.yaml index 5d54e30c..b408b0e8 100644 --- a/blockbook.yaml +++ b/blockbook.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - version: 0.4.0 + version: 0.1.0 title: Blockfrost.io ~ Blockbook API documentation x-logo: url: https://staging.blockfrost.io/images/logo.svg @@ -13,22 +13,200 @@ info: name: MIT url: "https://opensource.org/licenses/MIT" termsOfService: "https://blockfrost.io/terms" + description: | + Blockfrost provides access to Bitcoin, Litecoin and Dogecoin blockchains through the Blockbook API. + + ## Quick Start + + Create a Bitcoin project on [blockfrost.io](https://blockfrost.io) and make your first API call: + + **Get a block by height:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/block/1 \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "height": 1, + "confirmations": 946061, + "size": 215, + "time": 1231469665, + "txCount": 1, + "txs": [ + { + "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "vin": [{ "n": 0, "isAddress": false, "value": "0" }], + "vout": [{ "value": "5000000000", "n": 0, "addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"], "isAddress": true }], + "blockHeight": 1, + "confirmations": 946061, + "blockTime": 1231469665, + "value": "5000000000", + "valueIn": "0", + "fees": "0" + } + ] + } + ``` + + **Get address balance:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/address/12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX?details=basic \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "address": "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX", + "balance": "5135259889", + "totalReceived": "5135259889", + "totalSent": "0", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 226 + } + ``` + + **Get xpub balance and transactions:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/xpub/xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz?tokens=nonzero&pageSize=3 \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "page": 1, + "totalPages": 10, + "itemsOnPage": 3, + "address": "xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz", + "balance": "12835640", + "totalReceived": "13055640", + "totalSent": "220000", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 28, + "addrTxCount": 28, + "txids": [ + "88aa69107bccdddb23df8b2635ff759cdc5e6873b91bef91325f70060973299a", + "38d733842aeddcad34d0e4ef4e498fc0defa4fb9e47c9a4163b8e13483c00f3c", + "57392367f583c8cdaabf67897eef088dbaab73936ff9dddaa448c2bedc3fad4d" + ], + "usedTokens": 23, + "tokens": [ + { + "type": "XPUBAddress", + "name": "1EfgV2Hr5CDjXPavHDpDMjmU33BA2veHy6", + "path": "m/44'/0'/0'/0/0", + "transfers": 3, + "decimals": 8, + "balance": "10665", + "totalReceived": "110665", + "totalSent": "100000" + }, + { + "type": "XPUBAddress", + "name": "1CcEugXu9Yf9Qw5cpB8gHUK4X9683WyghM", + "path": "m/44'/0'/0'/0/2", + "transfers": 2, + "decimals": 8, + "balance": "19493", + "totalReceived": "19493", + "totalSent": "0" + }, + "..." + ] + } + ``` + + ## Authentication + + After signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project. + Your request must include this `project_id` in the HTTP header to authenticate against Blockfrost servers. + + ``` + project_id: YOUR_PROJECT_ID + ``` + + ## Available networks + + Each network has its own `project_id`. Select the appropriate server from the dropdown above. + + + + + + + + + + + + + + + + + + + + + + + + +
NetworkEndpoint
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
+ + ## Concepts + + * All crypto amounts are returned as strings in the lowest denomination (e.g. satoshis for Bitcoin, litoshis for Litecoin), without a decimal point. + * Data is returned in *descending* (newest first, oldest last) order by block height. + * Results are paginated. The `pageSize` parameter (1-1000, default 1000) controls items per page for most endpoints. Block endpoints always return 1000 transactions per page. + * Empty or irrelevant fields may be omitted from responses. + * All values are case sensitive. + + ## Errors + + In addition to error responses returned by Blockbook (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost: + + * HTTP `400` return code is used when the request is not valid. + * HTTP `402` return code is used when the projects exceed their daily request limit. + * HTTP `403` return code is used when the request is not authenticated. + * HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`. + * HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited. + * HTTP `500` return code is used when our endpoints are having a problem. + + ## Limits + + There are two types of limits we are enforcing: + + The first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time. + + The second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow + each user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another + whole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed. + We believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and + we will make sure to take it into account as much as we can. servers: - - url: https://bitcoin-mainnet.blockfrost.io + - url: https://bitcoin-mainnet.blockfrost.io/api/v2 description: Bitcoin mainnet network - - url: https://litecoin-mainnet.blockfrost.io + - url: https://bitcoin-testnet.blockfrost.io/api/v2 + description: Bitcoin testnet network + - url: https://litecoin-mainnet.blockfrost.io/api/v2 description: Litecoin mainnet network - - url: https://dogecoin-mainnet.blockfrost.io + - url: https://dogecoin-mainnet.blockfrost.io/api/v2 description: Dogecoin mainnet network security: - project_id: [] paths: "/status": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io get: tags: - Bitcoin @@ -36,7 +214,8 @@ paths: - Dogecoin summary: Blockchain status operationId: getStatus - description: Get current status of Blockbook and its backend + description: | + Returns the current status of both the Blockbook indexer and the connected blockchain backend, including sync state, best block height, mempool info, database size, and backend version details. responses: "200": description: OK @@ -176,10 +355,6 @@ paths: protocolVersion: "70016" "/block/{blockHashOrHeight}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io parameters: - $ref: "#/components/parameters/blockHashOrHeight" get: @@ -347,23 +522,18 @@ paths: fees: "0" description: OK operationId: getBlockV2 - description: |- - Returns information about block with transactions, subject to paging. + description: | + Returns information about a block including its transactions, subject to paging (1000 transactions per page). - Note: Blockbook always follows the main chain of the backend it is attached to. If there is a rollback-reorg in the backend, Blockbook will also do rollback. When you ask for block by height, you will always get the main chain block. If you ask for block by hash, you may get the block from another fork but it is not guaranteed (backend may not keep it) + You can query by either block hash or block height. parameters: - $ref: "#/components/parameters/page" - - $ref: "#/components/parameters/pageSize" tags: - Bitcoin - Litecoin - Dogecoin # - Blocks "/block-index/{blockHeight}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io parameters: - $ref: "#/components/parameters/blockHeight" get: @@ -386,24 +556,152 @@ paths: value: blockHash: ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e operationId: getBlockHashV2 - description: |- - Get block hash by its height - - Note: Blockbook always follows the main chain of the backend it is attached to. + description: | + Returns the block hash for a given block height. tags: - Bitcoin - Litecoin - Dogecoin # - Blocks - "/tx-specific/{txId}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io + "/tx/{txId}": parameters: - $ref: "#/components/parameters/txId" get: summary: Transaction + operationId: getTxV2 + description: | + Returns normalized transaction data with a consistent structure. + + For confirmed transactions, `blockHeight` contains the block height and `confirmations` the number of confirmations. + For unconfirmed (mempool) transactions, `blockHeight` is `-1`, `confirmations` is `0`, and the response may include + `confirmationETABlocks` and `confirmationETASeconds` with estimated confirmation time. + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + txid: + type: string + description: Transaction hash + version: + type: integer + description: Transaction version + vin: + type: array + description: Transaction inputs + items: + type: object + properties: + txid: + type: string + vout: + type: integer + sequence: + type: integer + "n": + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + value: + type: string + vout: + type: array + description: Transaction outputs + items: + type: object + properties: + value: + type: string + "n": + type: integer + hex: + type: string + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + description: Hash of the block containing the transaction + blockHeight: + type: integer + description: Block height. -1 for unconfirmed transactions. + confirmations: + type: integer + description: Number of confirmations. 0 for unconfirmed transactions. + blockTime: + type: integer + description: Block timestamp (unix epoch). For unconfirmed transactions, represents when the transaction was first seen. + size: + type: integer + description: Transaction size in bytes + vsize: + type: integer + description: Virtual size for witness transactions + value: + type: string + description: Total output value + valueIn: + type: string + description: Total input value + fees: + type: string + description: Transaction fee + hex: + type: string + description: Raw transaction hex + examples: + Confirmed transaction: + value: + txid: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + version: 1 + vin: + - txid: "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9" + vout: 0 + sequence: 4294967295 + "n": 0 + addresses: + - "12cbQLTFMXRnSzktFkuoG3eHoMeFtpTu3S" + isAddress: true + value: "5000000000" + vout: + - value: "1000000000" + "n": 0 + addresses: + - "1Q2TWHE3GMdB6BZKafqwxXtWAWgFt5Jvm3" + isAddress: true + - value: "4000000000" + "n": 1 + addresses: + - "12cbQLTFMXRnSzktFkuoG3eHoMeFtpTu3S" + isAddress: true + blockHash: "00000000d1145790a8694403d4063f323d499e655c83426834d4ce2f8dd4a2ee" + blockHeight: 170 + confirmations: 946061 + blockTime: 1231731025 + size: 275 + value: "5000000000" + valueIn: "5000000000" + fees: "0" + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Transactions + "/tx-specific/{txId}": + parameters: + - $ref: "#/components/parameters/txId" + get: + summary: Transaction (raw) responses: "200": description: OK @@ -413,56 +711,51 @@ paths: type: object additionalProperties: true examples: - zCash: + Bitcoin: value: - hex: 040000808...8e6e73cb009 - txid: 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 - overwintered: true - version: 4 - versiongroupid: 892f2085 + txid: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + hash: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + version: 1 + size: 275 + vsize: 275 + weight: 1100 locktime: 0 - expiryheight: 495680 - vin: [] - vout: [] - vjoinsplit: [] - valueBalance: 0 - vShieldedSpend: - - cv: 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 - anchor: 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a - rk: 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 - proof: aecf824dbae8eea863ec6...73878c37391f01df520aa - spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 - - cv: a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c - anchor: 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 - rk: 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 - proof: a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 - spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 - vShieldedOutput: - - cv: 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab - cmu: 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc - ephemeralKey: 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 - encCiphertext: a533d3b99b...a0204 - outCiphertext: 4baabc15199504b1...c1ad6a - proof: aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 - bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 - blockhash: 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af - confirmations: 5222 - time: 1552301566 - blocktime: 1552301566 + vin: + - txid: "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9" + vout: 0 + scriptSig: + asm: "304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd41..." + hex: "47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd41..." + sequence: 4294967295 + vout: + - value: 10.0 + "n": 0 + scriptPubKey: + asm: "04ae1a62fe09c5f51b13905f07f06b99a2f7159b2225f374cd378d71302fa284... OP_CHECKSIG" + hex: "4104ae1a62fe09c5f51b13905f07f06b99a2f7159b2225f374cd378d71302fa284..." + type: "pubkey" + - value: 40.0 + "n": 1 + scriptPubKey: + asm: "0411db93e1dcdb8a016b49840f8c53bc1eb68a382e97b1482ecad7b148a6909a... OP_CHECKSIG" + hex: "410411db93e1dcdb8a016b49840f8c53bc1eb68a382e97b1482ecad7b148a6909a..." + type: "pubkey" + hex: "0100000001c997a5e56e104102fa209c6a852dd9..." + blockhash: "00000000d1145790a8694403d4063f323d499e655c83426834d4ce2f8dd4a2ee" + confirmations: 945997 + time: 1231731025 + blocktime: 1231731025 operationId: getTxSpecificV2 - description: "Returns transaction data in the exact format as returned by backend, including all coin specific fields" + description: | + Returns transaction data in the exact format as returned by the backend, including all coin-specific fields that are not available in a normalized transaction response. + + Use this endpoint when you need access to raw, backend-specific transaction details such as witness data or other chain-specific properties. tags: - Bitcoin - Litecoin - Dogecoin # - Transactions "/address/{address}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io parameters: - $ref: "#/components/parameters/address" get: @@ -517,20 +810,18 @@ paths: # balance: "4913000000" operationId: getAddressV2 description: | - Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first. - - The **details** query parameter can specify the level of details returned by the request (default: "txids"). - Possible values are: - - **basic**: return only xpub balances, without any derived addresses and transactions + Returns balances and transactions of an address. - **tokens**: basic + tokens (addresses) derived from the xpub, subject to tokens parameter + The **details** query parameter controls the level of detail in the response (default: `txids`): - **tokenBalances**: basic + tokens (addresses) derived from the xpub with balances, subject to tokens parameter + | Value | Description | + |-------|-------------| + | `basic` | Address balances only (`balance`, `totalReceived`, `totalSent`, `txs` count). No pagination, no transaction data. | + | `txids` | *(default)* Adds pagination (`page`, `totalPages`, `itemsOnPage`) and a `txids` array of transaction hashes. Subject to `from`/`to` block height filter and `page`/`pageSize` paging. | + | `txslight` | Replaces `txids` with a `transactions` array containing lightweight tx objects — vin/vout with addresses and values, block info, fees. No `hex`, `version`, `lockTime`, `size`, or `vsize` fields. Subject to paging. | + | `txs` | Full transaction details — everything in `txslight` plus `version`, `lockTime`, `size`, `vsize`, and raw `hex`. Subject to paging. | - **txids**: tokenBalances + list of txids, subject to from, to filter and paging - - **txs**: tokenBalances + list of transaction with details, subject to from, to filter and paging + Use the **secondary** parameter (e.g. `secondary=usd`) to include fiat value of the balance in the response. parameters: - $ref: "#/components/parameters/page" - $ref: "#/components/parameters/pageSize" @@ -538,10 +829,6 @@ paths: - $ref: "#/components/parameters/toBlock" - $ref: "#/components/parameters/details" "/xpub/{xpub}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io parameters: - $ref: "#/components/parameters/xpub" get: @@ -578,8 +865,12 @@ paths: type: array items: type: string + addrTxCount: + type: integer + description: Total number of transactions across all derived addresses. usedTokens: type: integer + description: Total number of used addresses of the xpub, regardless of the tokens parameter. tokens: type: array items: @@ -679,14 +970,36 @@ paths: totalSent: "279394275" secondaryValue: 21195.47633568 operationId: getXpubV2 - description: |- - Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins. + description: | + Returns balances and transactions of an extended public key. + + Supported derivation schemes: - Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation schemes, using either xpubs or output descriptors (see https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) + | Scheme | Descriptor format | + |--------|-------------------| + | BIP44 | `pkh(xpub)` | + | BIP49 | `sh(wpkh(xpub))` | + | BIP84 | `wpkh(xpub)` | + | BIP86 (Taproot) | `tr(xpub)` | - Note: usedTokens always returns total number of used addresses of xpub. + The **details** query parameter controls the level of detail in the response (default: `txids`): - Detailed documentation found here: https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub + | Value | Description | + |-------|-------------| + | `basic` | Address balances only (`balance`, `totalReceived`, `totalSent`, `txs` count). No pagination, no transaction data. | + | `txids` | *(default)* Adds pagination (`page`, `totalPages`, `itemsOnPage`) and a `txids` array of transaction hashes. Subject to `from`/`to` block height filter and `page`/`pageSize` paging. | + | `txslight` | Replaces `txids` with a `transactions` array containing lightweight tx objects — vin/vout with addresses and values, block info, fees. No `hex`, `version`, `lockTime`, `size`, or `vsize` fields. Subject to paging. | + | `txs` | Full transaction details — everything in `txslight` plus `version`, `lockTime`, `size`, `vsize`, and raw `hex`. Subject to paging. | + + The **tokens** parameter controls which derived addresses (BIP44 child addresses) are included in the response: + + | Value | Description | + |-------|-------------| + | `nonzero` | *(default)* Only derived addresses with a non-zero balance. Addresses that received funds but spent them all (balance = 0) are excluded. | + | `used` | All derived addresses that have at least one transaction, including those with zero balance. | + | `derived` | All derived addresses in the derivation gap, including those that have never been used. Unused addresses lack `balance`, `totalReceived`, and `totalSent` fields. | + + Use the **secondary** parameter (e.g. `secondary=usd`) to include fiat value of the balance. parameters: - $ref: "#/components/parameters/page" - $ref: "#/components/parameters/pageSize" @@ -701,10 +1014,6 @@ paths: - Litecoin - Dogecoin "/utxo/{addressOrXpub}": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io parameters: - $ref: "#/components/parameters/addressOrXpub" get: @@ -716,9 +1025,38 @@ paths: application/json: schema: type: array - items: {} + items: + type: object + properties: + txid: + type: string + description: Transaction ID + vout: + type: integer + description: Output index + value: + type: string + description: UTXO amount in the lowest denomination (satoshis) + height: + type: integer + description: Block height. Omitted for unconfirmed UTXOs. + confirmations: + type: integer + description: Number of confirmations. 0 for unconfirmed UTXOs. + lockTime: + type: integer + description: Lock time value. Only present for unconfirmed UTXOs with non-zero lock time. + coinbase: + type: boolean + description: Whether this is a coinbase UTXO. Only detected up to 100 confirmations for performance reasons. + address: + type: string + description: Derived address. Only present when querying by xpub or output descriptor. + path: + type: string + description: Derivation path. Only present when querying by xpub or output descriptor. examples: - Example 1: + Confirmed and unconfirmed: value: - txid: 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 vout: 0 @@ -736,20 +1074,13 @@ paths: value: "122492339065" height: 2646043 confirmations: 2047 - - txid: 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 - vout: 0 - value: "142771322208" - height: 2644885 - confirmations: 3205 operationId: getUTXOV2 - description: |- - Returns array of unspent transaction outputs of address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions. The query parameter confirmed=true disables return of unconfirmed transactions. The returned utxos are sorted by block height, newest blocks first. For xpubs or output descriptors, the response also contains address and derivation path of the utxo. - - + description: | + Returns an array of unspent transaction outputs (UTXOs) for an address, xpub, or output descriptor. - Unconfirmed utxos do not have field height, the field confirmations has value 0 and may contain field lockTime, if not zero. + By default, both confirmed and unconfirmed UTXOs are returned. Set `confirmed=true` to exclude unconfirmed UTXOs. - Coinbase utxos have field coinbase set to true, however due to performance reasons only up to minimum coinbase confirmations limit (100). After this limit, utxos are not detected as coinbase. + For xpubs or output descriptors, the response also includes the `address` and derivation `path` of each UTXO. parameters: - $ref: "#/components/parameters/confirmed" tags: @@ -758,10 +1089,6 @@ paths: - Litecoin - Dogecoin "/sendtx": - servers: - - url: https://bitcoin-mainnet.blockfrost.io - - url: https://litecoin-mainnet.blockfrost.io - - url: https://dogecoin-mainnet.blockfrost.io post: summary: Submit transaction operationId: postSendTxV2 @@ -775,15 +1102,32 @@ paths: properties: result: type: string - x-examples: - Example 1: - result: 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + description: Transaction ID of the submitted transaction examples: - Example 1: + Success: value: result: 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + "400": + description: Bad Request + content: + application/json: + schema: + type: object + properties: + error: + type: string + description: Error message from the backend + examples: + Malformed transaction: + value: + error: "-22: TX decode failed. Make sure the tx has at least one input." + Already spent inputs: + value: + error: "-25: bad-txns-inputs-missingorspent" description: | - Sends new transaction to backend for broadcasting + Submits a signed, raw transaction to the network for broadcasting. Send the hex-encoded transaction data as plain text in the request body. + + On success, returns the transaction ID. On error, returns an error message from the backend. requestBody: content: text/plain: @@ -823,15 +1167,18 @@ components: schema: type: integer example: 1 - description: "specifies page of returned transactions, starting from 1. If out of range, Blockbook returns the closest possible page." + description: "specifies page of returned transactions, starting from 1. If out of range, the closest possible page is returned." pageSize: name: pageSize in: query required: false schema: type: integer + minimum: 1 + maximum: 1000 + default: 1000 example: 1000 - description: number of transactions returned by call (default and maximum 1000) + description: Number of items returned per page (1-1000, default 1000) blockHeight: name: blockHeight in: path @@ -871,7 +1218,12 @@ components: - txs default: txids example: basic - description: specifies level of details returned by request + description: | + Level of detail in the response. Possible values: + `basic` — address balances only (balance, totalReceived, totalSent, txs count), no pagination, no transaction data; + `txids` — (default) adds pagination and a txids array of transaction hashes, subject to from/to filter and page/pageSize paging; + `txslight` — replaces txids with lightweight transaction objects (vin/vout with addresses and values, block info, fees), subject to paging; + `txs` — full transaction details including version, lockTime, size, vsize, and raw hex, subject to paging. fromBlock: name: fromBlock in: query @@ -879,7 +1231,7 @@ components: schema: type: integer example: 10 - description: filter of the returned transactions from block height to block height (default no filter) + description: Filter results from this block height (inclusive). Default is no filter. toBlock: name: toBlock in: query @@ -887,7 +1239,7 @@ components: schema: type: integer example: 100 - description: filter of the returned transactions from block height to block height (default no filter) + description: Filter results up to this block height (inclusive). Default is no filter. secondary: name: secondary in: query @@ -895,7 +1247,7 @@ components: schema: type: string example: usd - description: specifies secondary (fiat) currency in which the token and total balances are returned in addition to crypto values + description: Fiat currency code (e.g. `usd`, `eur`) to include fiat values alongside crypto balances in the response. xpub: name: xpub in: path @@ -903,7 +1255,7 @@ components: schema: type: string example: tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN - description: "xpub or output descriptor, applicable only for Bitcoin-type coins" + description: "Extended public key (xpub, ypub, zpub) or output descriptor. Regular addresses are not accepted — use the /address endpoint instead." tokens: name: tokens in: query @@ -916,7 +1268,11 @@ components: - used - derived example: used - description: specifies what tokens (xpub addresses) are returned by the request (default nonzero) + description: | + Controls which derived addresses (BIP44 child addresses) are included in the xpub response. + `nonzero` — (default) only addresses with non-zero balance; + `used` — all addresses with at least one transaction, including zero balance; + `derived` — all addresses in the derivation gap, including never-used ones. confirmed: name: confirmed in: query @@ -924,7 +1280,7 @@ components: schema: type: boolean example: true - description: confirmed=true disables return of unconfirmed transactions + description: Set to `true` to exclude unconfirmed UTXOs from the response. hex: name: hex in: path diff --git a/blockfrost-openapi.yaml b/blockfrost-openapi.yaml index 2c0f31d4..f85db9f3 100644 --- a/blockfrost-openapi.yaml +++ b/blockfrost-openapi.yaml @@ -28,45 +28,52 @@ info: - - + + - - + + - - + + - - + + - - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + +
- Network - - Endpoint - NetworkEndpoint
Cardano mainnet - https://cardano-mainnet.blockfrost.io/api/v0 - Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano preprod - https://cardano-preprod.blockfrost.io/api/v0 - Cardano preprodhttps://cardano-preprod.blockfrost.io/api/v0
Cardano preview - https://cardano-preview.blockfrost.io/api/v0 - Cardano previewhttps://cardano-preview.blockfrost.io/api/v0
Midnight mainnet - https://midnight-mainnet.blockfrost.io/api/v0 - Bitcoin mainnet - https://bitcoin-mainnet.blockfrost.io/api/v2 - Midnight mainnethttps://midnight-mainnet.blockfrost.io/api/v0
InterPlanetary File System - https://ipfs.blockfrost.io/api/v0 - Midnight preprodhttps://midnight-preprod.blockfrost.io/api/v0
Midnight previewhttps://midnight-preview.blockfrost.io/api/v0
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
InterPlanetary File Systemhttps://ipfs.blockfrost.io/api/v0
@@ -249,6 +256,33 @@ info: For the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference: [![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/) + + + ## Bitcoin API + + Access the Bitcoin blockchain through the Blockbook API. + + Endpoint: `https://bitcoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Bitcoin API →](https://img.shields.io/badge/Explore_the_Bitcoin_API_→-C77800?style=for-the-badge&logo=bitcoin&logoColor=white)](./blockbook/) + + + ## Litecoin API + + Access the Litecoin blockchain through the Blockbook API. + + Endpoint: `https://litecoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Litecoin API →](https://img.shields.io/badge/Explore_the_Litecoin_API_→-345D9D?style=for-the-badge&logo=litecoin&logoColor=white)](./blockbook/) + + + ## Dogecoin API + + Access the Dogecoin blockchain through the Blockbook API. + + Endpoint: `https://dogecoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Dogecoin API →](https://img.shields.io/badge/Explore_the_Dogecoin_API_→-9B7E1A?style=for-the-badge&logo=dogecoin&logoColor=white)](./blockbook/) servers: - url: https://cardano-mainnet.blockfrost.io/api/v0 description: Cardano Mainnet network @@ -263,36 +297,6 @@ security: tags: - name: Health - name: Metrics - - name: Bitcoin - description: | - Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - - name: Litecoin - description: | - Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - - name: Dogecoin - description: | - Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets diff --git a/docs/blockbook/blockbook-openapi.yaml b/docs/blockbook/blockbook-openapi.yaml new file mode 100644 index 00000000..b408b0e8 --- /dev/null +++ b/docs/blockbook/blockbook-openapi.yaml @@ -0,0 +1,1308 @@ +openapi: 3.0.0 +info: + version: 0.1.0 + title: Blockfrost.io ~ Blockbook API documentation + x-logo: + url: https://staging.blockfrost.io/images/logo.svg + altText: Blockfrost + contact: + name: Blockfrost Team + url: "https://blockfrost.io" + email: contact@blockfrost.io + license: + name: MIT + url: "https://opensource.org/licenses/MIT" + termsOfService: "https://blockfrost.io/terms" + description: | + Blockfrost provides access to Bitcoin, Litecoin and Dogecoin blockchains through the Blockbook API. + + ## Quick Start + + Create a Bitcoin project on [blockfrost.io](https://blockfrost.io) and make your first API call: + + **Get a block by height:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/block/1 \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "page": 1, + "totalPages": 1, + "itemsOnPage": 1000, + "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", + "height": 1, + "confirmations": 946061, + "size": 215, + "time": 1231469665, + "txCount": 1, + "txs": [ + { + "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", + "vin": [{ "n": 0, "isAddress": false, "value": "0" }], + "vout": [{ "value": "5000000000", "n": 0, "addresses": ["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"], "isAddress": true }], + "blockHeight": 1, + "confirmations": 946061, + "blockTime": 1231469665, + "value": "5000000000", + "valueIn": "0", + "fees": "0" + } + ] + } + ``` + + **Get address balance:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/address/12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX?details=basic \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "address": "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX", + "balance": "5135259889", + "totalReceived": "5135259889", + "totalSent": "0", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 226 + } + ``` + + **Get xpub balance and transactions:** + ```bash + curl https://bitcoin-mainnet.blockfrost.io/api/v2/xpub/xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz?tokens=nonzero&pageSize=3 \ + -H "project_id: YOUR_PROJECT_ID" + ``` + + Response: + ```json + { + "page": 1, + "totalPages": 10, + "itemsOnPage": 3, + "address": "xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz", + "balance": "12835640", + "totalReceived": "13055640", + "totalSent": "220000", + "unconfirmedBalance": "0", + "unconfirmedTxs": 0, + "txs": 28, + "addrTxCount": 28, + "txids": [ + "88aa69107bccdddb23df8b2635ff759cdc5e6873b91bef91325f70060973299a", + "38d733842aeddcad34d0e4ef4e498fc0defa4fb9e47c9a4163b8e13483c00f3c", + "57392367f583c8cdaabf67897eef088dbaab73936ff9dddaa448c2bedc3fad4d" + ], + "usedTokens": 23, + "tokens": [ + { + "type": "XPUBAddress", + "name": "1EfgV2Hr5CDjXPavHDpDMjmU33BA2veHy6", + "path": "m/44'/0'/0'/0/0", + "transfers": 3, + "decimals": 8, + "balance": "10665", + "totalReceived": "110665", + "totalSent": "100000" + }, + { + "type": "XPUBAddress", + "name": "1CcEugXu9Yf9Qw5cpB8gHUK4X9683WyghM", + "path": "m/44'/0'/0'/0/2", + "transfers": 2, + "decimals": 8, + "balance": "19493", + "totalReceived": "19493", + "totalSent": "0" + }, + "..." + ] + } + ``` + + ## Authentication + + After signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project. + Your request must include this `project_id` in the HTTP header to authenticate against Blockfrost servers. + + ``` + project_id: YOUR_PROJECT_ID + ``` + + ## Available networks + + Each network has its own `project_id`. Select the appropriate server from the dropdown above. + + + + + + + + + + + + + + + + + + + + + + + + +
NetworkEndpoint
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
+ + ## Concepts + + * All crypto amounts are returned as strings in the lowest denomination (e.g. satoshis for Bitcoin, litoshis for Litecoin), without a decimal point. + * Data is returned in *descending* (newest first, oldest last) order by block height. + * Results are paginated. The `pageSize` parameter (1-1000, default 1000) controls items per page for most endpoints. Block endpoints always return 1000 transactions per page. + * Empty or irrelevant fields may be omitted from responses. + * All values are case sensitive. + + ## Errors + + In addition to error responses returned by Blockbook (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost: + + * HTTP `400` return code is used when the request is not valid. + * HTTP `402` return code is used when the projects exceed their daily request limit. + * HTTP `403` return code is used when the request is not authenticated. + * HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`. + * HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited. + * HTTP `500` return code is used when our endpoints are having a problem. + + ## Limits + + There are two types of limits we are enforcing: + + The first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time. + + The second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow + each user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another + whole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed. + We believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and + we will make sure to take it into account as much as we can. +servers: + - url: https://bitcoin-mainnet.blockfrost.io/api/v2 + description: Bitcoin mainnet network + - url: https://bitcoin-testnet.blockfrost.io/api/v2 + description: Bitcoin testnet network + - url: https://litecoin-mainnet.blockfrost.io/api/v2 + description: Litecoin mainnet network + - url: https://dogecoin-mainnet.blockfrost.io/api/v2 + description: Dogecoin mainnet network +security: + - project_id: [] + +paths: + "/status": + get: + tags: + - Bitcoin + - Litecoin + - Dogecoin + summary: Blockchain status + operationId: getStatus + description: | + Returns the current status of both the Blockbook indexer and the connected blockchain backend, including sync state, best block height, mempool info, database size, and backend version details. + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + blockbook: + type: object + properties: + coin: + type: string + network: + type: string + host: + type: string + version: + type: string + gitCommit: + type: string + buildTime: + type: string + syncMode: + type: boolean + initialSync: + type: boolean + inSync: + type: boolean + bestHeight: + type: integer + lastBlockTime: + type: string + inSyncMempool: + type: boolean + lastMempoolTime: + type: string + mempoolSize: + type: integer + decimals: + type: integer + dbSize: + type: integer + hasFiatRates: + type: boolean + currentFiatRatesTime: + type: string + historicalFiatRatesTime: + type: string + about: + type: string + backend: + type: object + properties: + chain: + type: string + blocks: + type: integer + headers: + type: integer + bestBlockHash: + type: string + difficulty: + type: string + sizeOnDisk: + type: integer + version: + type: string + subversion: + type: string + protocolVersion: + type: string + x-examples: + Example 1: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: "2023-02-27T02:40:48+00:00" + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: "2023-04-07T02:55:40.032567054Z" + inSyncMempool: true + lastMempoolTime: "2023-04-07T03:04:36.260327616Z" + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: "2023-04-07T03:00:04.080770962Z" + historicalFiatRatesTime: "2023-04-07T00:00:00Z" + about: "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: "47887764338536.25" + sizeOnDisk: 534828732178 + version: "240001" + subversion: "/Satoshi:24.0.1/" + protocolVersion: "70016" + examples: + Example 1: + value: + blockbook: + coin: Bitcoin + host: s4 + version: 0.4.0 + gitCommit: 83fe6672 + buildTime: "2023-02-27T02:40:48+00:00" + syncMode: true + initialSync: false + inSync: true + bestHeight: 784299 + lastBlockTime: "2023-04-07T02:55:40.032567054Z" + inSyncMempool: true + lastMempoolTime: "2023-04-07T03:04:36.260327616Z" + mempoolSize: 30785 + decimals: 8 + dbSize: 399834379691 + hasFiatRates: true + currentFiatRatesTime: "2023-04-07T03:00:04.080770962Z" + historicalFiatRatesTime: "2023-04-07T00:00:00Z" + about: "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" + backend: + chain: main + blocks: 784299 + headers: 784299 + bestBlockHash: 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 + difficulty: "47887764338536.25" + sizeOnDisk: 534828732178 + version: "240001" + subversion: "/Satoshi:24.0.1/" + protocolVersion: "70016" + + "/block/{blockHashOrHeight}": + parameters: + - $ref: "#/components/parameters/blockHashOrHeight" + get: + summary: Block + responses: + "200": + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + hash: + type: string + previousBlockHash: + type: string + nextBlockHash: + type: string + height: + type: integer + confirmations: + type: integer + size: + type: integer + time: + type: integer + version: + type: integer + merkleRoot: + type: string + nonce: + type: string + bits: + type: string + difficulty: + type: string + txCount: + type: integer + txs: + type: array + items: + type: object + properties: + txid: + type: string + vin: + type: array + items: + type: object + properties: + "n": + type: integer + isAddress: + type: boolean + value: + type: string + vout: + type: array + items: + type: object + properties: + value: + type: string + "n": + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + blockHeight: + type: integer + confirmations: + type: integer + blockTime: + type: integer + value: + type: string + valueIn: + type: string + fees: + type: string + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: "2573394689" + bits: 1d00ffff + difficulty: "1" + txCount: 1 + txs: + - txid: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - "n": 0 + isAddress: false + value: "0" + vout: + - value: "5000000000" + "n": 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: "5000000000" + valueIn: "0" + fees: "0" + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + hash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + previousBlockHash: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f + nextBlockHash: 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd + height: 1 + confirmations: 784303 + size: 215 + time: 1231469665 + version: 1 + merkleRoot: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + nonce: "2573394689" + bits: 1d00ffff + difficulty: "1" + txCount: 1 + txs: + - txid: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 + vin: + - "n": 0 + isAddress: false + value: "0" + vout: + - value: "5000000000" + "n": 0 + addresses: + - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX + isAddress: true + blockHash: 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 + blockHeight: 1 + confirmations: 784303 + blockTime: 1231469665 + value: "5000000000" + valueIn: "0" + fees: "0" + description: OK + operationId: getBlockV2 + description: | + Returns information about a block including its transactions, subject to paging (1000 transactions per page). + + You can query by either block hash or block height. + parameters: + - $ref: "#/components/parameters/page" + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Blocks + "/block-index/{blockHeight}": + parameters: + - $ref: "#/components/parameters/blockHeight" + get: + summary: Block hash + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + blockHash: + type: string + x-examples: + Example 1: + blockHash: ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + examples: + Example 1: + value: + blockHash: ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e + operationId: getBlockHashV2 + description: | + Returns the block hash for a given block height. + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Blocks + "/tx/{txId}": + parameters: + - $ref: "#/components/parameters/txId" + get: + summary: Transaction + operationId: getTxV2 + description: | + Returns normalized transaction data with a consistent structure. + + For confirmed transactions, `blockHeight` contains the block height and `confirmations` the number of confirmations. + For unconfirmed (mempool) transactions, `blockHeight` is `-1`, `confirmations` is `0`, and the response may include + `confirmationETABlocks` and `confirmationETASeconds` with estimated confirmation time. + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + txid: + type: string + description: Transaction hash + version: + type: integer + description: Transaction version + vin: + type: array + description: Transaction inputs + items: + type: object + properties: + txid: + type: string + vout: + type: integer + sequence: + type: integer + "n": + type: integer + addresses: + type: array + items: + type: string + isAddress: + type: boolean + value: + type: string + vout: + type: array + description: Transaction outputs + items: + type: object + properties: + value: + type: string + "n": + type: integer + hex: + type: string + addresses: + type: array + items: + type: string + isAddress: + type: boolean + blockHash: + type: string + description: Hash of the block containing the transaction + blockHeight: + type: integer + description: Block height. -1 for unconfirmed transactions. + confirmations: + type: integer + description: Number of confirmations. 0 for unconfirmed transactions. + blockTime: + type: integer + description: Block timestamp (unix epoch). For unconfirmed transactions, represents when the transaction was first seen. + size: + type: integer + description: Transaction size in bytes + vsize: + type: integer + description: Virtual size for witness transactions + value: + type: string + description: Total output value + valueIn: + type: string + description: Total input value + fees: + type: string + description: Transaction fee + hex: + type: string + description: Raw transaction hex + examples: + Confirmed transaction: + value: + txid: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + version: 1 + vin: + - txid: "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9" + vout: 0 + sequence: 4294967295 + "n": 0 + addresses: + - "12cbQLTFMXRnSzktFkuoG3eHoMeFtpTu3S" + isAddress: true + value: "5000000000" + vout: + - value: "1000000000" + "n": 0 + addresses: + - "1Q2TWHE3GMdB6BZKafqwxXtWAWgFt5Jvm3" + isAddress: true + - value: "4000000000" + "n": 1 + addresses: + - "12cbQLTFMXRnSzktFkuoG3eHoMeFtpTu3S" + isAddress: true + blockHash: "00000000d1145790a8694403d4063f323d499e655c83426834d4ce2f8dd4a2ee" + blockHeight: 170 + confirmations: 946061 + blockTime: 1231731025 + size: 275 + value: "5000000000" + valueIn: "5000000000" + fees: "0" + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Transactions + "/tx-specific/{txId}": + parameters: + - $ref: "#/components/parameters/txId" + get: + summary: Transaction (raw) + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + examples: + Bitcoin: + value: + txid: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + hash: "f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16" + version: 1 + size: 275 + vsize: 275 + weight: 1100 + locktime: 0 + vin: + - txid: "0437cd7f8525ceed2324359c2d0ba26006d92d856a9c20fa0241106ee5a597c9" + vout: 0 + scriptSig: + asm: "304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd41..." + hex: "47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd41..." + sequence: 4294967295 + vout: + - value: 10.0 + "n": 0 + scriptPubKey: + asm: "04ae1a62fe09c5f51b13905f07f06b99a2f7159b2225f374cd378d71302fa284... OP_CHECKSIG" + hex: "4104ae1a62fe09c5f51b13905f07f06b99a2f7159b2225f374cd378d71302fa284..." + type: "pubkey" + - value: 40.0 + "n": 1 + scriptPubKey: + asm: "0411db93e1dcdb8a016b49840f8c53bc1eb68a382e97b1482ecad7b148a6909a... OP_CHECKSIG" + hex: "410411db93e1dcdb8a016b49840f8c53bc1eb68a382e97b1482ecad7b148a6909a..." + type: "pubkey" + hex: "0100000001c997a5e56e104102fa209c6a852dd9..." + blockhash: "00000000d1145790a8694403d4063f323d499e655c83426834d4ce2f8dd4a2ee" + confirmations: 945997 + time: 1231731025 + blocktime: 1231731025 + operationId: getTxSpecificV2 + description: | + Returns transaction data in the exact format as returned by the backend, including all coin-specific fields that are not available in a normalized transaction response. + + Use this endpoint when you need access to raw, backend-specific transaction details such as witness data or other chain-specific properties. + tags: + - Bitcoin + - Litecoin + - Dogecoin + # - Transactions + "/address/{address}": + parameters: + - $ref: "#/components/parameters/address" + get: + summary: Address + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + additionalProperties: true + # properties: {} + examples: + 'Bitcoin-like, details set to "txids"': + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 + balance: "2432468097999991" + totalReceived: "3992283916999979" + totalSent: "1559815818999988" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 3 + txids: + - 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 + - bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 + - 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d + # ? 'Ethereum-like (details set to "tokenBalances", secondary set to "usd")' + # : value: + # address: "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B" + # balance: "21004631949601199" + # unconfirmedBalance: "0" + # unconfirmedTxs: 0 + # txs: 5 + # nonTokenTxs: 3 + # nonce: "1" + # tokens: + # - type: ERC20 + # name: Tether USD + # contract: "0xdAC17F958D2ee523a2206206994597C13D831ec7" + # transfers: 3 + # symbol: USDT + # decimals: 6 + # balance: "4913000000" + operationId: getAddressV2 + description: | + Returns balances and transactions of an address. + + The **details** query parameter controls the level of detail in the response (default: `txids`): + + | Value | Description | + |-------|-------------| + | `basic` | Address balances only (`balance`, `totalReceived`, `totalSent`, `txs` count). No pagination, no transaction data. | + | `txids` | *(default)* Adds pagination (`page`, `totalPages`, `itemsOnPage`) and a `txids` array of transaction hashes. Subject to `from`/`to` block height filter and `page`/`pageSize` paging. | + | `txslight` | Replaces `txids` with a `transactions` array containing lightweight tx objects — vin/vout with addresses and values, block info, fees. No `hex`, `version`, `lockTime`, `size`, or `vsize` fields. Subject to paging. | + | `txs` | Full transaction details — everything in `txslight` plus `version`, `lockTime`, `size`, `vsize`, and raw `hex`. Subject to paging. | + + Use the **secondary** parameter (e.g. `secondary=usd`) to include fiat value of the balance in the response. + parameters: + - $ref: "#/components/parameters/page" + - $ref: "#/components/parameters/pageSize" + - $ref: "#/components/parameters/fromBlock" + - $ref: "#/components/parameters/toBlock" + - $ref: "#/components/parameters/details" + "/xpub/{xpub}": + parameters: + - $ref: "#/components/parameters/xpub" + get: + summary: Xpub + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + page: + type: integer + totalPages: + type: integer + itemsOnPage: + type: integer + address: + type: string + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + unconfirmedBalance: + type: string + unconfirmedTxs: + type: integer + txs: + type: integer + txids: + type: array + items: + type: string + addrTxCount: + type: integer + description: Total number of transactions across all derived addresses. + usedTokens: + type: integer + description: Total number of used addresses of the xpub, regardless of the tokens parameter. + tokens: + type: array + items: + type: object + properties: + type: + type: string + name: + type: string + path: + type: string + transfers: + type: integer + decimals: + type: integer + balance: + type: string + totalReceived: + type: string + totalSent: + type: string + secondaryValue: + type: number + x-examples: + Example 1: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: "90000000" + totalReceived: "3093381250" + totalSent: "3083381250" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 5 + txids: + - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: "90000000" + totalReceived: "2903986975" + totalSent: "2803986975" + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: "0" + totalReceived: "279394275" + totalSent: "279394275" + secondaryValue: 21195.47633568 + examples: + Example 1: + value: + page: 1 + totalPages: 1 + itemsOnPage: 1000 + address: dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF + balance: "90000000" + totalReceived: "3093381250" + totalSent: "3083381250" + unconfirmedBalance: "0" + unconfirmedTxs: 0 + txs: 5 + txids: + - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c + - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 + - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 + - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 + - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f + usedTokens: 2 + tokens: + - type: XPUBAddress + name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS + path: m/44'/3'/0'/0/0 + transfers: 3 + decimals: 8 + balance: "90000000" + totalReceived: "2903986975" + totalSent: "2803986975" + - type: XPUBAddress + name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj + path: m/44'/3'/0'/1/0 + transfers: 2 + decimals: 8 + balance: "0" + totalReceived: "279394275" + totalSent: "279394275" + secondaryValue: 21195.47633568 + operationId: getXpubV2 + description: | + Returns balances and transactions of an extended public key. + + Supported derivation schemes: + + | Scheme | Descriptor format | + |--------|-------------------| + | BIP44 | `pkh(xpub)` | + | BIP49 | `sh(wpkh(xpub))` | + | BIP84 | `wpkh(xpub)` | + | BIP86 (Taproot) | `tr(xpub)` | + + The **details** query parameter controls the level of detail in the response (default: `txids`): + + | Value | Description | + |-------|-------------| + | `basic` | Address balances only (`balance`, `totalReceived`, `totalSent`, `txs` count). No pagination, no transaction data. | + | `txids` | *(default)* Adds pagination (`page`, `totalPages`, `itemsOnPage`) and a `txids` array of transaction hashes. Subject to `from`/`to` block height filter and `page`/`pageSize` paging. | + | `txslight` | Replaces `txids` with a `transactions` array containing lightweight tx objects — vin/vout with addresses and values, block info, fees. No `hex`, `version`, `lockTime`, `size`, or `vsize` fields. Subject to paging. | + | `txs` | Full transaction details — everything in `txslight` plus `version`, `lockTime`, `size`, `vsize`, and raw `hex`. Subject to paging. | + + The **tokens** parameter controls which derived addresses (BIP44 child addresses) are included in the response: + + | Value | Description | + |-------|-------------| + | `nonzero` | *(default)* Only derived addresses with a non-zero balance. Addresses that received funds but spent them all (balance = 0) are excluded. | + | `used` | All derived addresses that have at least one transaction, including those with zero balance. | + | `derived` | All derived addresses in the derivation gap, including those that have never been used. Unused addresses lack `balance`, `totalReceived`, and `totalSent` fields. | + + Use the **secondary** parameter (e.g. `secondary=usd`) to include fiat value of the balance. + parameters: + - $ref: "#/components/parameters/page" + - $ref: "#/components/parameters/pageSize" + - $ref: "#/components/parameters/fromBlock" + - $ref: "#/components/parameters/toBlock" + - $ref: "#/components/parameters/details" + - $ref: "#/components/parameters/tokens" + - $ref: "#/components/parameters/secondary" + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + "/utxo/{addressOrXpub}": + parameters: + - $ref: "#/components/parameters/addressOrXpub" + get: + summary: UTXOs + responses: + "200": + description: OK + content: + application/json: + schema: + type: array + items: + type: object + properties: + txid: + type: string + description: Transaction ID + vout: + type: integer + description: Output index + value: + type: string + description: UTXO amount in the lowest denomination (satoshis) + height: + type: integer + description: Block height. Omitted for unconfirmed UTXOs. + confirmations: + type: integer + description: Number of confirmations. 0 for unconfirmed UTXOs. + lockTime: + type: integer + description: Lock time value. Only present for unconfirmed UTXOs with non-zero lock time. + coinbase: + type: boolean + description: Whether this is a coinbase UTXO. Only detected up to 100 confirmations for performance reasons. + address: + type: string + description: Derived address. Only present when querying by xpub or output descriptor. + path: + type: string + description: Derivation path. Only present when querying by xpub or output descriptor. + examples: + Confirmed and unconfirmed: + value: + - txid: 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 + vout: 0 + value: "1422303206539" + confirmations: 0 + lockTime: 2648100 + - txid: a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac + vout: 1 + value: "39748685" + height: 2648043 + confirmations: 47 + coinbase: true + - txid: de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef + vout: 0 + value: "122492339065" + height: 2646043 + confirmations: 2047 + operationId: getUTXOV2 + description: | + Returns an array of unspent transaction outputs (UTXOs) for an address, xpub, or output descriptor. + + By default, both confirmed and unconfirmed UTXOs are returned. Set `confirmed=true` to exclude unconfirmed UTXOs. + + For xpubs or output descriptors, the response also includes the `address` and derivation `path` of each UTXO. + parameters: + - $ref: "#/components/parameters/confirmed" + tags: + # - Addresses + - Bitcoin + - Litecoin + - Dogecoin + "/sendtx": + post: + summary: Submit transaction + operationId: postSendTxV2 + responses: + "200": + description: OK + content: + application/json: + schema: + type: object + properties: + result: + type: string + description: Transaction ID of the submitted transaction + examples: + Success: + value: + result: 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 + "400": + description: Bad Request + content: + application/json: + schema: + type: object + properties: + error: + type: string + description: Error message from the backend + examples: + Malformed transaction: + value: + error: "-22: TX decode failed. Make sure the tx has at least one input." + Already spent inputs: + value: + error: "-25: bad-txns-inputs-missingorspent" + description: | + Submits a signed, raw transaction to the network for broadcasting. Send the hex-encoded transaction data as plain text in the request body. + + On success, returns the transaction ID. On error, returns an error message from the backend. + requestBody: + content: + text/plain: + schema: + type: object + properties: {} + description: Transaction hex as plain text + tags: + # - Transactions + - Bitcoin + - Litecoin + - Dogecoin +components: + schemas: {} + securitySchemes: + project_id: + type: apiKey + in: header + name: project_id + description: | + There are multiple token types available based on network you choose + when creating a Blockfrost a project, for a list of token types + see available networks. + parameters: + blockHashOrHeight: + name: blockHashOrHeight + in: path + required: true + schema: + type: string + example: 00000000000000000035835503f43c878ebb643f3b40bdfd0dfda760da74e73c + description: Block hash or height + page: + name: page + in: query + required: false + schema: + type: integer + example: 1 + description: "specifies page of returned transactions, starting from 1. If out of range, the closest possible page is returned." + pageSize: + name: pageSize + in: query + required: false + schema: + type: integer + minimum: 1 + maximum: 1000 + default: 1000 + example: 1000 + description: Number of items returned per page (1-1000, default 1000) + blockHeight: + name: blockHeight + in: path + required: true + schema: + type: integer + example: 15 + description: Block height/index + txId: + name: txId + in: path + required: true + schema: + type: string + example: cd8ec77174e426070d0a50779232bba7312b712e2c6843d82d963d7076c61366 + description: Transaction ID + address: + name: address + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Wallet address + details: + name: details + in: query + required: false + schema: + type: string + enum: + - basic + - tokens + - tokenBalances + - txids + - txslight + - txs + default: txids + example: basic + description: | + Level of detail in the response. Possible values: + `basic` — address balances only (balance, totalReceived, totalSent, txs count), no pagination, no transaction data; + `txids` — (default) adds pagination and a txids array of transaction hashes, subject to from/to filter and page/pageSize paging; + `txslight` — replaces txids with lightweight transaction objects (vin/vout with addresses and values, block info, fees), subject to paging; + `txs` — full transaction details including version, lockTime, size, vsize, and raw hex, subject to paging. + fromBlock: + name: fromBlock + in: query + required: false + schema: + type: integer + example: 10 + description: Filter results from this block height (inclusive). Default is no filter. + toBlock: + name: toBlock + in: query + required: false + schema: + type: integer + example: 100 + description: Filter results up to this block height (inclusive). Default is no filter. + secondary: + name: secondary + in: query + required: false + schema: + type: string + example: usd + description: Fiat currency code (e.g. `usd`, `eur`) to include fiat values alongside crypto balances in the response. + xpub: + name: xpub + in: path + required: true + schema: + type: string + example: tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN + description: "Extended public key (xpub, ypub, zpub) or output descriptor. Regular addresses are not accepted — use the /address endpoint instead." + tokens: + name: tokens + in: query + required: false + schema: + type: string + default: nonzero + enum: + - nonzero + - used + - derived + example: used + description: | + Controls which derived addresses (BIP44 child addresses) are included in the xpub response. + `nonzero` — (default) only addresses with non-zero balance; + `used` — all addresses with at least one transaction, including zero balance; + `derived` — all addresses in the derivation gap, including never-used ones. + confirmed: + name: confirmed + in: query + required: false + schema: + type: boolean + example: true + description: Set to `true` to exclude unconfirmed UTXOs from the response. + hex: + name: hex + in: path + required: true + schema: + type: string + example: 01000000017f9a22c9cbf54bd902400df746f138f37bcf5b4d93eb755820e974ba43ed5f42040000006a4730440220037f4ed5427cde81d55b9b6a2fd08c8a25090c2c2fff3a75c1a57625ca8a7118022076c702fe55969fa08137f71afd4851c48e31082dd3c40c919c92cdbc826758d30121029f6da5623c9f9b68a9baf9c1bc7511df88fa34c6c2f71f7c62f2f03ff48dca80feffffff019c9700000000000017a9146144d57c8aff48492c9dfb914e120b20bad72d6f8773d00700 + description: Transaction hex data + addressOrXpub: + name: addressOrXpub + in: path + required: true + schema: + type: string + example: 321x69Cb9HZLWwAWGiUBT1U81r1zPLnEjL + description: Address or XPUB +# tags: +# - name: Status +# description: " " +# - name: Blocks +# description: " " +# - name: Transactions +# description: " " +# - name: Addresses +# description: " " diff --git a/docs/blockbook/index.html b/docs/blockbook/index.html new file mode 100644 index 00000000..e6e0eaac --- /dev/null +++ b/docs/blockbook/index.html @@ -0,0 +1,55 @@ + + + + + + + + + Blockfrost.io - Blockbook API + + + + + + + + + + + + + + + + diff --git a/docs/blockfrost-openapi.yaml b/docs/blockfrost-openapi.yaml index cf0ed827..2632284e 100644 --- a/docs/blockfrost-openapi.yaml +++ b/docs/blockfrost-openapi.yaml @@ -38,45 +38,52 @@ info: - - + + - - + + - - + + - - + + - - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + +
- Network - - Endpoint - NetworkEndpoint
Cardano mainnet - https://cardano-mainnet.blockfrost.io/api/v0 - Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano preprod - https://cardano-preprod.blockfrost.io/api/v0 - Cardano preprodhttps://cardano-preprod.blockfrost.io/api/v0
Cardano preview - https://cardano-preview.blockfrost.io/api/v0 - Cardano previewhttps://cardano-preview.blockfrost.io/api/v0
Midnight mainnet - https://midnight-mainnet.blockfrost.io/api/v0 - Bitcoin mainnet - https://bitcoin-mainnet.blockfrost.io/api/v2 - Midnight mainnethttps://midnight-mainnet.blockfrost.io/api/v0
InterPlanetary File System - https://ipfs.blockfrost.io/api/v0 - Midnight preprodhttps://midnight-preprod.blockfrost.io/api/v0
Midnight previewhttps://midnight-preview.blockfrost.io/api/v0
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
InterPlanetary File Systemhttps://ipfs.blockfrost.io/api/v0
@@ -339,86 +346,62 @@ info: [![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/) -servers: - - url: 'https://cardano-mainnet.blockfrost.io/api/v0' - description: Cardano Mainnet network - - url: 'https://cardano-preprod.blockfrost.io/api/v0' - description: Cardano Preprod network - - url: 'https://cardano-preview.blockfrost.io/api/v0' - description: Cardano Preview network - - url: 'https://localhost:3000' - description: local -security: - - project_id: [] -tags: - - name: Health - - name: Metrics - - name: Bitcoin - description: > - Blockbook Bitcoin integration allows you to access Bitcoin blockchain - using Blockbook API. - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + ## Bitcoin API - > For example, to retrieve a block data for the first block, you would - use: - `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + Access the Bitcoin blockchain through the Blockbook API. - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). - - name: Litecoin - description: > - Blockbook Litecoin integration allows you to access Litecoin blockchain - using Blockbook API. + Endpoint: `https://bitcoin-mainnet.blockfrost.io/api/v2` - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + [![Explore the Bitcoin API + →](https://img.shields.io/badge/Explore_the_Bitcoin_API_→-C77800?style=for-the-badge&logo=bitcoin&logoColor=white)](./blockbook/) - > For example, to retrieve a block data for the first block, you would - use: - `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + ## Litecoin API - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). - - name: Dogecoin - description: > - Blockbook Dogecoin integration allows you to access Dogecoin blockchain - using Blockbook API. + Access the Litecoin blockchain through the Blockbook API. - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + Endpoint: `https://litecoin-mainnet.blockfrost.io/api/v2` - > For example, to retrieve a block data for the first block, you would - use: + [![Explore the Litecoin API + →](https://img.shields.io/badge/Explore_the_Litecoin_API_→-345D9D?style=for-the-badge&logo=litecoin&logoColor=white)](./blockbook/) - `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). + ## Dogecoin API + + + Access the Dogecoin blockchain through the Blockbook API. + + + Endpoint: `https://dogecoin-mainnet.blockfrost.io/api/v2` + + + [![Explore the Dogecoin API + →](https://img.shields.io/badge/Explore_the_Dogecoin_API_→-9B7E1A?style=for-the-badge&logo=dogecoin&logoColor=white)](./blockbook/) +servers: + - url: 'https://cardano-mainnet.blockfrost.io/api/v0' + description: Cardano Mainnet network + - url: 'https://cardano-preprod.blockfrost.io/api/v0' + description: Cardano Preprod network + - url: 'https://cardano-preview.blockfrost.io/api/v0' + description: Cardano Preview network + - url: 'https://localhost:3000' + description: local +security: + - project_id: [] +tags: + - name: Health + - name: Metrics - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets @@ -6978,850 +6961,6 @@ paths: $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' - /api/v2/status: - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - get: - tags: - - Bitcoin - - Litecoin - - Dogecoin - summary: Blockchain status - operationId: getStatus - description: Get current status of Blockbook and its backend - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - blockbook: - type: object - properties: - coin: - type: string - network: - type: string - host: - type: string - version: - type: string - gitCommit: - type: string - buildTime: - type: string - syncMode: - type: boolean - initialSync: - type: boolean - inSync: - type: boolean - bestHeight: - type: integer - lastBlockTime: - type: string - inSyncMempool: - type: boolean - lastMempoolTime: - type: string - mempoolSize: - type: integer - decimals: - type: integer - dbSize: - type: integer - hasFiatRates: - type: boolean - currentFiatRatesTime: - type: string - historicalFiatRatesTime: - type: string - about: - type: string - backend: - type: object - properties: - chain: - type: string - blocks: - type: integer - headers: - type: integer - bestBlockHash: - type: string - difficulty: - type: string - sizeOnDisk: - type: integer - version: - type: string - subversion: - type: string - protocolVersion: - type: string - x-examples: - Example 1: - blockbook: - coin: Bitcoin - host: s4 - version: 0.4.0 - gitCommit: 83fe6672 - buildTime: '2023-02-27T02:40:48+00:00' - syncMode: true - initialSync: false - inSync: true - bestHeight: 784299 - lastBlockTime: '2023-04-07T02:55:40.032567054Z' - inSyncMempool: true - lastMempoolTime: '2023-04-07T03:04:36.260327616Z' - mempoolSize: 30785 - decimals: 8 - dbSize: 399834379691 - hasFiatRates: true - currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' - historicalFiatRatesTime: '2023-04-07T00:00:00Z' - about: >- - Blockbook blockchain indexer for https://chain49.com/ - - based on trezor/blockbook - backend: - chain: main - blocks: 784299 - headers: 784299 - bestBlockHash: >- - 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 - difficulty: '47887764338536.25' - sizeOnDisk: 534828732178 - version: '240001' - subversion: '/Satoshi:24.0.1/' - protocolVersion: '70016' - examples: - Example 1: - value: - blockbook: - coin: Bitcoin - host: s4 - version: 0.4.0 - gitCommit: 83fe6672 - buildTime: '2023-02-27T02:40:48+00:00' - syncMode: true - initialSync: false - inSync: true - bestHeight: 784299 - lastBlockTime: '2023-04-07T02:55:40.032567054Z' - inSyncMempool: true - lastMempoolTime: '2023-04-07T03:04:36.260327616Z' - mempoolSize: 30785 - decimals: 8 - dbSize: 399834379691 - hasFiatRates: true - currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' - historicalFiatRatesTime: '2023-04-07T00:00:00Z' - about: >- - Blockbook blockchain indexer for https://chain49.com/ - - based on trezor/blockbook - backend: - chain: main - blocks: 784299 - headers: 784299 - bestBlockHash: >- - 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 - difficulty: '47887764338536.25' - sizeOnDisk: 534828732178 - version: '240001' - subversion: '/Satoshi:24.0.1/' - protocolVersion: '70016' - '/api/v2/block/{blockHashOrHeight}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/blockHashOrHeight' - get: - summary: Block - responses: - '200': - content: - application/json: - schema: - type: object - properties: - page: - type: integer - totalPages: - type: integer - itemsOnPage: - type: integer - hash: - type: string - previousBlockHash: - type: string - nextBlockHash: - type: string - height: - type: integer - confirmations: - type: integer - size: - type: integer - time: - type: integer - version: - type: integer - merkleRoot: - type: string - nonce: - type: string - bits: - type: string - difficulty: - type: string - txCount: - type: integer - txs: - type: array - items: - type: object - properties: - txid: - type: string - vin: - type: array - items: - type: object - properties: - 'n': - type: integer - isAddress: - type: boolean - value: - type: string - vout: - type: array - items: - type: object - properties: - value: - type: string - 'n': - type: integer - addresses: - type: array - items: - type: string - isAddress: - type: boolean - blockHash: - type: string - blockHeight: - type: integer - confirmations: - type: integer - blockTime: - type: integer - value: - type: string - valueIn: - type: string - fees: - type: string - x-examples: - Example 1: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - hash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - previousBlockHash: >- - 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f - nextBlockHash: >- - 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd - height: 1 - confirmations: 784303 - size: 215 - time: 1231469665 - version: 1 - merkleRoot: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - nonce: '2573394689' - bits: 1d00ffff - difficulty: '1' - txCount: 1 - txs: - - txid: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - vin: - - 'n': 0 - isAddress: false - value: '0' - vout: - - value: '5000000000' - 'n': 0 - addresses: - - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX - isAddress: true - blockHash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - blockHeight: 1 - confirmations: 784303 - blockTime: 1231469665 - value: '5000000000' - valueIn: '0' - fees: '0' - examples: - Example 1: - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - hash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - previousBlockHash: >- - 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f - nextBlockHash: >- - 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd - height: 1 - confirmations: 784303 - size: 215 - time: 1231469665 - version: 1 - merkleRoot: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - nonce: '2573394689' - bits: 1d00ffff - difficulty: '1' - txCount: 1 - txs: - - txid: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - vin: - - 'n': 0 - isAddress: false - value: '0' - vout: - - value: '5000000000' - 'n': 0 - addresses: - - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX - isAddress: true - blockHash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - blockHeight: 1 - confirmations: 784303 - blockTime: 1231469665 - value: '5000000000' - valueIn: '0' - fees: '0' - description: OK - operationId: getBlockV2 - description: >- - Returns information about block with transactions, subject to paging. - - - Note: Blockbook always follows the main chain of the backend it is - attached to. If there is a rollback-reorg in the backend, Blockbook will - also do rollback. When you ask for block by height, you will always get - the main chain block. If you ask for block by hash, you may get the - block from another fork but it is not guaranteed (backend may not keep - it) - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/block-index/{blockHeight}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/blockHeight' - get: - summary: Block hash - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - blockHash: - type: string - x-examples: - Example 1: - blockHash: >- - ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e - examples: - Example 1: - value: - blockHash: >- - ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e - operationId: getBlockHashV2 - description: >- - Get block hash by its height - - - Note: Blockbook always follows the main chain of the backend it is - attached to. - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/tx-specific/{txId}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/txId' - get: - summary: Transaction - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - additionalProperties: true - examples: - zCash: - value: - hex: 040000808...8e6e73cb009 - txid: >- - 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 - overwintered: true - version: 4 - versiongroupid: 892f2085 - locktime: 0 - expiryheight: 495680 - vin: [] - vout: [] - vjoinsplit: [] - valueBalance: 0 - vShieldedSpend: - - cv: >- - 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 - anchor: >- - 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: >- - 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a - rk: >- - 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 - proof: aecf824dbae8eea863ec6...73878c37391f01df520aa - spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 - - cv: >- - a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c - anchor: >- - 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: >- - 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 - rk: >- - 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 - proof: >- - a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 - spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 - vShieldedOutput: - - cv: >- - 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab - cmu: >- - 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc - ephemeralKey: >- - 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 - encCiphertext: a533d3b99b...a0204 - outCiphertext: 4baabc15199504b1...c1ad6a - proof: >- - aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 - bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 - blockhash: >- - 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af - confirmations: 5222 - time: 1552301566 - blocktime: 1552301566 - operationId: getTxSpecificV2 - description: >- - Returns transaction data in the exact format as returned by backend, - including all coin specific fields - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/address/{address}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/address' - get: - summary: Address - tags: - - Bitcoin - - Litecoin - - Dogecoin - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - additionalProperties: true - examples: - 'Bitcoin-like, details set to "txids"': - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 - balance: '2432468097999991' - totalReceived: '3992283916999979' - totalSent: '1559815818999988' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 3 - txids: - - >- - 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 - - >- - bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 - - >- - 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d - operationId: getAddressV2 - description: > - Returns balances and transactions of an address. The returned - transactions are sorted by block height, newest blocks first. - - - The **details** query parameter can specify the level of details - returned by the request (default: "txids"). - - Possible values are: - - - **basic**: return only xpub balances, without any derived addresses and - transactions - - - **tokens**: basic + tokens (addresses) derived from the xpub, subject to - tokens parameter - - - **tokenBalances**: basic + tokens (addresses) derived from the xpub with - balances, subject to tokens parameter - - - **txids**: tokenBalances + list of txids, subject to from, to filter and - paging - - - **txs**: tokenBalances + list of transaction with details, subject to - from, to filter and paging - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/fromBlock' - - $ref: '#/components/parameters/toBlock' - - $ref: '#/components/parameters/details' - '/api/v2/xpub/{xpub}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/xpub' - get: - summary: Xpub - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - page: - type: integer - totalPages: - type: integer - itemsOnPage: - type: integer - address: - type: string - balance: - type: string - totalReceived: - type: string - totalSent: - type: string - unconfirmedBalance: - type: string - unconfirmedTxs: - type: integer - txs: - type: integer - txids: - type: array - items: - type: string - usedTokens: - type: integer - tokens: - type: array - items: - type: object - properties: - type: - type: string - name: - type: string - path: - type: string - transfers: - type: integer - decimals: - type: integer - balance: - type: string - totalReceived: - type: string - totalSent: - type: string - secondaryValue: - type: number - x-examples: - Example 1: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: >- - dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF - balance: '90000000' - totalReceived: '3093381250' - totalSent: '3083381250' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 5 - txids: - - >- - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c - - >- - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 - - >- - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 - - >- - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 - - >- - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f - usedTokens: 2 - tokens: - - type: XPUBAddress - name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS - path: m/44'/3'/0'/0/0 - transfers: 3 - decimals: 8 - balance: '90000000' - totalReceived: '2903986975' - totalSent: '2803986975' - - type: XPUBAddress - name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj - path: m/44'/3'/0'/1/0 - transfers: 2 - decimals: 8 - balance: '0' - totalReceived: '279394275' - totalSent: '279394275' - secondaryValue: 21195.47633568 - examples: - Example 1: - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: >- - dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF - balance: '90000000' - totalReceived: '3093381250' - totalSent: '3083381250' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 5 - txids: - - >- - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c - - >- - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 - - >- - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 - - >- - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 - - >- - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f - usedTokens: 2 - tokens: - - type: XPUBAddress - name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS - path: m/44'/3'/0'/0/0 - transfers: 3 - decimals: 8 - balance: '90000000' - totalReceived: '2903986975' - totalSent: '2803986975' - - type: XPUBAddress - name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj - path: m/44'/3'/0'/1/0 - transfers: 2 - decimals: 8 - balance: '0' - totalReceived: '279394275' - totalSent: '279394275' - secondaryValue: 21195.47633568 - operationId: getXpubV2 - description: >- - Returns balances and transactions of an xpub or output descriptor, - applicable only for Bitcoin-type coins. - - - Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation - schemes, using either xpubs or output descriptors (see - https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) - - - Note: usedTokens always returns total number of used addresses of xpub. - - - Detailed documentation found here: - https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/fromBlock' - - $ref: '#/components/parameters/toBlock' - - $ref: '#/components/parameters/details' - - $ref: '#/components/parameters/tokens' - - $ref: '#/components/parameters/secondary' - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/utxo/{addressOrXpub}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/addressOrXpub' - get: - summary: UTXOs - responses: - '200': - description: OK - content: - application/json: - schema: - type: array - items: {} - examples: - Example 1: - value: - - txid: >- - 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 - vout: 0 - value: '1422303206539' - confirmations: 0 - lockTime: 2648100 - - txid: >- - a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac - vout: 1 - value: '39748685' - height: 2648043 - confirmations: 47 - coinbase: true - - txid: >- - de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef - vout: 0 - value: '122492339065' - height: 2646043 - confirmations: 2047 - - txid: >- - 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 - vout: 0 - value: '142771322208' - height: 2644885 - confirmations: 3205 - operationId: getUTXOV2 - description: >- - Returns array of unspent transaction outputs of address or xpub, - applicable only for Bitcoin-type coins. By default, the list contains - both confirmed and unconfirmed transactions. The query parameter - confirmed=true disables return of unconfirmed transactions. The returned - utxos are sorted by block height, newest blocks first. For xpubs or - output descriptors, the response also contains address and derivation - path of the utxo. - - - - - Unconfirmed utxos do not have field height, the field confirmations has - value 0 and may contain field lockTime, if not zero. - - - Coinbase utxos have field coinbase set to true, however due to - performance reasons only up to minimum coinbase confirmations limit - (100). After this limit, utxos are not detected as coinbase. - parameters: - - $ref: '#/components/parameters/confirmed' - tags: - - Bitcoin - - Litecoin - - Dogecoin - /api/v2/sendtx: - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - post: - summary: Submit transaction - operationId: postSendTxV2 - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - result: - type: string - x-examples: - Example 1: - result: >- - 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 - examples: - Example 1: - value: - result: >- - 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 - description: | - Sends new transaction to backend for broadcasting - requestBody: - content: - text/plain: - schema: - type: object - properties: {} - description: Transaction hex as plain text - tags: - - Bitcoin - - Litecoin - - Dogecoin components: schemas: onchain_metadata_cip25: @@ -14629,15 +13768,18 @@ components: example: 1 description: >- specifies page of returned transactions, starting from 1. If out of - range, Blockbook returns the closest possible page. + range, the closest possible page is returned. pageSize: name: pageSize in: query required: false schema: type: integer + minimum: 1 + maximum: 1000 + default: 1000 example: 1000 - description: number of transactions returned by call (default and maximum 1000) + description: 'Number of items returned per page (1-1000, default 1000)' blockHeight: name: blockHeight in: path @@ -14677,7 +13819,21 @@ components: - txs default: txids example: basic - description: specifies level of details returned by request + description: > + Level of detail in the response. Possible values: + + `basic` — address balances only (balance, totalReceived, totalSent, txs + count), no pagination, no transaction data; + + `txids` — (default) adds pagination and a txids array of transaction + hashes, subject to from/to filter and page/pageSize paging; + + `txslight` — replaces txids with lightweight transaction objects + (vin/vout with addresses and values, block info, fees), subject to + paging; + + `txs` — full transaction details including version, lockTime, size, + vsize, and raw hex, subject to paging. fromBlock: name: fromBlock in: query @@ -14685,9 +13841,7 @@ components: schema: type: integer example: 10 - description: >- - filter of the returned transactions from block height to block height - (default no filter) + description: Filter results from this block height (inclusive). Default is no filter. toBlock: name: toBlock in: query @@ -14696,8 +13850,8 @@ components: type: integer example: 100 description: >- - filter of the returned transactions from block height to block height - (default no filter) + Filter results up to this block height (inclusive). Default is no + filter. secondary: name: secondary in: query @@ -14706,8 +13860,8 @@ components: type: string example: usd description: >- - specifies secondary (fiat) currency in which the token and total - balances are returned in addition to crypto values + Fiat currency code (e.g. `usd`, `eur`) to include fiat values alongside + crypto balances in the response. xpub: name: xpub in: path @@ -14716,7 +13870,9 @@ components: type: string example: >- tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN - description: 'xpub or output descriptor, applicable only for Bitcoin-type coins' + description: >- + Extended public key (xpub, ypub, zpub) or output descriptor. Regular + addresses are not accepted — use the /address endpoint instead. tokens: name: tokens in: query @@ -14729,9 +13885,17 @@ components: - used - derived example: used - description: >- - specifies what tokens (xpub addresses) are returned by the request - (default nonzero) + description: > + Controls which derived addresses (BIP44 child addresses) are included in + the xpub response. + + `nonzero` — (default) only addresses with non-zero balance; + + `used` — all addresses with at least one transaction, including zero + balance; + + `derived` — all addresses in the derivation gap, including never-used + ones. confirmed: name: confirmed in: query @@ -14739,7 +13903,7 @@ components: schema: type: boolean example: true - description: confirmed=true disables return of unconfirmed transactions + description: Set to `true` to exclude unconfirmed UTXOs from the response. hex: name: hex in: path diff --git a/docs/midnight/index.html b/docs/midnight/index.html index 28091f0f..4acd04f8 100644 --- a/docs/midnight/index.html +++ b/docs/midnight/index.html @@ -788,9 +788,9 @@
Response
"data": { "block": { "hash": HexEncoded, - "height": 123, - "protocolVersion": 123, - "timestamp": 123, + "height": 987, + "protocolVersion": 987, + "timestamp": 987, "author": HexEncoded, "ledgerParameters": HexEncoded, "parent": Block, @@ -866,7 +866,7 @@
Query
Variables
-
{"epoch": 987}
+                  
{"epoch": 123}
 
@@ -877,11 +877,11 @@
Response
{ "epochNo": 123, "position": 987, - "sidechainPubkeyHex": "abc123", + "sidechainPubkeyHex": "xyz789", "expectedSlots": 123, "auraPubkeyHex": "abc123", - "poolIdHex": "abc123", - "spoSkHex": "xyz789" + "poolIdHex": "xyz789", + "spoSkHex": "abc123" } ] } @@ -1166,9 +1166,9 @@
Response
{ "blockHeight": 987, "blockHash": HexEncoded, - "timestamp": 987, - "numPermissionedCandidates": 987, - "numRegisteredCandidates": 123 + "timestamp": 123, + "numPermissionedCandidates": 123, + "numRegisteredCandidates": 987 } ] } @@ -1253,11 +1253,11 @@
Response
{ "cardanoRewardAddress": CardanoRewardAddress, "dustAddress": DustAddress, - "registered": true, - "nightBalance": "abc123", + "registered": false, + "nightBalance": "xyz789", "generationRate": "abc123", "maxCapacity": "abc123", - "currentCapacity": "xyz789", + "currentCapacity": "abc123", "utxoTxHash": HexEncoded, "utxoOutputIndex": 987 } @@ -1354,7 +1354,7 @@
Query
Variables
-
{"epoch": 987, "limit": 987, "offset": 123}
+                  
{"epoch": 123, "limit": 987, "offset": 987}
 
@@ -1365,12 +1365,12 @@
Response
{ "epochNo": 987, "spoSkHex": "xyz789", - "produced": 123, + "produced": 987, "expected": 987, - "identityLabel": "abc123", - "stakeSnapshot": "abc123", + "identityLabel": "xyz789", + "stakeSnapshot": "xyz789", "poolIdHex": "xyz789", - "validatorClass": "abc123" + "validatorClass": "xyz789" } ] } @@ -1439,7 +1439,7 @@
Variables
Response
-
{"data": {"epochUtilization": 123.45}}
+                  
{"data": {"epochUtilization": 987.65}}
 
@@ -1506,7 +1506,7 @@
Query
Variables
-
{"poolIdHex": "abc123"}
+                  
{"poolIdHex": "xyz789"}
 
@@ -1515,10 +1515,10 @@
Response
"data": { "poolMetadata": { "poolIdHex": "abc123", - "hexId": "abc123", - "name": "abc123", + "hexId": "xyz789", + "name": "xyz789", "ticker": "xyz789", - "homepageUrl": "abc123", + "homepageUrl": "xyz789", "logoUrl": "abc123" } } @@ -1611,7 +1611,7 @@
Query
Variables
-
{"limit": 987, "offset": 123, "withNameOnly": false}
+                  
{"limit": 987, "offset": 987, "withNameOnly": true}
 
@@ -1621,11 +1621,11 @@
Response
"poolMetadataList": [ { "poolIdHex": "abc123", - "hexId": "abc123", + "hexId": "xyz789", "name": "abc123", - "ticker": "xyz789", + "ticker": "abc123", "homepageUrl": "abc123", - "logoUrl": "abc123" + "logoUrl": "xyz789" } ] } @@ -1692,7 +1692,7 @@
Query
Variables
-
{"uptoEpoch": 123}
+                  
{"uptoEpoch": 987}
 
@@ -1701,8 +1701,8 @@
Response
"data": { "registeredFirstValidEpochs": [ { - "idKey": "abc123", - "firstValidEpoch": 123 + "idKey": "xyz789", + "firstValidEpoch": 987 } ] } @@ -1784,7 +1784,7 @@
Query
Variables
-
{"fromEpoch": 123, "toEpoch": 123}
+                  
{"fromEpoch": 987, "toEpoch": 987}
 
@@ -1794,8 +1794,8 @@
Response
"registeredPresence": [ { "epochNo": 123, - "idKey": "abc123", - "source": "xyz789", + "idKey": "xyz789", + "source": "abc123", "status": "xyz789" } ] @@ -1880,7 +1880,7 @@
Query
Variables
-
{"fromEpoch": 987, "toEpoch": 123}
+                  
{"fromEpoch": 987, "toEpoch": 987}
 
@@ -1890,11 +1890,11 @@
Response
"registeredSpoSeries": [ { "epochNo": 123, - "federatedValidCount": 987, + "federatedValidCount": 123, "federatedInvalidCount": 123, - "registeredValidCount": 987, - "registeredInvalidCount": 123, - "dparam": 123.45 + "registeredValidCount": 123, + "registeredInvalidCount": 987, + "dparam": 987.65 } ] } @@ -1975,7 +1975,7 @@
Query
Variables
-
{"fromEpoch": 987, "toEpoch": 987}
+                  
{"fromEpoch": 987, "toEpoch": 123}
 
@@ -1983,7 +1983,7 @@
Response
{
   "data": {
     "registeredTotalsSeries": [
-      {"epochNo": 987, "totalRegistered": 123, "newlyRegistered": 987}
+      {"epochNo": 123, "totalRegistered": 123, "newlyRegistered": 123}
     ]
   }
 }
@@ -2055,7 +2055,7 @@ 
Query
Variables
-
{"poolIdHex": "abc123"}
+                  
{"poolIdHex": "xyz789"}
 
@@ -2063,14 +2063,14 @@
Response
{
   "data": {
     "spoByPoolId": {
-      "poolIdHex": "abc123",
-      "validatorClass": "abc123",
+      "poolIdHex": "xyz789",
+      "validatorClass": "xyz789",
       "sidechainPubkeyHex": "abc123",
       "auraPubkeyHex": "xyz789",
       "name": "abc123",
-      "ticker": "xyz789",
-      "homepageUrl": "abc123",
-      "logoUrl": "abc123"
+      "ticker": "abc123",
+      "homepageUrl": "xyz789",
+      "logoUrl": "xyz789"
     }
   }
 }
@@ -2212,7 +2212,7 @@ 
Query
Response
-
{"data": {"spoCount": 123}}
+                  
{"data": {"spoCount": 987}}
 
@@ -2291,7 +2291,7 @@
Query
Variables
-
{"limit": 123, "offset": 123}
+                  
{"limit": 987, "offset": 123}
 
@@ -2300,7 +2300,7 @@
Response
"data": { "spoIdentities": [ { - "poolIdHex": "abc123", + "poolIdHex": "xyz789", "mainchainPubkeyHex": "abc123", "sidechainPubkeyHex": "xyz789", "auraPubkeyHex": "xyz789", @@ -2382,10 +2382,10 @@
Response
{
   "data": {
     "spoIdentityByPoolId": {
-      "poolIdHex": "xyz789",
+      "poolIdHex": "abc123",
       "mainchainPubkeyHex": "xyz789",
-      "sidechainPubkeyHex": "abc123",
-      "auraPubkeyHex": "abc123",
+      "sidechainPubkeyHex": "xyz789",
+      "auraPubkeyHex": "xyz789",
       "validatorClass": "abc123"
     }
   }
@@ -2483,7 +2483,7 @@ 
Variables
{
   "limit": 987,
   "offset": 987,
-  "search": "xyz789"
+  "search": "abc123"
 }
 
@@ -2494,10 +2494,10 @@
Response
"spoList": [ { "poolIdHex": "xyz789", - "validatorClass": "abc123", + "validatorClass": "xyz789", "sidechainPubkeyHex": "xyz789", "auraPubkeyHex": "abc123", - "name": "abc123", + "name": "xyz789", "ticker": "abc123", "homepageUrl": "xyz789", "logoUrl": "abc123" @@ -2596,9 +2596,9 @@
Query
Variables
{
-  "spoSkHex": "abc123",
-  "limit": 987,
-  "offset": 123
+  "spoSkHex": "xyz789",
+  "limit": 123,
+  "offset": 987
 }
 
@@ -2609,9 +2609,9 @@
Response
"spoPerformanceBySpoSk": [ { "epochNo": 987, - "spoSkHex": "abc123", - "produced": 123, - "expected": 987, + "spoSkHex": "xyz789", + "produced": 987, + "expected": 123, "identityLabel": "xyz789", "stakeSnapshot": "abc123", "poolIdHex": "xyz789", @@ -2711,13 +2711,13 @@
Response
"spoPerformanceLatest": [ { "epochNo": 987, - "spoSkHex": "abc123", - "produced": 987, - "expected": 987, + "spoSkHex": "xyz789", + "produced": 123, + "expected": 123, "identityLabel": "abc123", - "stakeSnapshot": "xyz789", + "stakeSnapshot": "abc123", "poolIdHex": "xyz789", - "validatorClass": "xyz789" + "validatorClass": "abc123" } ] } @@ -2829,7 +2829,7 @@
Variables
"limit": 123, "offset": 987, "search": "xyz789", - "orderByStakeDesc": true + "orderByStakeDesc": false }
@@ -2841,16 +2841,16 @@
Response
{ "poolIdHex": "xyz789", "name": "xyz789", - "ticker": "xyz789", + "ticker": "abc123", "homepageUrl": "xyz789", - "logoUrl": "abc123", + "logoUrl": "xyz789", "liveStake": "abc123", "activeStake": "abc123", "liveDelegators": 987, - "liveSaturation": 987.65, - "declaredPledge": "abc123", - "livePledge": "abc123", - "stakeShare": 123.45 + "liveSaturation": 123.45, + "declaredPledge": "xyz789", + "livePledge": "xyz789", + "stakeShare": 987.65 } ] } @@ -2914,7 +2914,7 @@
Query
Variables
-
{"limit": 123}
+                  
{"limit": 987}
 
@@ -2973,7 +2973,7 @@
Response
"blockHash": HexEncoded, "timestamp": 987, "hash": HexEncoded, - "url": "abc123" + "url": "xyz789" } ] } @@ -3269,7 +3269,7 @@
Response
"data": { "transactions": [ { - "id": 987, + "id": 123, "hash": HexEncoded, "protocolVersion": 123, "raw": HexEncoded, @@ -3631,7 +3631,7 @@
Response
"hash": HexEncoded, "height": 123, "protocolVersion": 123, - "timestamp": 123, + "timestamp": 987, "author": HexEncoded, "ledgerParameters": HexEncoded, "parent": Block, @@ -4016,7 +4016,7 @@
Query
Variables
-
{"sessionId": HexEncoded, "index": 987}
+                  
{"sessionId": HexEncoded, "index": 123}
 
@@ -4156,7 +4156,7 @@
Query
Variables
-
{"address": UnshieldedAddress, "transactionId": 123}
+                  
{"address": UnshieldedAddress, "transactionId": 987}
 
@@ -4240,7 +4240,7 @@
Response
"zswapLedgerEvents": { "id": 123, "raw": HexEncoded, - "maxId": 123, + "maxId": 987, "protocolVersion": 987 } } @@ -4324,7 +4324,7 @@
Example
{
   "hash": HexEncoded,
   "height": 123,
-  "protocolVersion": 987,
+  "protocolVersion": 123,
   "timestamp": 123,
   "author": HexEncoded,
   "ledgerParameters": HexEncoded,
@@ -4377,7 +4377,7 @@ 
Fields
Example
-
{"hash": HexEncoded, "height": 987}
+                  
{"hash": HexEncoded, "height": 123}
 
@@ -4461,7 +4461,7 @@
Fields
Example
{
-  "startIndex": 987,
+  "startIndex": 123,
   "endIndex": 123,
   "update": HexEncoded,
   "protocolVersion": 123
@@ -4542,13 +4542,13 @@ 
Fields
Example
{
-  "epochNo": 987,
+  "epochNo": 123,
   "position": 987,
-  "sidechainPubkeyHex": "abc123",
+  "sidechainPubkeyHex": "xyz789",
   "expectedSlots": 123,
-  "auraPubkeyHex": "xyz789",
-  "poolIdHex": "abc123",
-  "spoSkHex": "xyz789"
+  "auraPubkeyHex": "abc123",
+  "poolIdHex": "xyz789",
+  "spoSkHex": "abc123"
 }
 
@@ -4741,7 +4741,7 @@
Fields
Example
{
   "tokenType": HexEncoded,
-  "amount": "abc123"
+  "amount": "xyz789"
 }
 
@@ -4993,7 +4993,7 @@
Fields
Example
-
{"numPermissionedCandidates": 987, "numRegisteredCandidates": 123}
+                  
{"numPermissionedCandidates": 123, "numRegisteredCandidates": 987}
 
@@ -5055,9 +5055,9 @@
Example
{
   "blockHeight": 987,
   "blockHash": HexEncoded,
-  "timestamp": 987,
-  "numPermissionedCandidates": 987,
-  "numRegisteredCandidates": 123
+  "timestamp": 123,
+  "numPermissionedCandidates": 123,
+  "numRegisteredCandidates": 987
 }
 
@@ -5212,13 +5212,13 @@
Example
{
   "cardanoRewardAddress": CardanoRewardAddress,
   "dustAddress": DustAddress,
-  "registered": true,
+  "registered": false,
   "nightBalance": "xyz789",
-  "generationRate": "xyz789",
-  "maxCapacity": "abc123",
-  "currentCapacity": "abc123",
+  "generationRate": "abc123",
+  "maxCapacity": "xyz789",
+  "currentCapacity": "xyz789",
   "utxoTxHash": HexEncoded,
-  "utxoOutputIndex": 987
+  "utxoOutputIndex": 123
 }
 
@@ -5277,7 +5277,7 @@
Example
{
   "id": 123,
   "raw": HexEncoded,
-  "maxId": 123,
+  "maxId": 987,
   "protocolVersion": 123,
   "output": DustOutput
 }
@@ -5371,10 +5371,10 @@ 
Possible Types
Example
{
-  "id": 987,
+  "id": 123,
   "raw": HexEncoded,
-  "maxId": 123,
-  "protocolVersion": 987
+  "maxId": 987,
+  "protocolVersion": 123
 }
 
@@ -5465,10 +5465,10 @@
Fields
Example
{
-  "id": 987,
+  "id": 123,
   "raw": HexEncoded,
   "maxId": 987,
-  "protocolVersion": 987
+  "protocolVersion": 123
 }
 
@@ -5605,13 +5605,13 @@
Fields
Example
{
   "epochNo": 123,
-  "spoSkHex": "xyz789",
+  "spoSkHex": "abc123",
   "produced": 987,
-  "expected": 123,
+  "expected": 987,
   "identityLabel": "xyz789",
   "stakeSnapshot": "abc123",
   "poolIdHex": "abc123",
-  "validatorClass": "xyz789"
+  "validatorClass": "abc123"
 }
 
@@ -5658,7 +5658,7 @@
Fields
Example
-
{"idKey": "xyz789", "firstValidEpoch": 123}
+                  
{"idKey": "xyz789", "firstValidEpoch": 987}
 
@@ -5717,7 +5717,7 @@
Description
Example
-
123
+                  
987
 
@@ -5770,7 +5770,7 @@
Example
{
   "id": 987,
   "raw": HexEncoded,
-  "maxId": 987,
+  "maxId": 123,
   "protocolVersion": 123
 }
 
@@ -5844,9 +5844,9 @@
Fields
Example
{
   "poolIdHex": "abc123",
-  "hexId": "abc123",
+  "hexId": "xyz789",
   "name": "abc123",
-  "ticker": "xyz789",
+  "ticker": "abc123",
   "homepageUrl": "xyz789",
   "logoUrl": "xyz789"
 }
@@ -5908,10 +5908,10 @@ 
Fields
Example
{
-  "epochNo": 123,
-  "idKey": "abc123",
+  "epochNo": 987,
+  "idKey": "xyz789",
   "source": "xyz789",
-  "status": "abc123"
+  "status": "xyz789"
 }
 
@@ -5985,10 +5985,10 @@
Example
{
   "epochNo": 123,
   "federatedValidCount": 987,
-  "federatedInvalidCount": 123,
+  "federatedInvalidCount": 987,
   "registeredValidCount": 123,
-  "registeredInvalidCount": 987,
-  "dparam": 123.45
+  "registeredInvalidCount": 123,
+  "dparam": 987.65
 }
 
@@ -6041,7 +6041,7 @@
Fields
Example
-
{"epochNo": 123, "totalRegistered": 123, "newlyRegistered": 987}
+                  
{"epochNo": 987, "totalRegistered": 987, "newlyRegistered": 123}
 
@@ -6156,15 +6156,15 @@
Fields
Example
{
-  "id": 987,
+  "id": 123,
   "hash": HexEncoded,
   "protocolVersion": 123,
   "raw": HexEncoded,
   "transactionResult": TransactionResult,
   "identifiers": [HexEncoded],
   "merkleTreeRoot": HexEncoded,
-  "startIndex": 123,
-  "endIndex": 987,
+  "startIndex": 987,
+  "endIndex": 123,
   "fees": TransactionFees,
   "block": Block,
   "contractActions": [ContractAction],
@@ -6263,7 +6263,7 @@ 
Fields
Example
-
{"id": 123, "success": true}
+                  
{"id": 123, "success": false}
 
@@ -6358,7 +6358,7 @@
Example
{
   "highestEndIndex": 123,
   "highestCheckedEndIndex": 123,
-  "highestRelevantEndIndex": 987
+  "highestRelevantEndIndex": 123
 }
 
@@ -6442,14 +6442,14 @@
Fields
Example
{
-  "poolIdHex": "abc123",
-  "validatorClass": "xyz789",
+  "poolIdHex": "xyz789",
+  "validatorClass": "abc123",
   "sidechainPubkeyHex": "xyz789",
   "auraPubkeyHex": "xyz789",
   "name": "xyz789",
-  "ticker": "xyz789",
+  "ticker": "abc123",
   "homepageUrl": "abc123",
-  "logoUrl": "xyz789"
+  "logoUrl": "abc123"
 }
 
@@ -6572,10 +6572,10 @@
Fields
Example
{
   "poolIdHex": "xyz789",
-  "mainchainPubkeyHex": "xyz789",
+  "mainchainPubkeyHex": "abc123",
   "sidechainPubkeyHex": "abc123",
-  "auraPubkeyHex": "abc123",
-  "validatorClass": "xyz789"
+  "auraPubkeyHex": "xyz789",
+  "validatorClass": "abc123"
 }
 
@@ -6674,11 +6674,11 @@
Example
{
   "poolIdHex": "xyz789",
   "name": "xyz789",
-  "ticker": "abc123",
-  "homepageUrl": "xyz789",
-  "logoUrl": "xyz789",
-  "liveStake": "abc123",
-  "activeStake": "abc123",
+  "ticker": "xyz789",
+  "homepageUrl": "abc123",
+  "logoUrl": "abc123",
+  "liveStake": "xyz789",
+  "activeStake": "xyz789",
   "liveDelegators": 987,
   "liveSaturation": 123.45,
   "declaredPledge": "abc123",
@@ -6837,9 +6837,9 @@ 
Fields
Example
{
-  "id": 123,
+  "id": 987,
   "hash": HexEncoded,
-  "protocolVersion": 987,
+  "protocolVersion": 123,
   "raw": HexEncoded,
   "block": Block,
   "contractActions": [ContractAction],
@@ -6893,7 +6893,7 @@ 
Fields
Example
{
   "hash": HexEncoded,
-  "url": "xyz789"
+  "url": "abc123"
 }
 
@@ -6954,9 +6954,9 @@
Fields
Example
{
-  "blockHeight": 987,
+  "blockHeight": 123,
   "blockHash": HexEncoded,
-  "timestamp": 987,
+  "timestamp": 123,
   "hash": HexEncoded,
   "url": "xyz789"
 }
@@ -7076,9 +7076,9 @@ 
Possible Types
Example
{
-  "id": 987,
+  "id": 123,
   "hash": HexEncoded,
-  "protocolVersion": 987,
+  "protocolVersion": 123,
   "raw": HexEncoded,
   "block": Block,
   "contractActions": [ContractAction],
@@ -7132,7 +7132,7 @@ 
Fields
Example
{
   "paidFees": "abc123",
-  "estimatedFees": "xyz789"
+  "estimatedFees": "abc123"
 }
 
@@ -7452,7 +7452,7 @@
Fields
Example
-
{"highestTransactionId": 123}
+                  
{"highestTransactionId": 987}
 
@@ -7539,12 +7539,12 @@
Example
{
   "owner": UnshieldedAddress,
   "tokenType": HexEncoded,
-  "value": "xyz789",
+  "value": "abc123",
   "intentHash": HexEncoded,
   "outputIndex": 123,
   "ctime": 123,
   "initialNonce": HexEncoded,
-  "registeredForDustGeneration": true,
+  "registeredForDustGeneration": false,
   "createdAtTransaction": Transaction,
   "spentAtTransaction": Transaction
 }
diff --git a/json-schema.json b/json-schema.json
index 5ad138b7..f64da8fe 100644
--- a/json-schema.json
+++ b/json-schema.json
@@ -1 +1 @@
-{"/":{"response":{"200":{"type":"object","properties":{"url":{"type":"string","example":"https://blockfrost.io/"},"version":{"type":"string","example":"0.1.0"}},"required":["url","version"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health":{"response":{"200":{"type":"object","properties":{"is_healthy":{"type":"boolean","example":true}},"required":["is_healthy"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health/clock":{"response":{"200":{"type":"object","properties":{"server_time":{"type":"integer","format":"int64","example":1603400958947}},"required":["server_time"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/latest/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/{hash_or_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"slot_number":{"type":"integer"}}}},"/blocks/epoch/{epoch_number}/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"epoch_number":{"type":"integer"},"slot_number":{"type":"integer"}}}},"/blocks/{hash_or_number}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address that was affected in the specified block"},"transactions":{"type":"array","description":"List of transactions containing the address either in their inputs or outputs. Sorted by transaction index within a block, ascending.","items":{"type":"object","properties":{"tx_hash":{"type":"string"}},"required":["tx_hash"]}}},"required":["address","transactions"]},"example":[{"address":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157d0"}]}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/genesis":{"response":{"200":{"type":"object","properties":{"active_slots_coefficient":{"type":"number","example":0.05,"description":"The proportion of slots in which blocks should be issued"},"update_quorum":{"type":"integer","example":5,"description":"Determines the quorum needed for votes on the protocol parameter updates"},"max_lovelace_supply":{"type":"string","example":"45000000000000000","description":"The total number of lovelace in the system"},"network_magic":{"type":"integer","example":764824073,"description":"Network identifier"},"epoch_length":{"type":"integer","example":432000,"description":"Number of slots in an epoch"},"system_start":{"type":"integer","example":1506203091,"description":"Time of slot 0 in UNIX time"},"slots_per_kes_period":{"type":"integer","example":129600,"description":"Number of slots in an KES period"},"slot_length":{"type":"integer","example":1,"description":"Duration of one slot in seconds"},"max_kes_evolutions":{"type":"integer","example":62,"description":"The maximum number of time a KES key can be evolved before a pool operator must create a new operational certificate"},"security_param":{"type":"integer","example":2160,"description":"Security parameter k"}},"required":["active_slots_coefficient","update_quorum","max_lovelace_supply","network_magic","epoch_length","system_start","slots_per_kes_period","slot_length","max_kes_evolutions","security_param"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/governance/dreps":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"drep_id":{"type":"string","description":"The Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"}},"required":["drep_id","hex"]},"example":[{"drep_id":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","hex":"db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23"},{"drep_id":"drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4","hex":"c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/dreps/{drep_id}":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"amount":{"type":"string","description":"The total amount of voting power this DRep is delegated."},"active":{"type":"boolean","description":"Registration state of the DRep","deprecated":true},"active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent registration","deprecated":true},"has_script":{"type":"boolean","description":"Flag which shows if this DRep credentials are a script hash"},"retired":{"type":"boolean","description":"Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`."},"expired":{"type":"boolean","description":"Whether the DRep has been inactive for a consecutive number of epochs (determined by a epoch parameter `drep_activity`)"},"last_active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent action - registration, update, deregistration or voting"}},"required":["drep_id","hex","amount","active","active_epoch","has_script","retired","expired","last_active_epoch"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","amount":"2000000","active":true,"active_epoch":420,"has_script":true,"last_active_epoch":509,"retired":false,"expired":false}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"amount":{"type":"string","description":"Currently delegated amount"}},"required":["address","amount"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","amount":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","amount":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","amount":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/metadata":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded addresses"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"url":{"type":"string","example":"https://stakenuts.com/drep.json","description":"URL to the drep metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-119)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["drep_id","hex","url","hash","json_metadata","bytes"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","url":"https://aaa.xyz/drep.json","hash":"a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de","json_metadata":{"@context":{"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP119":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#","hashAlgorithm":"CIP100:hashAlgorithm","body":{"@id":"CIP119:body","@context":{"references":{"@id":"CIP119:references","@container":"@set","@context":{"GovernanceMetadata":"CIP100:GovernanceMetadataReference","Other":"CIP100:OtherReference","label":"CIP100:reference-label","uri":"CIP100:reference-uri"}},"paymentAddress":"CIP119:paymentAddress","givenName":"CIP119:givenName","image":{"@id":"CIP119:image","@context":{"ImageObject":"https://schema.org/ImageObject"}},"objectives":"CIP119:objectives","motivations":"CIP119:motivations","qualifications":"CIP119:qualifications"}}},"hashAlgorithm":"blake2b-256","body":{"paymentAddress":"addr1q86dnpkva4mm859c8ur7tjxn57zgsu6vg8pdetkdve3fsacnq7twy06u2ev5759vutpjgzfryx0ud8hzedhzerava35qwh3x34","givenName":"Ryan Williams","image":{"@type":"ImageObject","contentUrl":"https://avatars.githubusercontent.com/u/44342099?v=4","sha256":"2a21e4f7b20c8c72f573707b068fb8fc6d8c64d5035c4e18ecae287947fe2b2e"},"objectives":"Buy myself an island.","motivations":"I really would like to own an island.","qualifications":"I have my 100m swimming badge, so I would be qualified to be able to swim around island.","references":[{"@type":"Other","label":"A cool island for Ryan","uri":"https://www.google.com/maps/place/World's+only+5th+order+recursive+island/@62.6511465,-97.7946829,15.75z/data=!4m14!1m7!3m6!1s0x5216a167810cee39:0x11431abdfe4c7421!2sWorld's+only+5th+order+recursive+island!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n!3m5!1s0x5216a167810cee39:0x11431abdfe4c7421!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n?authuser=0&entry=ttu"},{"@type":"Link","label":"Ryan's Twitter","uri":"https://twitter.com/Ryun1_"}]}},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Index of the certificate within the update transaction."},"action":{"type":"string","enum":["registered","deregistered","updated"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"f4097fbdb87ab7c7ab44b30d4e2b81713a058488975d1ab8b05c381dd946a393","cert_index":0,"action":"registered"},{"tx_hash":"dd3243af975be4b5bedce4e5f5b483b2386d5ad207d05e0289c1df0eb261447e","cert_index":0,"action":"deregistered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the vote transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the vote transaction."},"proposal_id":{"type":"string","description":"Governance Action Identifier (CIP-0129) of the proposal being voted on."},"proposal_tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"proposal_cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","proposal_id","proposal_tx_hash","proposal_cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"proposal_id":"gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn","proposal_tx_hash":"b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5","proposal_cert_index":0,"vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"proposal_id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","proposal_tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","proposal_cert_index":1,"vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/proposals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."}},"required":["id","tx_hash","cert_index","governance_type"]},"example":[{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals"},{"id":"gov_action1zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3","tx_hash":"71317e951b20aa46e9fbf45a46a6e950d5723a481225519655bf6c60","cert_index":4,"governance_type":"no_confidence"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/proposals/{tx_hash}/{cert_index}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)"}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{gov_action_id}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/epochs/latest":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/latest/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/{number}":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 prefix of the pool delegated to"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","pool_id","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes/{pool_id}":{"response":{"200":{"type":"array","items":{"properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/blocks/{pool_id}":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/txs/{hash}":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"block":{"type":"string","example":"356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940","description":"Block hash"},"block_height":{"type":"integer","example":123456,"description":"Block number"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"},"slot":{"type":"integer","example":42000000,"description":"Slot number"},"index":{"type":"integer","example":1,"description":"Transaction index within the block"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"},"treasury_donation":{"type":"string","example":"0","description":"Treasury donation in Lovelaces"}},"required":["hash","block","block_height","block_time","slot","index","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract","treasury_donation"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/utxos":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the input","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["address","amount","tx_hash","output_index","data_hash","inline_datum","reference_script_hash","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"consumed_by_tx":{"type":"string","nullable":true,"description":"Transaction hash that consumed the UTXO or null for unconsumed UTXOs. Always null for collateral outputs.","example":"66c29b56952f6085afac3b0632d781af78d020b080063bcfd6c54b8e2b8fed41"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}}},"required":["hash","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9t3a0tcwune5xrnfjg4q7cpvjlgx9lcv0cuqf5mhfjwrvcwrulda","description":"Delegation stake address"},"registration":{"type":"boolean","example":true,"description":"Registration boolean, false if deregistration"}},"required":["cert_index","address","registration"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction","deprecated":true},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 delegation stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 ID of delegated stake pool"},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"}},"required":["index","cert_index","address","pool_id","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 withdrawal address"},"amount":{"type":"string","example":"431833601","description":"Withdrawal amount in Lovelaces"}},"required":["address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pot":{"type":"string","enum":["reserve","treasury"],"example":"reserve","description":"Source of MIR funds"},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 stake address"},"amount":{"type":"string","example":"431833601","description":"MIR amount in Lovelaces"}},"required":["pot","cert_index","address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 encoded pool ID"},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge in Lovelaces"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool in Lovelaces"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]},"relays":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the update becomes active"}},"required":["cert_index","pool_id","vrf_key","pledge","margin_cost","fixed_cost","reward_account","owners","metadata","relays","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_retires":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 stake pool ID"},"retiring_epoch":{"type":"integer","example":216,"description":"Epoch in which the pool becomes retired"}},"required":["cert_index","pool_id","retiring_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"json_metadata":{}},"required":["label","json_metadata"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["label","cbor_metadata","metadata"]},"example":[{"label":"1968","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"script_hash":{"type":"string","example":"ec26b89af41bef0f7585353831cb5da42b5b37185e0c8a526143b824","description":"Script hash"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Redeemer data hash"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","deprecated":true,"description":"Datum hash"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_index","purpose","unit_mem","unit_steps","script_hash","redeemer_data_hash","datum_hash","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/required_signers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"witness_hash":{"type":"string","example":"d52e11f3e48436dd42dbec6d88c239732e503b8b7a32af58e5f87625","description":"Hash of the witness"}},"required":["witness_hash"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized transaction"}},"required":["cbor"],"example":{"cbor":"84a40081825820203e5b61e0949ffc8fe594727cf7ed73c7396cc2bd212af9a680c9423b5880eb00018282583900f0c60254ecb0addd4c7e40c28fd05b65014ab4c8ecece06c7dcee5a0724bf93336a8225e7ef152b41aea955173be91af19250edea1ddafab1a000f42408258390014beadb876d0a2a593fe2f1b539389e00731290910170e9a1be78e847d2ccdc7af469706878018739bcfde9ae23f009c4ae38aee0a4b4f3a1b0000000253fa0f93021a0002922d031a0303c827a100818258207d3ae39f9a1c916ac7c13f10c7d67c70b870c286a1af71485455c5022a3f391d5840e2f481acd1601a3f39fa976317bba685ddd774621a92611edaaa3df9f48a3b13d8b25ecb2f28b031c1602512418efed3033e463a0dcd22a856c808033cc9e00ff5f6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/tx/submit":{"response":{"200":{"type":"string","format":"hex","minLength":64,"maxLength":64,"example":"d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/accounts/{stake_address}":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"active":{"type":"boolean","example":true,"description":"Delegation state of the account. **Note:** For registration state, use the `registered` field instead."},"registered":{"type":"boolean","example":true,"description":"Registration state of an account"},"active_epoch":{"type":"integer","nullable":true,"example":412,"description":"Epoch of the most recent action - registration or deregistration"},"controlled_amount":{"type":"string","example":"619154618165","description":"Balance of the account in Lovelaces"},"rewards_sum":{"type":"string","example":"319154618165","description":"Sum of all rewards for the account in the Lovelaces"},"withdrawals_sum":{"type":"string","example":"12125369253","description":"Sum of all the withdrawals for the account in Lovelaces"},"reserves_sum":{"type":"string","example":"319154618165","description":"Sum of all  funds from reserves for the account in the Lovelaces"},"treasury_sum":{"type":"string","example":"12000000","description":"Sum of all funds from treasury for the account in the Lovelaces"},"withdrawable_amount":{"type":"string","example":"319154618165","description":"Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces"},"pool_id":{"type":"string","nullable":true,"example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID to which this account is delegated"},"drep_id":{"type":"string","nullable":true,"example":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","description":"Bech32 drep ID to which this account is delegated"}},"required":["stake_address","active","registered","active_epoch","controlled_amount","rewards_sum","withdrawals_sum","reserves_sum","treasury_sum","withdrawable_amount","pool_id","drep_id"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/rewards":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","description":"Epoch of the associated reward"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 pool ID being delegated to"},"type":{"type":"string","enum":["leader","member","pool_deposit_refund"],"description":"Type of the reward"}},"required":["epoch","amount","pool_id","type"]},"example":[{"epoch":215,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":216,"amount":"3586329","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1337","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"leader"},{"epoch":218,"amount":"1395265","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":218,"amount":"500000000","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"pool_deposit_refund"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the stake was active"},"amount":{"type":"string","description":"Stake amount in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"}},"required":["active_epoch","amount","pool_id"]},"example":[{"active_epoch":210,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"},{"active_epoch":211,"amount":"22695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"},"tx_hash":{"type":"string","description":"Hash of the transaction containing the delegation"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the delegation"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the delegation"},"block_height":{"type":"integer","description":"Block height of the transaction containing the delegation"}},"required":["active_epoch","tx_hash","amount","pool_id","tx_slot","block_time","block_height"]},"example":[{"active_epoch":210,"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"active_epoch":242,"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"12691385","pool_id":"pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/registrations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the (de)registration certificate"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the (de)registration certificate"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the (de)registration certificate"},"block_height":{"type":"integer","description":"Block height of the transaction containing the (de)registration certificate"}},"required":["tx_hash","action","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","action":"registered","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","action":"deregistered","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the withdrawal"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the withdrawal"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the withdrawal"},"block_height":{"type":"integer","description":"Block height of the transaction containing the withdrawal"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5","amount":"454541212442","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34","amount":"97846969","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the MIR"},"amount":{"type":"string","description":"MIR amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the MIR"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the MIR"},"block_height":{"type":"integer","description":"Block height of the transaction containing the MIR"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d","amount":"2193707473","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13","amount":"14520198574","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address associated with the stake key"}},"required":["address"]},"example":[{"address":"addr1qx2kd28nq8ac5prwg32hhvudlwggpgfp8utlyqxu6wqgz62f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sy0f4qd"},{"address":"addr1qys3czp8s9thc6u2fqed9yq3h24nyw28uk0m6mkgn9dkckjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9suth4w4"},{"address":"addr1q8j55h253zcvl326sk5qdt2n8z7eghzspe0ekxgncr796s2f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sjmd35m"},{"address":"addr1q8f7gxrprank3drhx8k5grlux7ene0nlwun8y9thu8mc3yjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sls6vnt"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/assets":{"response":{"200":{"type":"array","items":{"type":"object","description":"The sum of all assets of all addresses associated with a given account","properties":{"unit":{"type":"string","format":"Concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc537061636542756433343132","quantity":"1"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"125"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/total":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","description":"Bech32 encoded stake address","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions for all addresses associated with the account"}},"required":["stake_address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 address"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["address","tx_hash","tx_index","block_height","block_time"]},"example":[{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"bd78e0e73fb1691f08746a331bd764d11552c3a36ef766d4f1a3bbdc7f29918d","tx_index":34,"block_height":7900364,"block_time":1666114079},{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180},{"address":"addr1qxrrzqsqnzqx3p8sxxsry936h6c78ml4rdl224f33l7pmcnc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgqr735lq","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/mempool":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/mempool/{hash}":{"response":{"200":{"type":"object","properties":{"tx":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"}},"required":["hash","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract"]},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["tx_hash","output_index","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}},"redeemers":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"}},"required":["tx_index","purpose","unit_mem","unit_steps"]}}},"required":["tx","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/mempool/addresses/{address}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/metadata/txs/labels":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cip10":{"type":"string","nullable":true,"description":"CIP10 defined description"},"count":{"type":"string","description":"The count of metadata entries with a specific label"}},"required":["label","cip10","count"]},"example":[{"label":"1990","cip10":null,"count":"1"},{"label":"1967","cip10":"nut.link metadata oracles registry","count":"3"},{"label":"1968","cip10":"nut.link metadata oracles data points","count":"16321"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/metadata/txs/labels/{label}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata"}},"required":["tx_hash","json_metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","json_metadata":{"ADAUSD":[{"value":"0.10409800535729975","source":"ergoOracles"}]}},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","json_metadata":{"ADAUSD":[{"value":"0.15409850555139935","source":"ergoOracles"}]}},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","json_metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/metadata/txs/labels/{label}/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["tx_hash","cbor_metadata","metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cbor_metadata":null,"metadata":null},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","cbor_metadata":null,"metadata":null},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/addresses/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/extended":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"},"decimals":{"type":"integer","nullable":true,"description":"Number of decimal places of the asset unit. Primary data source is CIP68 reference NFT with a fallback to off-chain metadata."},"has_nft_onchain_metadata":{"type":"boolean","description":"True if the latest minting transaction includes metadata (best-effort)"}},"required":["unit","quantity","decimals","has_nft_onchain_metadata"]},"example":[{"unit":"lovelace","quantity":"42000000","decimals":6,"has_nft_onchain_metadata":false},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12","decimals":null,"has_nft_onchain_metadata":true}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/total":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions on the address"}},"required":["address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos/{asset}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"},"asset":{"type":"string"}}}},"/addresses/{address}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/pools":{"response":{"200":{"type":"array","items":{"type":"string","description":"Bech32 encoded pool ID"},"example":["pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288","pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/extended":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"active_stake":{"type":"string","example":"4200000000","description":"Active delegated amount"},"live_stake":{"type":"string","example":"6900000000","description":"Currently delegated amount"},"live_saturation":{"type":"number","example":0.93},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]}},"required":["pool_id","hex","active_stake","live_stake","blocks_minted","live_saturation","declared_pledge","margin_cost","fixed_cost","metadata"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","hex":"2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1","active_stake":"1541200000","live_stake":"1541400000","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}}}},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","hex":"6b3fda88053dc2cee18a7c2736f032182fcc78a2fe912e869aa4edcd","active_stake":"22200000","live_stake":"48955550","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","hex":"73318ec975cf1125a6367cbb1c9a406cbcb3e510e49d7c3aab14aa31","active_stake":"9989541215","live_stake":"168445464878","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retired":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retiring":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/{pool_id}":{"response":{"200":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"blocks_epoch":{"type":"integer","example":4,"description":"Number of blocks minted in the current epoch"},"live_stake":{"type":"string","example":"6900000000"},"live_size":{"type":"number","example":0.42},"live_saturation":{"type":"number","example":0.93},"live_delegators":{"type":"number","example":127},"active_stake":{"type":"string","example":"4200000000"},"active_size":{"type":"number","example":0.43},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"live_pledge":{"type":"string","example":"5000000001","description":"Stake pool current pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"registration":{"type":"array","items":{"type":"string","description":"Hash of the transaction including registration"},"example":["9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc","7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95","3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9"]},"retirement":{"type":"array","items":{"type":"string","description":"Hash of the transaction including retirement","example":"252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8"}},"calidus_key":{"type":"object","nullable":true,"description":"Last valid Calidus key for the pool","properties":{"id":{"type":"string","example":"calidus15yt3nqapz799tvp2lt8adttt29k6xa2xnltahn655tu4sgcph42p7","description":"A Bech32-encoded identifier derived from the calidus public key"},"pub_key":{"type":"string","example":"57758911253f6b31df2a87c10eb08a2c9b8450768cb8dd0d378d93f7c2e220f0","description":"The raw hexadecimal-encoded calidus public key used for verification purposes"},"nonce":{"type":"integer","example":149292000,"description":"A unique number used once to prevent replay attacks and ensure the uniqueness of the key registration"},"tx_hash":{"type":"string","example":"f45ed21c6bc1832cf7f11f4bd6ee47ca9684b4f6f8ff8a398aa2df065eac0ba8","description":"The transaction hash that submitted the Calidus key registration"},"block_height":{"type":"integer","example":11548408,"description":"The block height at which this key registration was recorded"},"block_time":{"type":"integer","example":1740858988,"description":"Block time of the key registration"},"epoch":{"type":"integer","example":543,"description":"Epoch number of the key registration"}},"required":["id","pub_key","nonce","tx_hash","block_height","block_time","epoch"]}},"required":["pool_id","hex","vrf_key","blocks_minted","blocks_epoch","live_stake","live_size","live_saturation","live_delegators","active_stake","active_size","declared_pledge","live_pledge","margin_cost","fixed_cost","reward_account","owners","registration","retirement","calidus_key"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":233,"description":"Epoch number"},"blocks":{"type":"integer","example":22,"description":"Number of blocks created by pool"},"active_stake":{"type":"string","example":"20485965693569","description":"Active (Snapshot of live stake 2 epochs ago) stake in Lovelaces"},"active_size":{"type":"number","example":1.2345,"description":"Pool size (percentage) of overall active stake at that epoch"},"delegators_count":{"type":"integer","example":115,"description":"Number of delegators for epoch"},"rewards":{"type":"string","example":"206936253674159","description":"Total rewards received before distribution to delegators"},"fees":{"type":"string","example":"1290968354","description":"Pool operator rewards"}},"required":["epoch","blocks","active_stake","active_size","delegators_count","rewards","fees"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/metadata":{"response":{"200":{"anyOf":[{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID"},"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["pool_id","hex","url","hash","ticker","name","description","homepage"]},{"type":"object"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/relays":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"live_stake":{"type":"string","description":"Currently delegated amount"}},"required":["address","live_stake"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","live_stake":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","live_stake":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","live_stake":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Block hashes"},"example":["d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d","026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c","bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c","86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Certificate within the transaction"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","cert_index":0,"action":"registered"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","cert_index":0,"action":"deregistered"},{"tx_hash":"e14a75b0eb2625de7055f1f580d70426311b78e0d36dd695a6bdc96c7b3d80e0","cert_index":1,"action":"registered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"vote":"yes"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/assets":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","format":"Concatenation of the policy_id and hex-encoded asset_name","description":"Asset identifier"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e75d","quantity":"100000"},{"asset":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/assets/{asset}":{"response":{"200":{"type":"object","properties":{"asset":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","description":"Hex-encoded asset full name"},"policy_id":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7","description":"Policy ID of the asset"},"asset_name":{"type":"string","nullable":true,"example":"6e7574636f696e","description":"Hex-encoded asset name of the asset"},"fingerprint":{"type":"string","example":"asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w","description":"CIP14 based user-facing fingerprint"},"quantity":{"type":"string","example":"12000","description":"Current asset quantity"},"initial_mint_tx_hash":{"type":"string","example":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","description":"ID of the initial minting transaction"},"mint_or_burn_count":{"type":"integer","example":1,"description":"Count of mint and burn transactions"},"onchain_metadata":{"type":"object","nullable":true,"additionalProperties":true,"description":"On-chain metadata which SHOULD adhere to the valid standards,\nbased on which we perform the look up and display the asset\n(best effort)\n"},"onchain_metadata_standard":{"type":"string","nullable":true,"enum":["CIP25v1","CIP25v2","CIP68v1","CIP68v2","CIP68v3"],"description":"If on-chain metadata passes validation, we display the standard\nunder which it is valid\n"},"onchain_metadata_extra":{"type":"string","nullable":true,"description":"Arbitrary plutus data (CIP68).\n"},"metadata":{"type":"object","nullable":true,"description":"Off-chain metadata fetched from GitHub based on network.\nMainnet: https://github.com/cardano-foundation/cardano-token-registry/\nTestnet: https://github.com/input-output-hk/metadata-registry-testnet/\n","properties":{"name":{"type":"string","example":"nutcoin","description":"Asset name"},"description":{"type":"string","example":"The Nut Coin","description":"Asset description"},"ticker":{"type":"string","nullable":true,"example":"nutc"},"url":{"type":"string","nullable":true,"example":"https://www.stakenuts.com/","description":"Asset website"},"logo":{"type":"string","nullable":true,"example":"iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII=","description":"Base64 encoded logo of the asset"},"decimals":{"type":"integer","nullable":true,"maximum":255,"example":6,"description":"Number of decimal places of the asset unit"}},"required":["name","description","ticker","url","logo","decimals"]}},"required":["asset","policy_id","asset_name","fingerprint","quantity","initial_mint_tx_hash","mint_or_burn_count","metadata","onchain_metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the asset action"},"action":{"type":"string","enum":["minted","burned"],"description":"Action executed upon the asset policy"},"amount":{"type":"string","description":"Asset amount of the specific action"}},"required":["tx_hash","action","amount"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"10","action":"minted"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","amount":"5","action":"burned"},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"5","action":"burned"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address containing the specific asset"},"quantity":{"type":"string","description":"Asset quantity on the specific address"}},"required":["address","quantity"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","quantity":"1"},{"address":"addr1qyhr4exrgavdcn3qhfcc9f939fzsch2re5ry9cwvcdyh4x4re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qdpvhza","quantity":"100000"},{"address":"addr1q8zup8m9ue3p98kxlxl9q8rnyan8hw3ul282tsl9s326dfj088lvedv4zckcj24arcpasr0gua4c5gq4zw2rpcpjk2lq8cmd9l","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/policy/{policy_id}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"Concatenation of the policy_id and hex-encoded asset_name"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a766e","quantity":"100000"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb574636f696e","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"policy_id":{"type":"string"}}}},"/scripts":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"script_hash":{"type":"string","description":"Script hash"}},"required":["script_hash"]},"example":[{"script_hash":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},{"script_hash":"e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e"},{"script_hash":"a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/scripts/{script_hash}":{"response":{"200":{"type":"object","properties":{"script_hash":{"type":"string","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1","description":"Script hash"},"type":{"type":"string","enum":["timelock","plutusV1","plutusV2","plutusV3"],"example":"plutusV1","description":"Type of the script language"},"serialised_size":{"type":"integer","nullable":true,"description":"The size of the CBOR serialised script, if a Plutus script","example":3119}},"required":["script_hash","type","serialised_size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/json":{"response":{"200":{"type":"object","properties":{"json":{"nullable":true}},"required":["json"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","nullable":true,"description":"CBOR contents of the `plutus` script, null for `timelocks`"}},"required":["cbor"],"example":{"cbor":"4e4d01000033222220051200120011"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the transaction"},"tx_index":{"type":"integer","example":0,"description":"The index of the redeemer pointer in the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash of the redeemer"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash","deprecated":true},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_hash","tx_index","purpose","redeemer_data_hash","datum_hash","unit_mem","unit_steps","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}":{"response":{"200":{"type":"object","properties":{"json_value":{"type":"object","additionalProperties":true,"description":"JSON content of the datum"}},"required":["json_value"],"example":{"json_value":{"int":42}}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized datum"}},"required":["cbor"],"example":{"cbor":"19a6aa"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/utils/addresses/xpub/{xpub}/{role}/{index}":{"response":{"200":{"type":"object","properties":{"xpub":{"type":"string","description":"Script hash"},"role":{"type":"integer","description":"Account role"},"index":{"type":"integer","description":"Address index"},"address":{"type":"string","description":"Derived address"}},"required":["xpub","role","index","address"],"example":[{"xpub":"d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a","role":0,"index":0,"address":"addr1q90sqnljxky88s0jsnps48jd872p7znzwym0jpzqnax6qs5nfrlkaatu28n0qzmqh7f2cpksxhpc9jefx3wrl0a2wu8q5amen7"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"xpub":{"type":"string"},"role":{"type":"integer"},"index":{"type":"integer"}}}},"/utils/txs/evaluate":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/utils/txs/evaluate/utxos":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/ipfs/add":{"response":{"200":{"type":"object","properties":{"name":{"type":"string","example":"README.md","description":"Name of the file"},"ipfs_hash":{"type":"string","example":"QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr","description":"IPFS hash of the file"},"size":{"type":"string","example":"125297","description":"IPFS node size in Bytes"}},"required":["name","ipfs_hash","size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/ipfs/gateway/{IPFS_path}":{"response":{"200":{"type":"string","format":"binary"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/add/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"queued","description":"State of the pin action"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["ipfs_hash","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"filecoin":{"type":"boolean"}}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/list":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time_created":{"type":"integer","description":"Creation time of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Pin time of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object, which is `queued` when we are retriving object. If this\nis successful the state is changed to `pinned` or `failed` if not. The state `gc` means the\npinned item has been garbage collected due to account being over storage quota or after it has\nbeen moved to `unpinned` state by removing the object pin.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/ipfs/pin/list/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"time_created":{"type":"integer","description":"Time of the creation of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Time of the pin of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`.\nWhen the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`.\nIf the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise.\nWhen object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection.\nState `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/ipfs/pin/remove/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"unpinned","description":"State of the pin action"}},"required":["ipfs_hash","state"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/metrics":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day"}},"required":["time","calls"]},"example":[{"time":1612543884,"calls":42},{"time":1614523884,"calls":6942}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/metrics/endpoints":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day and endpoint"},"endpoint":{"type":"string","description":"Endpoint parent name"}},"required":["time","calls","endpoint"]},"example":[{"time":1612543814,"calls":182,"endpoint":"block"},{"time":1612543814,"calls":42,"endpoint":"epoch"},{"time":1612543812,"calls":775,"endpoint":"block"},{"time":1612523884,"calls":4,"endpoint":"epoch"},{"time":1612553884,"calls":89794,"endpoint":"block"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network":{"response":{"200":{"type":"object","properties":{"supply":{"type":"object","properties":{"max":{"type":"string","description":"Maximum supply in Lovelaces","example":"45000000000000000"},"total":{"type":"string","description":"Current total (max supply - reserves) supply in Lovelaces","example":"32890715183299160"},"circulating":{"type":"string","description":"Current circulating (UTXOs + withdrawables) supply in Lovelaces","example":"32412601976210393"},"locked":{"type":"string","description":"Current supply locked by scripts in Lovelaces","example":"125006953355"},"treasury":{"type":"string","description":"Current supply locked in treasury","example":"98635632000000"},"reserves":{"type":"string","description":"Current supply locked in reserves","example":"46635632000000"}},"required":["max","total","circulating","locked","treasury","reserves"]},"stake":{"type":"object","properties":{"live":{"type":"string","example":"23204950463991654","description":"Current live stake in Lovelaces"},"active":{"type":"string","description":"Current active stake in Lovelaces","example":"22210233523456321"}},"required":["live","active"]}},"required":["supply","stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network/eras":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"start":{"type":"object","description":"Start of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"end":{"type":"object","description":"End of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"parameters":{"type":"object","description":"Era parameters","properties":{"epoch_length":{"type":"integer","description":"Epoch length in number of slots"},"slot_length":{"type":"integer","description":"Slot length in seconds"},"safe_zone":{"type":"integer","description":"Zone in which it is guaranteed that no hard fork can take place"}},"required":["epoch_length","slot_length","safe_zone"]}},"required":["start","end","parameters"]},"example":[{"start":{"time":0,"slot":0,"epoch":0},"end":{"time":89856000,"slot":4492800,"epoch":208},"parameters":{"epoch_length":21600,"slot_length":20,"safe_zone":4320}},{"start":{"time":89856000,"slot":4492800,"epoch":208},"end":{"time":101952000,"slot":16588800,"epoch":236},"parameters":{"epoch_length":432000,"slot_length":1,"safe_zone":129600}}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/nutlink/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"metadata_url":{"type":"string","description":"URL of the specific metadata file","example":"https://nut.link/metadata.json"},"metadata_hash":{"type":"string","description":"Hash of the metadata file","example":"6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af"},"metadata":{"type":"object","nullable":true,"description":"The cached metadata of the `metadata_url` file.","additionalProperties":true}},"required":["address","metadata_url","metadata_hash","metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the ticker"},"count":{"type":"integer","description":"Number of ticker records"},"latest_block":{"type":"integer","description":"Block height of the latest record"}},"required":["name","count","latest_block"]},"example":[{"name":"ADAUSD","count":1980038,"latest_block":2657092},{"name":"ADAEUR","count":1980038,"latest_block":2657092},{"name":"ADABTC","count":1980038,"latest_block":2657092}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_height":{"type":"integer"},"tx_index":{"type":"integer"},"payload":{}},"required":["tx_hash","tx_index","block_height","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/nutlink/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"block_height":{"type":"integer","description":"Block height of the record"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"payload":{}},"required":["address","tx_hash","block_height","tx_index","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/api/v2/status":{"response":{"200":{"type":"object","properties":{"blockbook":{"type":"object","properties":{"coin":{"type":"string"},"network":{"type":"string"},"host":{"type":"string"},"version":{"type":"string"},"gitCommit":{"type":"string"},"buildTime":{"type":"string"},"syncMode":{"type":"boolean"},"initialSync":{"type":"boolean"},"inSync":{"type":"boolean"},"bestHeight":{"type":"integer"},"lastBlockTime":{"type":"string"},"inSyncMempool":{"type":"boolean"},"lastMempoolTime":{"type":"string"},"mempoolSize":{"type":"integer"},"decimals":{"type":"integer"},"dbSize":{"type":"integer"},"hasFiatRates":{"type":"boolean"},"currentFiatRatesTime":{"type":"string"},"historicalFiatRatesTime":{"type":"string"},"about":{"type":"string"}}},"backend":{"type":"object","properties":{"chain":{"type":"string"},"blocks":{"type":"integer"},"headers":{"type":"integer"},"bestBlockHash":{"type":"string"},"difficulty":{"type":"string"},"sizeOnDisk":{"type":"integer"},"version":{"type":"string"},"subversion":{"type":"string"},"protocolVersion":{"type":"string"}}}},"x-examples":{"Example 1":{"blockbook":{"coin":"Bitcoin","host":"s4","version":"0.4.0","gitCommit":"83fe6672","buildTime":"2023-02-27T02:40:48+00:00","syncMode":true,"initialSync":false,"inSync":true,"bestHeight":784299,"lastBlockTime":"2023-04-07T02:55:40.032567054Z","inSyncMempool":true,"lastMempoolTime":"2023-04-07T03:04:36.260327616Z","mempoolSize":30785,"decimals":8,"dbSize":399834379691,"hasFiatRates":true,"currentFiatRatesTime":"2023-04-07T03:00:04.080770962Z","historicalFiatRatesTime":"2023-04-07T00:00:00Z","about":"Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook"},"backend":{"chain":"main","blocks":784299,"headers":784299,"bestBlockHash":"00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719","difficulty":"47887764338536.25","sizeOnDisk":534828732178,"version":"240001","subversion":"/Satoshi:24.0.1/","protocolVersion":"70016"}}}}}},"/api/v2/block/{blockHashOrHeight}":{"response":{"200":{"type":"object","properties":{"page":{"type":"integer"},"totalPages":{"type":"integer"},"itemsOnPage":{"type":"integer"},"hash":{"type":"string"},"previousBlockHash":{"type":"string"},"nextBlockHash":{"type":"string"},"height":{"type":"integer"},"confirmations":{"type":"integer"},"size":{"type":"integer"},"time":{"type":"integer"},"version":{"type":"integer"},"merkleRoot":{"type":"string"},"nonce":{"type":"string"},"bits":{"type":"string"},"difficulty":{"type":"string"},"txCount":{"type":"integer"},"txs":{"type":"array","items":{"type":"object","properties":{"txid":{"type":"string"},"vin":{"type":"array","items":{"type":"object","properties":{"n":{"type":"integer"},"isAddress":{"type":"boolean"},"value":{"type":"string"}}}},"vout":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"n":{"type":"integer"},"addresses":{"type":"array","items":{"type":"string"}},"isAddress":{"type":"boolean"}}}},"blockHash":{"type":"string"},"blockHeight":{"type":"integer"},"confirmations":{"type":"integer"},"blockTime":{"type":"integer"},"value":{"type":"string"},"valueIn":{"type":"string"},"fees":{"type":"string"}}}}},"x-examples":{"Example 1":{"page":1,"totalPages":1,"itemsOnPage":1000,"hash":"00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048","previousBlockHash":"000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f","nextBlockHash":"000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd","height":1,"confirmations":784303,"size":215,"time":1231469665,"version":1,"merkleRoot":"0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098","nonce":"2573394689","bits":"1d00ffff","difficulty":"1","txCount":1,"txs":[{"txid":"0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098","vin":[{"n":0,"isAddress":false,"value":"0"}],"vout":[{"value":"5000000000","n":0,"addresses":["12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX"],"isAddress":true}],"blockHash":"00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048","blockHeight":1,"confirmations":784303,"blockTime":1231469665,"value":"5000000000","valueIn":"0","fees":"0"}]}}}}},"/api/v2/block-index/{blockHeight}":{"response":{"200":{"type":"object","properties":{"blockHash":{"type":"string"}},"x-examples":{"Example 1":{"blockHash":"ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e"}}}}},"/api/v2/tx-specific/{txId}":{"response":{"200":{"type":"object","additionalProperties":true}}},"/api/v2/address/{address}":{"response":{"200":{"type":"object","additionalProperties":true}}},"/api/v2/xpub/{xpub}":{"response":{"200":{"type":"object","properties":{"page":{"type":"integer"},"totalPages":{"type":"integer"},"itemsOnPage":{"type":"integer"},"address":{"type":"string"},"balance":{"type":"string"},"totalReceived":{"type":"string"},"totalSent":{"type":"string"},"unconfirmedBalance":{"type":"string"},"unconfirmedTxs":{"type":"integer"},"txs":{"type":"integer"},"txids":{"type":"array","items":{"type":"string"}},"usedTokens":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"transfers":{"type":"integer"},"decimals":{"type":"integer"},"balance":{"type":"string"},"totalReceived":{"type":"string"},"totalSent":{"type":"string"}}}},"secondaryValue":{"type":"number"}},"x-examples":{"Example 1":{"page":1,"totalPages":1,"itemsOnPage":1000,"address":"dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF","balance":"90000000","totalReceived":"3093381250","totalSent":"3083381250","unconfirmedBalance":"0","unconfirmedTxs":0,"txs":5,"txids":["383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c","75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798","e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876","57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23","9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f"],"usedTokens":2,"tokens":[{"type":"XPUBAddress","name":"DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS","path":"m/44'/3'/0'/0/0","transfers":3,"decimals":8,"balance":"90000000","totalReceived":"2903986975","totalSent":"2803986975"},{"type":"XPUBAddress","name":"DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj","path":"m/44'/3'/0'/1/0","transfers":2,"decimals":8,"balance":"0","totalReceived":"279394275","totalSent":"279394275"}],"secondaryValue":21195.47633568}}}}},"/api/v2/utxo/{addressOrXpub}":{"response":{"200":{"type":"array","items":{}}}},"/api/v2/sendtx":{"response":{"200":{"type":"object","properties":{"result":{"type":"string"}},"x-examples":{"Example 1":{"result":"7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"}}}}}}
+{"/":{"response":{"200":{"type":"object","properties":{"url":{"type":"string","example":"https://blockfrost.io/"},"version":{"type":"string","example":"0.1.0"}},"required":["url","version"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health":{"response":{"200":{"type":"object","properties":{"is_healthy":{"type":"boolean","example":true}},"required":["is_healthy"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/health/clock":{"response":{"200":{"type":"object","properties":{"server_time":{"type":"integer","format":"int64","example":1603400958947}},"required":["server_time"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/blocks/latest/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/latest/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/blocks/{hash_or_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"slot_number":{"type":"integer"}}}},"/blocks/epoch/{epoch_number}/slot/{slot_number}":{"response":{"200":{"type":"object","properties":{"time":{"type":"integer","example":1641338934,"description":"Block creation time in UNIX time"},"height":{"type":"integer","nullable":true,"example":15243593,"description":"Block number"},"hash":{"type":"string","example":"4ea1ba291e8eef538635a53e59fddba7810d1679631cc3aed7c8e6c4091a516a","description":"Hash of the block"},"slot":{"type":"integer","nullable":true,"example":412162133,"description":"Slot number"},"epoch":{"type":"integer","nullable":true,"example":425,"description":"Epoch number"},"epoch_slot":{"type":"integer","nullable":true,"example":12,"description":"Slot within the epoch"},"slot_leader":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2qnikdy","description":"Bech32 ID of the slot leader or specific block description in case there is no slot leader"},"size":{"type":"integer","example":3,"description":"Block size in Bytes"},"tx_count":{"type":"integer","example":1,"description":"Number of transactions in the block"},"output":{"type":"string","nullable":true,"example":"128314491794","description":"Total output within the block in Lovelaces"},"fees":{"type":"string","nullable":true,"example":"592661","description":"Total fees within the block in Lovelaces"},"block_vrf":{"type":"string","nullable":true,"example":"vrf_vk1wf2k6lhujezqcfe00l6zetxpnmh9n6mwhpmhm0dvfh3fxgmdnrfqkms8ty","description":"VRF key of the block","minLength":65,"maxLength":65},"op_cert":{"type":"string","nullable":true,"example":"da905277534faf75dae41732650568af545134ee08a3c0392dbefc8096ae177c","description":"The hash of the operational certificate of the block producer"},"op_cert_counter":{"type":"string","nullable":true,"example":"18","description":"The value of the counter used to produce the operational certificate"},"previous_block":{"type":"string","nullable":true,"example":"43ebccb3ac72c7cebd0d9b755a4b08412c9f5dcb81b8a0ad1e3c197d29d47b05","description":"Hash of the previous block"},"next_block":{"type":"string","nullable":true,"example":"8367f026cf4b03e116ff8ee5daf149b55ba5a6ec6dec04803b8dc317721d15fa","description":"Hash of the next block"},"confirmations":{"type":"integer","example":4698,"description":"Number of block confirmations"}},"required":["time","height","hash","slot","epoch","epoch_slot","slot_leader","size","tx_count","output","fees","block_vrf","op_cert","op_cert_counter","previous_block","next_block","confirmations"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"epoch_number":{"type":"integer"},"slot_number":{"type":"integer"}}}},"/blocks/{hash_or_number}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/txs/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"cbor":{"type":"string","description":"CBOR representation of the transaction data"}},"required":["tx_hash","cbor"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","cbor":"a10081825820cccfe2be401c85342497f6e1e4a241629790b0fb7f2af5f18441779d11f25b1f5840c38a93d63faac9335ecc2f24ead7ca2d46a6637f354ee707bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"},{"tx_hash":"4eef6bb7755d8afbeac526b799f3e32a624691d166657e9d862aaeb66682c036","cbor":"bb06eb8192af2fa6a676fb72f8772cd1c42b491ec6dfc798c76b61c55dc4eecab362e71ffab26305"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/blocks/{hash_or_number}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address that was affected in the specified block"},"transactions":{"type":"array","description":"List of transactions containing the address either in their inputs or outputs. Sorted by transaction index within a block, ascending.","items":{"type":"object","properties":{"tx_hash":{"type":"string"}},"required":["tx_hash"]}}},"required":["address","transactions"]},"example":[{"address":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","transactions":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157d0"}]}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"hash_or_number":{"type":"string"}}}},"/genesis":{"response":{"200":{"type":"object","properties":{"active_slots_coefficient":{"type":"number","example":0.05,"description":"The proportion of slots in which blocks should be issued"},"update_quorum":{"type":"integer","example":5,"description":"Determines the quorum needed for votes on the protocol parameter updates"},"max_lovelace_supply":{"type":"string","example":"45000000000000000","description":"The total number of lovelace in the system"},"network_magic":{"type":"integer","example":764824073,"description":"Network identifier"},"epoch_length":{"type":"integer","example":432000,"description":"Number of slots in an epoch"},"system_start":{"type":"integer","example":1506203091,"description":"Time of slot 0 in UNIX time"},"slots_per_kes_period":{"type":"integer","example":129600,"description":"Number of slots in an KES period"},"slot_length":{"type":"integer","example":1,"description":"Duration of one slot in seconds"},"max_kes_evolutions":{"type":"integer","example":62,"description":"The maximum number of time a KES key can be evolved before a pool operator must create a new operational certificate"},"security_param":{"type":"integer","example":2160,"description":"Security parameter k"}},"required":["active_slots_coefficient","update_quorum","max_lovelace_supply","network_magic","epoch_length","system_start","slots_per_kes_period","slot_length","max_kes_evolutions","security_param"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/governance/dreps":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"drep_id":{"type":"string","description":"The Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"}},"required":["drep_id","hex"]},"example":[{"drep_id":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","hex":"db1bc3c3f99ce68977ceaf27ab4dd917123ef9e73f85c304236eab23"},{"drep_id":"drep1cxayn4fgy27yaucvhamsvqj3v6835mh3tjjx6x8hdnr4","hex":"c1ba49d52822bc4ef30cbf77060251668f1a6ef15ca46d18f76cc758"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/dreps/{drep_id}":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded DRep address"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"amount":{"type":"string","description":"The total amount of voting power this DRep is delegated."},"active":{"type":"boolean","description":"Registration state of the DRep","deprecated":true},"active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent registration","deprecated":true},"has_script":{"type":"boolean","description":"Flag which shows if this DRep credentials are a script hash"},"retired":{"type":"boolean","description":"Registration state of the DRep. Set to `true` if the DRep has been deregistered; otherwise, `false`."},"expired":{"type":"boolean","description":"Whether the DRep has been inactive for a consecutive number of epochs (determined by a epoch parameter `drep_activity`)"},"last_active_epoch":{"type":"integer","nullable":true,"description":"Epoch of the most recent action - registration, update, deregistration or voting"}},"required":["drep_id","hex","amount","active","active_epoch","has_script","retired","expired","last_active_epoch"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","amount":"2000000","active":true,"active_epoch":420,"has_script":true,"last_active_epoch":509,"retired":false,"expired":false}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"amount":{"type":"string","description":"Currently delegated amount"}},"required":["address","amount"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","amount":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","amount":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","amount":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/metadata":{"response":{"200":{"type":"object","properties":{"drep_id":{"type":"string","description":"Bech32 encoded addresses"},"hex":{"type":"string","description":"The raw bytes of the DRep"},"url":{"type":"string","example":"https://stakenuts.com/drep.json","description":"URL to the drep metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-119)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["drep_id","hex","url","hash","json_metadata","bytes"],"example":{"drep_id":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","hex":"a61261172624e8333ceff098648d90f8e404e2e36d5b5f5985cbd35d","url":"https://aaa.xyz/drep.json","hash":"a14a5ad4f36bddc00f92ddb39fd9ac633c0fd43f8bfa57758f9163d10ef916de","json_metadata":{"@context":{"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP119":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0119/README.md#","hashAlgorithm":"CIP100:hashAlgorithm","body":{"@id":"CIP119:body","@context":{"references":{"@id":"CIP119:references","@container":"@set","@context":{"GovernanceMetadata":"CIP100:GovernanceMetadataReference","Other":"CIP100:OtherReference","label":"CIP100:reference-label","uri":"CIP100:reference-uri"}},"paymentAddress":"CIP119:paymentAddress","givenName":"CIP119:givenName","image":{"@id":"CIP119:image","@context":{"ImageObject":"https://schema.org/ImageObject"}},"objectives":"CIP119:objectives","motivations":"CIP119:motivations","qualifications":"CIP119:qualifications"}}},"hashAlgorithm":"blake2b-256","body":{"paymentAddress":"addr1q86dnpkva4mm859c8ur7tjxn57zgsu6vg8pdetkdve3fsacnq7twy06u2ev5759vutpjgzfryx0ud8hzedhzerava35qwh3x34","givenName":"Ryan Williams","image":{"@type":"ImageObject","contentUrl":"https://avatars.githubusercontent.com/u/44342099?v=4","sha256":"2a21e4f7b20c8c72f573707b068fb8fc6d8c64d5035c4e18ecae287947fe2b2e"},"objectives":"Buy myself an island.","motivations":"I really would like to own an island.","qualifications":"I have my 100m swimming badge, so I would be qualified to be able to swim around island.","references":[{"@type":"Other","label":"A cool island for Ryan","uri":"https://www.google.com/maps/place/World's+only+5th+order+recursive+island/@62.6511465,-97.7946829,15.75z/data=!4m14!1m7!3m6!1s0x5216a167810cee39:0x11431abdfe4c7421!2sWorld's+only+5th+order+recursive+island!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n!3m5!1s0x5216a167810cee39:0x11431abdfe4c7421!8m2!3d62.651114!4d-97.7872244!16s%2Fg%2F11spwk2b6n?authuser=0&entry=ttu"},{"@type":"Link","label":"Ryan's Twitter","uri":"https://twitter.com/Ryun1_"}]}},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Index of the certificate within the update transaction."},"action":{"type":"string","enum":["registered","deregistered","updated"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"f4097fbdb87ab7c7ab44b30d4e2b81713a058488975d1ab8b05c381dd946a393","cert_index":0,"action":"registered"},{"tx_hash":"dd3243af975be4b5bedce4e5f5b483b2386d5ad207d05e0289c1df0eb261447e","cert_index":0,"action":"deregistered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/dreps/{drep_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the vote transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the vote transaction."},"proposal_id":{"type":"string","description":"Governance Action Identifier (CIP-0129) of the proposal being voted on."},"proposal_tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"proposal_cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","proposal_id","proposal_tx_hash","proposal_cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"proposal_id":"gov_action1k2jertppnnndejjcglszfqq4yzw8evzrd2nt66rr6rqlz54xp0zsq05ecsn","proposal_tx_hash":"b2a591ac219ce6dcca5847e0248015209c7cb0436aa6bd6863d0c1f152a60bc5","proposal_cert_index":0,"vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"proposal_id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","proposal_tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","proposal_cert_index":1,"vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"drep_id":{"type":"string"}}}},"/governance/proposals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."}},"required":["id","tx_hash","cert_index","governance_type"]},"example":[{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals"},{"id":"gov_action1zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3zyx3","tx_hash":"71317e951b20aa46e9fbf45a46a6e950d5723a481225519655bf6c60","cert_index":4,"governance_type":"no_confidence"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/governance/proposals/{tx_hash}/{cert_index}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{tx_hash}/{cert_index}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)"}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"tx_hash":{"type":"string"},"cert_index":{"type":"integer"}}}},"/governance/proposals/{gov_action_id}":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"governance_type":{"type":"string","enum":["hard_fork_initiation","new_committee","new_constitution","info_action","no_confidence","parameter_change","treasury_withdrawals"],"description":"Type of proposal."},"governance_description":{"additionalProperties":true,"type":"object","nullable":true,"description":"An object describing the content of this GovActionProposal in a readable way."},"deposit":{"type":"string","description":"The deposit amount paid for this proposal."},"return_address":{"type":"string","description":"Bech32 stake address of the reward address to receive the deposit when it is repaid."},"ratified_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was ratified. Null if the proposal has not been ratified."},"enacted_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was enacted. Null if the proposal has not been enacted."},"dropped_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal was dropped. A proposal is dropped if it expires or if any of its dependencies expire."},"expired_epoch":{"type":"integer","nullable":true,"description":"The epoch at which the proposal expired. Null if the proposal has not expired."},"expiration":{"type":"integer","description":"The epoch at which this governance action will expire."}},"required":["id","tx_hash","cert_index","governance_type","deposit","return_address","governance_description","ratified_epoch","enacted_epoch","dropped_epoch","expired_epoch","expiration"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","cert_index":1,"governance_type":"treasury_withdrawals","deposit":"12000","return_address":"stake_test1urd3hs7rlxwwdzthe6hj026dmyt3y0heuulctscyydh2kgck6nkmz","governance_description":{"tag":"InfoAction"},"ratified_epoch":null,"enacted_epoch":123,"dropped_epoch":null,"expired_epoch":null,"expiration":120}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/parameters":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"parameters":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number","nullable":true},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch","nullable":true},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation","nullable":true},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes","nullable":true},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size","nullable":true},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size","nullable":true},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces","nullable":true},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces","nullable":true},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement","nullable":true},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools","nullable":true},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence","nullable":true},"rho":{"type":"number","example":0.003,"description":"Monetary expansion","nullable":true},"tau":{"type":"number","example":0.2,"description":"Treasury expansion","nullable":true},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes","nullable":true},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version","nullable":true},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version","nullable":true},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value","nullable":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool","nullable":true},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."},"pvt_committee_normal":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."},"pvt_committee_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"pvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_motion_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."},"dvt_committee_normal":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."},"dvt_committee_no_confidence":{"type":"number","nullable":true,"description":"DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."},"dvt_update_to_constitution":{"type":"number","nullable":true,"description":"DRep Vote threshold for update to the Constitution. New in 13.2-Conway."},"dvt_hard_fork_initiation":{"type":"number","nullable":true,"description":"DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."},"dvt_p_p_network_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."},"dvt_p_p_economic_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."},"dvt_p_p_technical_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."},"dvt_p_p_gov_group":{"type":"number","nullable":true,"description":"DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."},"dvt_treasury_withdrawal":{"type":"number","nullable":true,"description":"DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."},"committee_min_size":{"type":"string","nullable":true,"format":"word64type","description":"Minimal constitutional committee size. New in 13.2-Conway."},"committee_max_term_length":{"type":"string","nullable":true,"format":"word64type","description":"Constitutional committee term limits. New in 13.2-Conway."},"gov_action_lifetime":{"type":"string","nullable":true,"format":"word64type","description":"Governance action expiration. New in 13.2-Conway."},"gov_action_deposit":{"type":"string","nullable":true,"format":"word64type","description":"Governance action deposit. New in 13.2-Conway."},"drep_deposit":{"type":"string","nullable":true,"format":"word64type","description":"DRep deposit amount. New in 13.2-Conway."},"drep_activity":{"type":"string","nullable":true,"format":"word64type","description":"DRep activity period. New in 13.2-Conway."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]}},"required":["id","tx_hash","cert_index","parameters"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"}},"required":["stake_address","amount"]},"example":[{"stake_address":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","amount":"454541212442"},{"stake_address":"stake1xx2g2c9dx2nhhehyrezyxpkstoppcqmu9hk63qgfkccw5rqttygt2","amount":"97846969"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the voting transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the voting transaction."},"voter_role":{"type":"string","enum":["constitutional_committee","drep","spo"],"description":"The role of the voter. Can be one of constitutional_committee, drep, spo."},"voter":{"type":"string","description":"The actual voter."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","voter_role","voter","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"voter_role":"drep","voter":"drep1mvdu8slennngja7w4un6knwezufra70887zuxpprd64jxfveahn","vote":"yes"},{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":3,"voter_role":"constitutional_committee","voter":"53a42debdc7ffd90085ab7fd9800b63e6d1c9ac481ba6eb7b6a844e4","vote":"abstain"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/governance/proposals/{gov_action_id}/metadata":{"response":{"200":{"type":"object","properties":{"id":{"type":"string","description":"Governance Action Identifier (CIP-0129)"},"tx_hash":{"type":"string","description":"Off-chain metadata of a proposal with a specific transaction hash"},"cert_index":{"type":"integer","description":"Off-chain metadata of a proposal with a specific transaction cert_index"},"url":{"type":"string","example":"https://abc.xyz/gov.json","description":"URL to the proposal metadata"},"hash":{"type":"string","example":"69c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c\"","description":"Hash of the metadata file"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata (validated CIP-108)"},"bytes":{"type":"string","description":"Content of the metadata (raw)","nullable":true},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]}},"required":["id","tx_hash","cert_index","url","hash","json_metadata","bytes"],"example":{"id":"gov_action1zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygsq6dmejn","tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cert_index":2,"url":"https://raw.githubusercontent.com/carloslodelar/proposals/main/pv10.json","hash":"ffa226f3863aca006172d559cf46bb8b883a47233962ae2fc94c158d7de6fa81","json_metadata":{"body":{"title":"Hardfork to Protocol version 10","abstract":"Let's have sanchoNet in full governance as soon as possible","rationale":"Let's keep testing stuff","motivation":"PV9 is not as fun as PV10","references":[{"uri":"","@type":"Other","label":"Hardfork to PV10"}]},"authors":[{"name":"Carlos","witness":{"publicKey":"7ea09a34aebb13c9841c71397b1cabfec5ddf950405293dee496cac2f437480a","signature":"a476985b4cc0d457f247797611799a6f6a80fc8cb7ec9dcb5a8223888d0618e30de165f3d869c4a0d9107d8a5b612ad7c5e42441907f5b91796f0d7187d64a01","witnessAlgorithm":"ed25519"}}],"@context":{"body":{"@id":"CIP108:body","@context":{"title":"CIP108:title","abstract":"CIP108:abstract","rationale":"CIP108:rationale","motivation":"CIP108:motivation","references":{"@id":"CIP108:references","@context":{"uri":"CIP100:reference-uri","Other":"CIP100:OtherReference","label":"CIP100:reference-label","referenceHash":{"@id":"CIP108:referenceHash","@context":{"hashDigest":"CIP108:hashDigest","hashAlgorithm":"CIP100:hashAlgorithm"}},"GovernanceMetadata":"CIP100:GovernanceMetadataReference"},"@container":"@set"}}},"CIP100":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0100/README.md#","CIP108":"https://github.com/cardano-foundation/CIPs/blob/master/CIP-0108/README.md#","authors":{"@id":"CIP100:authors","@context":{"name":"http://xmlns.com/foaf/0.1/name","witness":{"@id":"CIP100:witness","@context":{"publicKey":"CIP100:publicKey","signature":"CIP100:signature","witnessAlgorithm":"CIP100:witnessAlgorithm"}}},"@container":"@set"},"@language":"en-us","hashAlgorithm":"CIP100:hashAlgorithm"},"hashAlgorithm":"blake2b-256"},"bytes":"\\x7b0a20202240636f6e74657874223a207b0a2020202022406c616e6775616765223a2022656e2d7573222c0a2020202022434950313030223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130302f524541444d452e6d6423222c0a2020202022434950313038223a202268747470733a2f2f6769746875622e636f6d2f63617264616e6f2d666f756e646174696f6e2f434950732f626c6f622f6d61737465722f4349502d303130382f524541444d452e6d6423222c0a202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d222c0a2020202022626f6479223a207b0a20202020202022406964223a20224349503130383a626f6479222c0a2020202020202240636f6e74657874223a207b0a2020202020202020227265666572656e636573223a207b0a2020202020202020202022406964223a20224349503130383a7265666572656e636573222c0a202020202020202020202240636f6e7461696e6572223a202240736574222c0a202020202020202020202240636f6e74657874223a207b0a20202020202020202020202022476f7665726e616e63654d65746164617461223a20224349503130303a476f7665726e616e63654d657461646174615265666572656e6365222c0a202020202020202020202020224f74686572223a20224349503130303a4f746865725265666572656e6365222c0a202020202020202020202020226c6162656c223a20224349503130303a7265666572656e63652d6c6162656c222c0a20202020202020202020202022757269223a20224349503130303a7265666572656e63652d757269222c0a202020202020202020202020227265666572656e636548617368223a207b0a202020202020202020202020202022406964223a20224349503130383a7265666572656e636548617368222c0a20202020202020202020202020202240636f6e74657874223a207b0a202020202020202020202020202020202268617368446967657374223a20224349503130383a68617368446967657374222c0a202020202020202020202020202020202268617368416c676f726974686d223a20224349503130303a68617368416c676f726974686d220a20202020202020202020202020207d0a2020202020202020202020207d0a202020202020202020207d0a20202020202020207d2c0a2020202020202020227469746c65223a20224349503130383a7469746c65222c0a2020202020202020226162737472616374223a20224349503130383a6162737472616374222c0a2020202020202020226d6f7469766174696f6e223a20224349503130383a6d6f7469766174696f6e222c0a202020202020202022726174696f6e616c65223a20224349503130383a726174696f6e616c65220a2020202020207d0a202020207d2c0a2020202022617574686f7273223a207b0a20202020202022406964223a20224349503130303a617574686f7273222c0a2020202020202240636f6e7461696e6572223a202240736574222c0a2020202020202240636f6e74657874223a207b0a2020202020202020226e616d65223a2022687474703a2f2f786d6c6e732e636f6d2f666f61662f302e312f6e616d65222c0a2020202020202020227769746e657373223a207b0a2020202020202020202022406964223a20224349503130303a7769746e657373222c0a202020202020202020202240636f6e74657874223a207b0a202020202020202020202020227769746e657373416c676f726974686d223a20224349503130303a7769746e657373416c676f726974686d222c0a202020202020202020202020227075626c69634b6579223a20224349503130303a7075626c69634b6579222c0a202020202020202020202020227369676e6174757265223a20224349503130303a7369676e6174757265220a202020202020202020207d0a20202020202020207d0a2020202020207d0a202020207d0a20207d2c0a20202268617368416c676f726974686d223a2022626c616b6532622d323536222c0a202022626f6479223a207b0a20202020227469746c65223a202248617264666f726b20746f2050726f746f636f6c2076657273696f6e203130222c0a20202020226162737472616374223a20224c6574277320686176652073616e63686f4e657420696e2066756c6c20676f7665726e616e636520617320736f6f6e20617320706f737369626c65222c0a20202020226d6f7469766174696f6e223a2022505639206973206e6f742061732066756e2061732050563130222c0a2020202022726174696f6e616c65223a20224c65742773206b6565702074657374696e67207374756666222c0a20202020227265666572656e636573223a205b0a2020202020207b0a2020202020202020224074797065223a20224f74686572222c0a2020202020202020226c6162656c223a202248617264666f726b20746f2050563130222c0a202020202020202022757269223a2022220a2020202020207d0a202020205d0a20207d2c0a202022617574686f7273223a205b0a202020207b0a202020202020226e616d65223a20224361726c6f73222c0a202020202020227769746e657373223a207b0a2020202020202020227769746e657373416c676f726974686d223a202265643235353139222c0a2020202020202020227075626c69634b6579223a202237656130396133346165626231336339383431633731333937623163616266656335646466393530343035323933646565343936636163326634333734383061222c0a2020202020202020227369676e6174757265223a20226134373639383562346363306434353766323437373937363131373939613666366138306663386362376563396463623561383232333838386430363138653330646531363566336438363963346130643931303764386135623631326164376335653432343431393037663562393137393666306437313837643634613031220a2020202020207d0a202020207d0a20205d0a7d"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"gov_action_id":{"type":"string"}}}},"/epochs/latest":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/latest/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/epochs/{number}":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/next":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/previous":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"start_time":{"type":"integer","example":1603403091,"description":"Unix time of the start of the epoch"},"end_time":{"type":"integer","example":1603835086,"description":"Unix time of the end of the epoch"},"first_block_time":{"type":"integer","example":1603403092,"description":"Unix time of the first block of the epoch"},"last_block_time":{"type":"integer","example":1603835084,"description":"Unix time of the last block of the epoch"},"block_count":{"type":"integer","example":21298,"description":"Number of blocks within the epoch"},"tx_count":{"type":"integer","example":17856,"description":"Number of transactions within the epoch"},"output":{"type":"string","example":"7849943934049314","description":"Sum of all the transactions within the epoch in Lovelaces"},"fees":{"type":"string","example":"4203312194","description":"Sum of all the fees within the epoch in Lovelaces"},"active_stake":{"type":"string","nullable":true,"example":"784953934049314","description":"Sum of all the active stakes within the epoch in Lovelaces"}},"required":["epoch","start_time","end_time","first_block_time","last_block_time","block_count","tx_count","output","fees","active_stake"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 prefix of the pool delegated to"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","pool_id","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/stakes/{pool_id}":{"response":{"200":{"type":"array","items":{"properties":{"stake_address":{"type":"string","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk","description":"Stake address"},"amount":{"type":"string","example":"4440295078","description":"Amount of active delegated stake in Lovelaces"}},"required":["stake_address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/epochs/{number}/blocks/{pool_id}":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the block"},"example":["d0fa315687e99ccdc96b14cc2ea74a767405d64427b648c470731a9b69e4606e","38bc6efb92a830a0ed22a64f979d120d26483fd3c811f6622a8c62175f530878","f3258fcd8b975c061b4fcdcfcbb438807134d6961ec278c200151274893b6b7d"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"number":{"type":"integer"},"pool_id":{"type":"string"}}}},"/epochs/{number}/parameters":{"response":{"200":{"type":"object","properties":{"epoch":{"type":"integer","example":225,"description":"Epoch number"},"min_fee_a":{"type":"integer","example":44,"description":"The linear factor for the minimum fee calculation for given epoch"},"min_fee_b":{"type":"integer","example":155381,"description":"The constant factor for the minimum fee calculation"},"max_block_size":{"type":"integer","example":65536,"description":"Maximum block body size in Bytes"},"max_tx_size":{"type":"integer","example":16384,"description":"Maximum transaction size"},"max_block_header_size":{"type":"integer","example":1100,"description":"Maximum block header size"},"key_deposit":{"type":"string","example":"2000000","description":"The amount of a key registration deposit in Lovelaces"},"pool_deposit":{"type":"string","example":"500000000","description":"The amount of a pool registration deposit in Lovelaces"},"e_max":{"type":"integer","example":18,"description":"Epoch bound on pool retirement"},"n_opt":{"type":"integer","example":150,"description":"Desired number of pools"},"a0":{"type":"number","example":0.3,"description":"Pool pledge influence"},"rho":{"type":"number","example":0.003,"description":"Monetary expansion"},"tau":{"type":"number","example":0.2,"description":"Treasury expansion"},"decentralisation_param":{"type":"number","example":0.5,"description":"Percentage of blocks produced by federated nodes"},"extra_entropy":{"type":"string","nullable":true,"example":null,"description":"Seed for extra entropy"},"protocol_major_ver":{"type":"integer","example":2,"description":"Accepted protocol major version"},"protocol_minor_ver":{"type":"integer","example":0,"description":"Accepted protocol minor version"},"min_utxo":{"type":"string","example":"1000000","description":"Minimum UTXO value. Use `coins_per_utxo_size` for Alonzo and later eras","deprecated":true},"min_pool_cost":{"type":"string","example":"340000000","description":"Minimum stake cost forced on the pool"},"nonce":{"type":"string","example":"1a3be38bcbb7911969283716ad7aa550250226b76a61fc51cc9a9a35d9276d81","description":"Epoch number only used once"},"cost_models":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0},"PlutusV2":{"addInteger-cpu-arguments-intercept":197209,"addInteger-cpu-arguments-slope":0}},"description":"Cost models parameters for Plutus Core scripts"},"cost_models_raw":{"additionalProperties":true,"type":"object","nullable":true,"example":{"PlutusV1":[197209,0],"PlutusV2":[197209,0]},"description":"Cost models parameters for Plutus Core scripts in raw list form"},"price_mem":{"type":"number","nullable":true,"example":0.0577,"description":"The per word cost of script memory usage"},"price_step":{"type":"number","nullable":true,"example":0.0000721,"description":"The cost of script execution step usage"},"max_tx_ex_mem":{"type":"string","nullable":true,"example":"10000000","description":"The maximum number of execution memory allowed to be used in a single transaction"},"max_tx_ex_steps":{"type":"string","nullable":true,"example":"10000000000","description":"The maximum number of execution steps allowed to be used in a single transaction"},"max_block_ex_mem":{"type":"string","nullable":true,"example":"50000000","description":"The maximum number of execution memory allowed to be used in a single block"},"max_block_ex_steps":{"type":"string","nullable":true,"example":"40000000000","description":"The maximum number of execution steps allowed to be used in a single block"},"max_val_size":{"type":"string","nullable":true,"example":"5000","description":"The maximum Val size"},"collateral_percent":{"type":"integer","nullable":true,"example":150,"description":"The percentage of the transactions fee which must be provided as collateral when including non-native scripts"},"max_collateral_inputs":{"type":"integer","nullable":true,"example":3,"description":"The maximum number of collateral inputs allowed in a transaction"},"coins_per_utxo_size":{"type":"string","nullable":true,"example":"34482","description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"coins_per_utxo_word":{"type":"string","nullable":true,"example":"34482","deprecated":true,"description":"Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."},"pvt_motion_no_confidence":{"type":"number","nullable":true,"description":"Pool Voting threshold for motion of no-confidence."},"pvt_committee_normal":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (normal state)."},"pvt_committee_no_confidence":{"nullable":true,"type":"number","description":"Pool Voting threshold for new committee/threshold (state of no-confidence)."},"pvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"Pool Voting threshold for hard-fork initiation."},"dvt_motion_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for motion of no-confidence."},"dvt_committee_normal":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (normal state)."},"dvt_committee_no_confidence":{"nullable":true,"type":"number","description":"DRep Vote threshold for new committee/threshold (state of no-confidence)."},"dvt_update_to_constitution":{"nullable":true,"type":"number","description":"DRep Vote threshold for update to the Constitution."},"dvt_hard_fork_initiation":{"nullable":true,"type":"number","description":"DRep Vote threshold for hard-fork initiation."},"dvt_p_p_network_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, network group."},"dvt_p_p_economic_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, economic group."},"dvt_p_p_technical_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, technical group."},"dvt_p_p_gov_group":{"nullable":true,"type":"number","description":"DRep Vote threshold for protocol parameter changes, governance group."},"dvt_treasury_withdrawal":{"nullable":true,"type":"number","description":"DRep Vote threshold for treasury withdrawal."},"committee_min_size":{"type":"string","nullable":true,"description":"Minimal constitutional committee size."},"committee_max_term_length":{"type":"string","nullable":true,"description":"Constitutional committee term limits."},"gov_action_lifetime":{"type":"string","nullable":true,"description":"Governance action expiration."},"gov_action_deposit":{"type":"string","nullable":true,"description":"Governance action deposit."},"drep_deposit":{"type":"string","nullable":true,"description":"DRep deposit amount."},"drep_activity":{"type":"string","nullable":true,"description":"DRep activity period."},"pvtpp_security_group":{"type":"number","nullable":true,"deprecated":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."},"pvt_p_p_security_group":{"type":"number","nullable":true,"description":"Pool Voting threshold for security-relevant protocol parameters changes."},"min_fee_ref_script_cost_per_byte":{"type":"number","nullable":true}},"required":["epoch","min_fee_a","min_fee_b","max_block_size","max_tx_size","max_block_header_size","key_deposit","pool_deposit","e_max","n_opt","a0","rho","tau","decentralisation_param","extra_entropy","protocol_major_ver","protocol_minor_ver","min_utxo","min_pool_cost","nonce","cost_models","price_mem","price_step","max_tx_ex_mem","max_tx_ex_steps","max_block_ex_mem","max_block_ex_steps","max_val_size","collateral_percent","max_collateral_inputs","coins_per_utxo_size","coins_per_utxo_word","pvt_motion_no_confidence","pvt_committee_normal","pvt_committee_no_confidence","pvt_hard_fork_initiation","dvt_motion_no_confidence","dvt_committee_normal","dvt_committee_no_confidence","dvt_update_to_constitution","dvt_hard_fork_initiation","dvt_p_p_network_group","dvt_p_p_economic_group","dvt_p_p_technical_group","dvt_p_p_gov_group","dvt_treasury_withdrawal","committee_min_size","committee_max_term_length","gov_action_lifetime","gov_action_deposit","drep_deposit","drep_activity","pvtpp_security_group","pvt_p_p_security_group","min_fee_ref_script_cost_per_byte"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"number":{"type":"integer"}}}},"/txs/{hash}":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"block":{"type":"string","example":"356b7d7dbb696ccd12775c016941057a9dc70898d87a63fc752271bb46856940","description":"Block hash"},"block_height":{"type":"integer","example":123456,"description":"Block number"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"},"slot":{"type":"integer","example":42000000,"description":"Slot number"},"index":{"type":"integer","example":1,"description":"Transaction index within the block"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"},"treasury_donation":{"type":"string","example":"0","description":"Treasury donation in Lovelaces"}},"required":["hash","block","block_height","block_time","slot","index","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract","treasury_donation"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/utxos":{"response":{"200":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the input","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["address","amount","tx_hash","output_index","data_hash","inline_datum","reference_script_hash","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},"consumed_by_tx":{"type":"string","nullable":true,"description":"Transaction hash that consumed the UTXO or null for unconsumed UTXOs. Always null for collateral outputs.","example":"66c29b56952f6085afac3b0632d781af78d020b080063bcfd6c54b8e2b8fed41"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}}},"required":["hash","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/stakes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9t3a0tcwune5xrnfjg4q7cpvjlgx9lcv0cuqf5mhfjwrvcwrulda","description":"Delegation stake address"},"registration":{"type":"boolean","example":true,"description":"Registration boolean, false if deregistration"}},"required":["cert_index","address","registration"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction","deprecated":true},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 delegation stake address"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 ID of delegated stake pool"},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"}},"required":["index","cert_index","address","pool_id","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 withdrawal address"},"amount":{"type":"string","example":"431833601","description":"Withdrawal amount in Lovelaces"}},"required":["address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pot":{"type":"string","enum":["reserve","treasury"],"example":"reserve","description":"Source of MIR funds"},"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"address":{"type":"string","example":"stake1u9r76ypf5fskppa0cmttas05cgcswrttn6jrq4yd7jpdnvc7gt0yc","description":"Bech32 stake address"},"amount":{"type":"string","example":"431833601","description":"MIR amount in Lovelaces"}},"required":["pot","cert_index","address","amount"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 encoded pool ID"},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge in Lovelaces"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool in Lovelaces"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]},"relays":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the update becomes active"}},"required":["cert_index","pool_id","vrf_key","pledge","margin_cost","fixed_cost","reward_account","owners","metadata","relays","active_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/pool_retires":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"cert_index":{"type":"integer","example":0,"description":"Index of the certificate within the transaction"},"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 stake pool ID"},"retiring_epoch":{"type":"integer","example":216,"description":"Epoch in which the pool becomes retired"}},"required":["cert_index","pool_id","retiring_epoch"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"json_metadata":{}},"required":["label","json_metadata"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/metadata/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["label","cbor_metadata","metadata"]},"example":[{"label":"1968","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"script_hash":{"type":"string","example":"ec26b89af41bef0f7585353831cb5da42b5b37185e0c8a526143b824","description":"Script hash"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Redeemer data hash"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","deprecated":true,"description":"Datum hash"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_index","purpose","unit_mem","unit_steps","script_hash","redeemer_data_hash","datum_hash","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/required_signers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"witness_hash":{"type":"string","example":"d52e11f3e48436dd42dbec6d88c239732e503b8b7a32af58e5f87625","description":"Hash of the witness"}},"required":["witness_hash"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/txs/{hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized transaction"}},"required":["cbor"],"example":{"cbor":"84a40081825820203e5b61e0949ffc8fe594727cf7ed73c7396cc2bd212af9a680c9423b5880eb00018282583900f0c60254ecb0addd4c7e40c28fd05b65014ab4c8ecece06c7dcee5a0724bf93336a8225e7ef152b41aea955173be91af19250edea1ddafab1a000f42408258390014beadb876d0a2a593fe2f1b539389e00731290910170e9a1be78e847d2ccdc7af469706878018739bcfde9ae23f009c4ae38aee0a4b4f3a1b0000000253fa0f93021a0002922d031a0303c827a100818258207d3ae39f9a1c916ac7c13f10c7d67c70b870c286a1af71485455c5022a3f391d5840e2f481acd1601a3f39fa976317bba685ddd774621a92611edaaa3df9f48a3b13d8b25ecb2f28b031c1602512418efed3033e463a0dcd22a856c808033cc9e00ff5f6"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/tx/submit":{"response":{"200":{"type":"string","format":"hex","minLength":64,"maxLength":64,"example":"d1662b24fa9fe985fc2dce47455df399cb2e31e1e1819339e885801cc3578908"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/accounts/{stake_address}":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Bech32 stake address"},"active":{"type":"boolean","example":true,"description":"Delegation state of the account. **Note:** For registration state, use the `registered` field instead."},"registered":{"type":"boolean","example":true,"description":"Registration state of an account"},"active_epoch":{"type":"integer","nullable":true,"example":412,"description":"Epoch of the most recent action - registration or deregistration"},"controlled_amount":{"type":"string","example":"619154618165","description":"Balance of the account in Lovelaces"},"rewards_sum":{"type":"string","example":"319154618165","description":"Sum of all rewards for the account in the Lovelaces"},"withdrawals_sum":{"type":"string","example":"12125369253","description":"Sum of all the withdrawals for the account in Lovelaces"},"reserves_sum":{"type":"string","example":"319154618165","description":"Sum of all  funds from reserves for the account in the Lovelaces"},"treasury_sum":{"type":"string","example":"12000000","description":"Sum of all funds from treasury for the account in the Lovelaces"},"withdrawable_amount":{"type":"string","example":"319154618165","description":"Sum of available rewards that haven't been withdrawn yet for the account in the Lovelaces"},"pool_id":{"type":"string","nullable":true,"example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID to which this account is delegated"},"drep_id":{"type":"string","nullable":true,"example":"drep15cfxz9exyn5rx0807zvxfrvslrjqfchrd4d47kv9e0f46uedqtc","description":"Bech32 drep ID to which this account is delegated"}},"required":["stake_address","active","registered","active_epoch","controlled_amount","rewards_sum","withdrawals_sum","reserves_sum","treasury_sum","withdrawable_amount","pool_id","drep_id"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/rewards":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","description":"Epoch of the associated reward"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 pool ID being delegated to"},"type":{"type":"string","enum":["leader","member","pool_deposit_refund"],"description":"Type of the reward"}},"required":["epoch","amount","pool_id","type"]},"example":[{"epoch":215,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":216,"amount":"3586329","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":217,"amount":"1337","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"leader"},{"epoch":218,"amount":"1395265","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","type":"member"},{"epoch":218,"amount":"500000000","pool_id":"pool1cytwr0n7eas6du2h2xshl8ypa1yqr18f0erlhhjcuczysiunjcs","type":"pool_deposit_refund"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the stake was active"},"amount":{"type":"string","description":"Stake amount in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"}},"required":["active_epoch","amount","pool_id"]},"example":[{"active_epoch":210,"amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"},{"active_epoch":211,"amount":"22695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/delegations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"active_epoch":{"type":"integer","example":210,"description":"Epoch in which the delegation becomes active"},"tx_hash":{"type":"string","description":"Hash of the transaction containing the delegation"},"amount":{"type":"string","description":"Rewards for given epoch in Lovelaces"},"pool_id":{"type":"string","description":"Bech32 ID of pool being delegated to"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the delegation"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the delegation"},"block_height":{"type":"integer","description":"Block height of the transaction containing the delegation"}},"required":["active_epoch","tx_hash","amount","pool_id","tx_slot","block_time","block_height"]},"example":[{"active_epoch":210,"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"12695385","pool_id":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"active_epoch":242,"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"12691385","pool_id":"pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/registrations":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the (de)registration certificate"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the (de)registration certificate"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the (de)registration certificate"},"block_height":{"type":"integer","description":"Block height of the transaction containing the (de)registration certificate"}},"required":["tx_hash","action","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","action":"registered","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","action":"deregistered","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/withdrawals":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the withdrawal"},"amount":{"type":"string","description":"Withdrawal amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the withdrawal"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the withdrawal"},"block_height":{"type":"integer","description":"Block height of the transaction containing the withdrawal"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5","amount":"454541212442","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34","amount":"97846969","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/mirs":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the MIR"},"amount":{"type":"string","description":"MIR amount in Lovelaces"},"tx_slot":{"type":"integer","description":"Slot of the transaction containing the MIR"},"block_time":{"type":"integer","description":"Block creation time in UNIX time of the transaction containing the MIR"},"block_height":{"type":"integer","description":"Block height of the transaction containing the MIR"}},"required":["tx_hash","amount","tx_slot","block_time","block_height"]},"example":[{"tx_hash":"69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d","amount":"2193707473","tx_slot":45093580,"block_time":1646437200,"block_height":6745358},{"tx_hash":"baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13","amount":"14520198574","tx_slot":48093580,"block_time":1649033600,"block_height":7126896}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address associated with the stake key"}},"required":["address"]},"example":[{"address":"addr1qx2kd28nq8ac5prwg32hhvudlwggpgfp8utlyqxu6wqgz62f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sy0f4qd"},{"address":"addr1qys3czp8s9thc6u2fqed9yq3h24nyw28uk0m6mkgn9dkckjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9suth4w4"},{"address":"addr1q8j55h253zcvl326sk5qdt2n8z7eghzspe0ekxgncr796s2f79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sjmd35m"},{"address":"addr1q8f7gxrprank3drhx8k5grlux7ene0nlwun8y9thu8mc3yjf79qsdmm5dsknt9ecr5w468r9ey0fxwkdrwh08ly3tu9sls6vnt"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/assets":{"response":{"200":{"type":"array","items":{"type":"object","description":"The sum of all assets of all addresses associated with a given account","properties":{"unit":{"type":"string","format":"Concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"d5e6bf0500378d4f0da4e8dde6becec7621cd8cbf5cbb9b87013d4cc537061636542756433343132","quantity":"1"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"125"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/addresses/total":{"response":{"200":{"type":"object","properties":{"stake_address":{"type":"string","description":"Bech32 encoded stake address","example":"stake1u9l5q5jwgelgagzyt6nuaasefgmn8pd25c8e9qpeprq0tdcp0e3uk"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset for all addresses associated with the account","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions for all addresses associated with the account"}},"required":["stake_address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/accounts/{stake_address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 address"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["address","tx_hash","tx_index","block_height","block_time"]},"example":[{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"bd78e0e73fb1691f08746a331bd764d11552c3a36ef766d4f1a3bbdc7f29918d","tx_index":34,"block_height":7900364,"block_time":1666114079},{"address":"addr1q8zsjx7vxkl4esfejafhxthyew8c54c9ch95gkv3nz37sxrc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgq3jd3w2","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180},{"address":"addr1qxrrzqsqnzqx3p8sxxsry936h6c78ml4rdl224f33l7pmcnc9ty742qncmffaesxqarvqjmxmy36d9aht2duhmhvekgqr735lq","tx_hash":"67e9a201bc08a92bcc6f447a4ed032300d933545ccd7f1da94ec1e8dbeb4a696","tx_index":6,"block_height":7900557,"block_time":1666118180}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"stake_address":{"type":"string"}}}},"/mempool":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/mempool/{hash}":{"response":{"200":{"type":"object","properties":{"tx":{"type":"object","properties":{"hash":{"type":"string","example":"1e043f100dce12d107f679685acd2fc0610e10f72a92d412794c9773d11d8477","description":"Transaction hash"},"output_amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"fees":{"type":"string","example":"182485","description":"Fees of the transaction in Lovelaces"},"deposit":{"type":"string","example":"0","description":"Deposit within the transaction in Lovelaces"},"size":{"type":"integer","example":433,"description":"Size of the transaction in Bytes"},"invalid_before":{"type":"string","nullable":true,"example":null,"description":"Left (included) endpoint of the timelock validity intervals"},"invalid_hereafter":{"type":"string","nullable":true,"example":"13885913","description":"Right (excluded) endpoint of the timelock validity intervals"},"utxo_count":{"type":"integer","example":4,"description":"Count of UTXOs within the transaction"},"withdrawal_count":{"type":"integer","example":0,"description":"Count of the withdrawals within the transaction"},"mir_cert_count":{"type":"integer","example":0,"description":"Count of the MIR certificates within the transaction"},"delegation_count":{"type":"integer","example":0,"description":"Count of the delegations within the transaction"},"stake_cert_count":{"type":"integer","example":0,"description":"Count of the stake keys (de)registration within the transaction"},"pool_update_count":{"type":"integer","example":0,"description":"Count of the stake pool registration and update certificates within the transaction"},"pool_retire_count":{"type":"integer","example":0,"description":"Count of the stake pool retirement certificates within the transaction"},"asset_mint_or_burn_count":{"type":"integer","example":0,"description":"Count of asset mints and burns within the transaction"},"redeemer_count":{"type":"integer","example":0,"description":"Count of redeemers within the transaction"},"valid_contract":{"type":"boolean","example":true,"description":"True if contract script passed validation"}},"required":["hash","output_amount","fees","deposit","size","invalid_before","invalid_hereafter","utxo_count","withdrawal_count","mir_cert_count","delegation_count","stake_cert_count","pool_update_count","pool_retire_count","asset_mint_or_burn_count","redeemer_count","valid_contract"]},"inputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Input address"},"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the UTXO transaction"},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"collateral":{"type":"boolean","example":false,"description":"Whether the input is a collateral consumed on script validation failure"},"reference":{"type":"boolean","example":false,"description":"Whether the input is a reference transaction input"}},"required":["tx_hash","output_index","collateral"]}},"outputs":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","example":"addr1q9ld26v2lv8wvrxxmvg90pn8n8n5k6tdst06q2s856rwmvnueldzuuqmnsye359fqrk8hwvenjnqultn7djtrlft7jnq7dy7wv","description":"Output address"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"output_index":{"type":"integer","example":0,"description":"UTXO index in the transaction"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum","example":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"collateral":{"type":"boolean","example":false,"description":"Whether the output is a collateral output"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","amount","output_index","data_hash","inline_datum","collateral","reference_script_hash"]}},"redeemers":{"type":"array","items":{"type":"object","properties":{"tx_index":{"type":"integer","example":0,"description":"Index of the redeemer within the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"}},"required":["tx_index","purpose","unit_mem","unit_steps"]}}},"required":["tx","inputs","outputs"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"hash":{"type":"string"}}}},"/mempool/addresses/{address}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"}},"required":["tx_hash"]},"example":[{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/metadata/txs/labels":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"Metadata label"},"cip10":{"type":"string","nullable":true,"description":"CIP10 defined description"},"count":{"type":"string","description":"The count of metadata entries with a specific label"}},"required":["label","cip10","count"]},"example":[{"label":"1990","cip10":null,"count":"1"},{"label":"1967","cip10":"nut.link metadata oracles registry","count":"3"},{"label":"1968","cip10":"nut.link metadata oracles data points","count":"16321"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/metadata/txs/labels/{label}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"json_metadata":{"anyOf":[{"type":"string"},{"type":"object","additionalProperties":true},{"type":"array","items":{}},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"type":"null"}],"description":"Content of the JSON metadata"}},"required":["tx_hash","json_metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","json_metadata":{"ADAUSD":[{"value":"0.10409800535729975","source":"ergoOracles"}]}},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","json_metadata":{"ADAUSD":[{"value":"0.15409850555139935","source":"ergoOracles"}]}},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","json_metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/metadata/txs/labels/{label}/cbor":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction hash that contains the specific metadata"},"cbor_metadata":{"deprecated":true,"type":"string","nullable":true,"description":"Content of the CBOR metadata"},"metadata":{"type":"string","nullable":true,"description":"Content of the CBOR metadata in hex"}},"required":["tx_hash","cbor_metadata","metadata"]},"example":[{"tx_hash":"257d75c8ddb0434e9b63e29ebb6241add2b835a307aa33aedba2effe09ed4ec8","cbor_metadata":null,"metadata":null},{"tx_hash":"e865f2cc01ca7381cf98dcdc4de07a5e8674b8ea16e6a18e3ed60c186fde2b9c","cbor_metadata":null,"metadata":null},{"tx_hash":"4237501da3cfdd53ade91e8911e764bd0699d88fd43b12f44a1f459b89bc91be","cbor_metadata":"\\xa100a16b436f6d62696e6174696f6e8601010101010c","metadata":"a100a16b436f6d62696e6174696f6e8601010101010c"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"label":{"type":"string"}}}},"/addresses/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/extended":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"},"decimals":{"type":"integer","nullable":true,"description":"Number of decimal places of the asset unit. Primary data source is CIP68 reference NFT with a fallback to off-chain metadata."},"has_nft_onchain_metadata":{"type":"boolean","description":"True if the latest minting transaction includes metadata (best-effort)"}},"required":["unit","quantity","decimals","has_nft_onchain_metadata"]},"example":[{"unit":"lovelace","quantity":"42000000","decimals":6,"has_nft_onchain_metadata":false},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12","decimals":null,"has_nft_onchain_metadata":true}]},"stake_address":{"type":"string","nullable":true,"example":"stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7","description":"Stake address that controls the key"},"type":{"type":"string","enum":["byron","shelley"],"example":"shelley","description":"Address era"},"script":{"type":"boolean","example":false,"description":"True if this is a script address"}},"required":["address","amount","stake_address","type","script"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/total":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"received_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"sent_sum":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]},"example":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}]},"tx_count":{"type":"integer","example":12,"description":"Count of all transactions on the address"}},"required":["address","received_sum","sent_sum","tx_count"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/utxos/{asset}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded addresses - useful when querying by payment_cred","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"tx_hash":{"type":"string","description":"Transaction hash of the UTXO"},"tx_index":{"type":"integer","deprecated":true,"description":"UTXO index in the transaction"},"output_index":{"type":"integer","description":"UTXO index in the transaction"},"amount":{"type":"array","items":{"type":"object","description":"The sum of all the UTXO per asset","properties":{"unit":{"type":"string","format":"Lovelace or concatenation of asset policy_id and hex-encoded asset_name","description":"The unit of the value"},"quantity":{"type":"string","description":"The quantity of the unit"}},"required":["unit","quantity"]}},"block":{"type":"string","description":"Block hash of the UTXO"},"data_hash":{"type":"string","nullable":true,"description":"The hash of the transaction output datum"},"inline_datum":{"type":"string","nullable":true,"description":"CBOR encoded inline datum","example":"19a6aa"},"reference_script_hash":{"type":"string","nullable":true,"description":"The hash of the reference script of the output","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"}},"required":["address","tx_hash","tx_index","output_index","amount","block","data_hash","inline_datum","reference_script_hash"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"39a7a284c2a0948189dc45dec670211cd4d72f7b66c5726c08d9b3df11e44d58","output_index":0,"amount":[{"unit":"lovelace","quantity":"42000000"}],"block":"7eb8e27d18686c7db9a18f8bbcfe34e3fed6e047afaa2d969904d15e934847e6","data_hash":"9e478573ab81ea7a8e31891ce0648b81229f408d596a3483e6f4f9b92d3cf710","inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"4c4e67bafa15e742c13c592b65c8f74c769cd7d9af04c848099672d1ba391b49","output_index":0,"amount":[{"unit":"lovelace","quantity":"729235000"}],"block":"953f1b80eb7c11a7ffcd67cbd4fde66e824a451aca5a4065725e5174b81685b7","data_hash":null,"inline_datum":null,"reference_script_hash":null},{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","tx_hash":"768c63e27a1c816a83dc7b07e78af673b2400de8849ea7e7b734ae1333d100d2","output_index":1,"amount":[{"unit":"lovelace","quantity":"42000000"},{"unit":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"12"}],"block":"5c571f83fe6c784d3fbc223792627ccf0eea96773100f9aedecf8b1eda4544d7","data_hash":null,"inline_datum":null,"reference_script_hash":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"},"asset":{"type":"string"}}}},"/addresses/{address}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/addresses/{address}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"from":{"type":"string"},"to":{"type":"string"}}},"params":{"type":"object","properties":{"address":{"type":"string"}}}},"/pools":{"response":{"200":{"type":"array","items":{"type":"string","description":"Bech32 encoded pool ID"},"example":["pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","pool1hn7hlwrschqykupwwrtdfkvt2u4uaxvsgxyh6z63703p2knj288","pool1ztjyjfsh432eqetadf82uwuxklh28xc85zcphpwq6mmezavzad2"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/extended":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"active_stake":{"type":"string","example":"4200000000","description":"Active delegated amount"},"live_stake":{"type":"string","example":"6900000000","description":"Currently delegated amount"},"live_saturation":{"type":"number","example":0.93},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","nullable":true,"properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["url","hash","ticker","name","description","homepage"]}},"required":["pool_id","hex","active_stake","live_stake","blocks_minted","live_saturation","declared_pledge","margin_cost","fixed_cost","metadata"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","hex":"2f355f79ee007502d116ecb07e36f985b34cebf2d84118f5c6b455a1","active_stake":"1541200000","live_stake":"1541400000","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":{"type":"object","properties":{"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}}}},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","hex":"6b3fda88053dc2cee18a7c2736f032182fcc78a2fe912e869aa4edcd","active_stake":"22200000","live_stake":"48955550","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","hex":"73318ec975cf1125a6367cbb1c9a406cbcb3e510e49d7c3aab14aa31","active_stake":"9989541215","live_stake":"168445464878","blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"live_saturation":{"type":"number","example":0.93},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"metadata":null}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retired":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/retiring":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1z5uqdk7dzdxaae5633fqfcu2eqzy3a3rgtuvy087fdld7yws0xt","description":"Bech32 encoded pool ID"},"epoch":{"type":"integer","example":242,"description":"Retirement epoch number"}},"required":["pool_id","epoch"]},"example":[{"pool_id":"pool19u64770wqp6s95gkajc8udheske5e6ljmpq33awxk326zjaza0q","epoch":225},{"pool_id":"pool1dvla4zq98hpvacv20snndupjrqhuc79zl6gjap565nku6et5zdx","epoch":215},{"pool_id":"pool1wvccajt4eugjtf3k0ja3exjqdj7t8egsujwhcw4tzj4rzsxzw5w","epoch":231}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/pools/{pool_id}":{"response":{"200":{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID."},"vrf_key":{"type":"string","example":"0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233","description":"VRF key hash"},"blocks_minted":{"type":"integer","example":69,"description":"Total minted blocks"},"blocks_epoch":{"type":"integer","example":4,"description":"Number of blocks minted in the current epoch"},"live_stake":{"type":"string","example":"6900000000"},"live_size":{"type":"number","example":0.42},"live_saturation":{"type":"number","example":0.93},"live_delegators":{"type":"number","example":127},"active_stake":{"type":"string","example":"4200000000"},"active_size":{"type":"number","example":0.43},"declared_pledge":{"type":"string","example":"5000000000","description":"Stake pool certificate pledge"},"live_pledge":{"type":"string","example":"5000000001","description":"Stake pool current pledge"},"margin_cost":{"type":"number","example":0.05,"description":"Margin tax cost of the stake pool"},"fixed_cost":{"type":"string","example":"340000000","description":"Fixed tax cost of the stake pool"},"reward_account":{"type":"string","example":"stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f","description":"Bech32 reward account of the stake pool"},"owners":{"type":"array","items":{"type":"string","description":"Bech32 accounts of the pool owners"},"example":["stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"]},"registration":{"type":"array","items":{"type":"string","description":"Hash of the transaction including registration"},"example":["9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc","7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95","3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9"]},"retirement":{"type":"array","items":{"type":"string","description":"Hash of the transaction including retirement","example":"252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8"}},"calidus_key":{"type":"object","nullable":true,"description":"Last valid Calidus key for the pool","properties":{"id":{"type":"string","example":"calidus15yt3nqapz799tvp2lt8adttt29k6xa2xnltahn655tu4sgcph42p7","description":"A Bech32-encoded identifier derived from the calidus public key"},"pub_key":{"type":"string","example":"57758911253f6b31df2a87c10eb08a2c9b8450768cb8dd0d378d93f7c2e220f0","description":"The raw hexadecimal-encoded calidus public key used for verification purposes"},"nonce":{"type":"integer","example":149292000,"description":"A unique number used once to prevent replay attacks and ensure the uniqueness of the key registration"},"tx_hash":{"type":"string","example":"f45ed21c6bc1832cf7f11f4bd6ee47ca9684b4f6f8ff8a398aa2df065eac0ba8","description":"The transaction hash that submitted the Calidus key registration"},"block_height":{"type":"integer","example":11548408,"description":"The block height at which this key registration was recorded"},"block_time":{"type":"integer","example":1740858988,"description":"Block time of the key registration"},"epoch":{"type":"integer","example":543,"description":"Epoch number of the key registration"}},"required":["id","pub_key","nonce","tx_hash","block_height","block_time","epoch"]}},"required":["pool_id","hex","vrf_key","blocks_minted","blocks_epoch","live_stake","live_size","live_saturation","live_delegators","active_stake","active_size","declared_pledge","live_pledge","margin_cost","fixed_cost","reward_account","owners","registration","retirement","calidus_key"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"epoch":{"type":"integer","example":233,"description":"Epoch number"},"blocks":{"type":"integer","example":22,"description":"Number of blocks created by pool"},"active_stake":{"type":"string","example":"20485965693569","description":"Active (Snapshot of live stake 2 epochs ago) stake in Lovelaces"},"active_size":{"type":"number","example":1.2345,"description":"Pool size (percentage) of overall active stake at that epoch"},"delegators_count":{"type":"integer","example":115,"description":"Number of delegators for epoch"},"rewards":{"type":"string","example":"206936253674159","description":"Total rewards received before distribution to delegators"},"fees":{"type":"string","example":"1290968354","description":"Pool operator rewards"}},"required":["epoch","blocks","active_stake","active_size","delegators_count","rewards","fees"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/metadata":{"response":{"200":{"anyOf":[{"type":"object","properties":{"pool_id":{"type":"string","example":"pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy","description":"Bech32 pool ID"},"hex":{"type":"string","example":"0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735","description":"Hexadecimal pool ID"},"url":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"URL to the stake pool metadata"},"hash":{"type":"string","nullable":true,"example":"47c0c68cb57f4a5b4a87bad896fc274678e7aea98e200fa14a1cb40c0cab1d8c","description":"Hash of the metadata file"},"error":{"type":"object","description":"Present when metadata could not be fetched or validated.","properties":{"code":{"type":"string","description":"Stable machine-readable error code.","enum":["HASH_MISMATCH","CONNECTION_ERROR","HTTP_RESPONSE_ERROR","DECODE_ERROR","SIZE_EXCEEDED","UNKNOWN_ERROR"]},"message":{"type":"string","description":"Human-readable description of the error."}},"required":["code","message"]},"ticker":{"type":"string","nullable":true,"example":"NUTS","description":"Ticker of the stake pool"},"name":{"type":"string","nullable":true,"example":"Stake Nuts","description":"Name of the stake pool"},"description":{"type":"string","nullable":true,"example":"The best pool ever","description":"Description of the stake pool"},"homepage":{"type":"string","nullable":true,"example":"https://stakentus.com/","description":"Home page of the stake pool"}},"required":["pool_id","hex","url","hash","ticker","name","description","homepage"]},{"type":"object"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/relays":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"ipv4":{"type":"string","nullable":true,"example":"4.4.4.4","description":"IPv4 address of the relay"},"ipv6":{"type":"string","nullable":true,"example":"https://stakenuts.com/mainnet.json","description":"IPv6 address of the relay"},"dns":{"type":"string","nullable":true,"example":"relay1.stakenuts.com","description":"DNS name of the relay"},"dns_srv":{"type":"string","nullable":true,"example":"_relays._tcp.relays.stakenuts.com","description":"DNS SRV entry of the relay"},"port":{"type":"integer","example":3001,"description":"Network port of the relay"}},"required":["ipv4","ipv6","dns","dns_srv","port"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/delegators":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded stake addresses"},"live_stake":{"type":"string","description":"Currently delegated amount"}},"required":["address","live_stake"]},"example":[{"address":"stake1ux4vspfvwuus9uwyp5p3f0ky7a30jq5j80jxse0fr7pa56sgn8kha","live_stake":"1137959159981411"},{"address":"stake1uylayej7esmarzd4mk4aru37zh9yz0luj3g9fsvgpfaxulq564r5u","live_stake":"16958865648"},{"address":"stake1u8lr2pnrgf8f7vrs9lt79hc3sxm8s2w4rwvgpncks3axx6q93d4ck","live_stake":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/blocks":{"response":{"200":{"type":"array","items":{"type":"string","description":"Block hashes"},"example":["d8982ca42cfe76b747cc681d35d671050a9e41e9cfe26573eb214e94fe6ff21d","026436c539e2ce84c7f77ffe669f4e4bbbb3b9c53512e5857dcba8bb0b4e9a8c","bcc8487f419b8c668a18ea2120822a05df6dfe1de1f0fac3feba88cf760f303c","86bf7b4a274e0f8ec9816171667c1b4a0cfc661dc21563f271acea9482b62df7"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/updates":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Transaction ID"},"cert_index":{"type":"integer","description":"Certificate within the transaction"},"action":{"type":"string","enum":["registered","deregistered"],"description":"Action in the certificate"}},"required":["tx_hash","cert_index","action"]},"example":[{"tx_hash":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","cert_index":0,"action":"registered"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","cert_index":0,"action":"deregistered"},{"tx_hash":"e14a75b0eb2625de7055f1f580d70426311b78e0d36dd695a6bdc96c7b3d80e0","cert_index":1,"action":"registered"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/pools/{pool_id}/votes":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the proposal transaction."},"cert_index":{"type":"integer","description":"Index of the certificate within the proposal transaction."},"vote":{"type":"string","enum":["yes","no","abstain"],"description":"The Vote. Can be one of yes, no, abstain."}},"required":["tx_hash","cert_index","vote"]},"example":[{"tx_hash":"b302de601defdf11a5261ed31a263804dac4a582a888c998ce24dec5","cert_index":2,"vote":"yes"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"pool_id":{"type":"string"}}}},"/assets":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","format":"Concatenation of the policy_id and hex-encoded asset_name","description":"Asset identifier"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e75d","quantity":"100000"},{"asset":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/assets/{asset}":{"response":{"200":{"type":"object","properties":{"asset":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","description":"Hex-encoded asset full name"},"policy_id":{"type":"string","example":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a7","description":"Policy ID of the asset"},"asset_name":{"type":"string","nullable":true,"example":"6e7574636f696e","description":"Hex-encoded asset name of the asset"},"fingerprint":{"type":"string","example":"asset1pkpwyknlvul7az0xx8czhl60pyel45rpje4z8w","description":"CIP14 based user-facing fingerprint"},"quantity":{"type":"string","example":"12000","description":"Current asset quantity"},"initial_mint_tx_hash":{"type":"string","example":"6804edf9712d2b619edb6ac86861fe93a730693183a262b165fcc1ba1bc99cad","description":"ID of the initial minting transaction"},"mint_or_burn_count":{"type":"integer","example":1,"description":"Count of mint and burn transactions"},"onchain_metadata":{"type":"object","nullable":true,"additionalProperties":true,"description":"On-chain metadata which SHOULD adhere to the valid standards,\nbased on which we perform the look up and display the asset\n(best effort)\n"},"onchain_metadata_standard":{"type":"string","nullable":true,"enum":["CIP25v1","CIP25v2","CIP68v1","CIP68v2","CIP68v3"],"description":"If on-chain metadata passes validation, we display the standard\nunder which it is valid\n"},"onchain_metadata_extra":{"type":"string","nullable":true,"description":"Arbitrary plutus data (CIP68).\n"},"metadata":{"type":"object","nullable":true,"description":"Off-chain metadata fetched from GitHub based on network.\nMainnet: https://github.com/cardano-foundation/cardano-token-registry/\nTestnet: https://github.com/input-output-hk/metadata-registry-testnet/\n","properties":{"name":{"type":"string","example":"nutcoin","description":"Asset name"},"description":{"type":"string","example":"The Nut Coin","description":"Asset description"},"ticker":{"type":"string","nullable":true,"example":"nutc"},"url":{"type":"string","nullable":true,"example":"https://www.stakenuts.com/","description":"Asset website"},"logo":{"type":"string","nullable":true,"example":"iVBORw0KGgoAAAANSUhEUgAAADAAAAAoCAYAAAC4h3lxAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABmJLR0QA/wD/AP+gvaeTAAAAB3RJTUUH5QITCDUPjqwFHwAAB9xJREFUWMPVWXtsU9cZ/8499/r6dZ3E9rUdO7ZDEgglFWO8KaOsJW0pCLRKrN1AqqYVkqoqrYo0ja7bpElru1WairStFKY9WzaE1E1tx+jokKqwtqFNyhKahEJJyJNgJ37E9r1+3HvO/sFR4vhx7SBtfH/F3/l93/f7ne/4PBxEKYU72dj/ZfH772v1TU+HtqbTaX8wOO01GPQpRVH7JEm+vGHDuq6z7/8jUSoHKtaBKkEUFUXdajDy1hUrmrs6zn/wWS7m7pZVjMUirKGUTnzc+e9xLcTrPPVfZzDz06Sc2lyQGEIyAPzT7Xa+dvE/3e+XLaCxoflHsVj8MAAYs74aa/WHoenwvpkZKeFy2Z5NJlOPUkqXZccFwSSrKjlyffjLH+TL6XTUGTGL/6hklD3ldIrj2M5MRmkLBMcvaRLQ1Nj88sxM/HCBfMP+eu/OYGDqe6l0WmpoqJ/88upgrU7HrQNA/cFg6MlkKiLlBtVUO40cx54BgHvLIT/HJLvdeqh/4NKxogKWN7fsCoUi7xTLxLJ4vLq6ak//wKVOrdXtttrTDMPsqJA8AAAwDErdu3VL3alTf5ma9eWCpoKhn5dKpCiqJxicPucQPVu0FHaInn35yHMcKwPAa4SQ3QCwFgDWUko3qSr5vqqSgTypuEg4Mo/zvA74/Y0rZSnZU8akSHV17k2fXfy0txjI5224kEym1s/1EUI7LBbztweHrkzkizn49LP6U6feepFSeggAQK/n04SQZ8bGrxdeQjZrbRvGzLH5hcibRqOhPplMfS1fIY5jz4xPDBdcGggho2h3z9sOLRazdG3wqp9SMgUlzGZ17SSEPsRx7J8CwfGu3PF57WhqqjfN/VxVJUxKUrIdITAXKpDJKFscosdfaFy0u+/K9aXTmXe0kAcAmA5Nng5Hbj6Tj/wCAYFAcN7uEY3GXGazMSHLqVVFapgBoMPna9yqhRAAgCTJMa3YUjZPgNFkSlWYx5eUkx+0tKx83V3rF+cVYJjruWCe133DIXqMmrNrFSDabRcWkywYmG5XFOW6aHcfb9324CoAgMmbo9MIoXkneCajiAihV/c/8eSiBSw4BxyiZxQA6m7H7FBKT2CMn2MY5jFFUX6ZO+5w2j8aHZ7YH40FByrJD5DnHGAY5uTtIA8AgBDaR4F2Yxb3WizCgmtA4ObUPSazodduqz3Suu0hf0U1cjvgdNSJ1dWWveFwdDUAtAiC2Uopdcdi8c9Zlh3GmDGl05mtAKAvo47EcdwThJCjqqpWFxALlNITomg73tff21GRAJez7iVK4WGGYfoJIQduBsbm7UrLm1ueCoUiv65kpiilw1ZbzcFoZOYoIcRTAn6eYZgXJm+Oni+Vd3YJbdyweSch9HlK6SpVVfcyDDq7Yf3m2XPBIXraKyV/a4b9UkLawbLsZgB4rwR8CyGkw13r+5fX27BckwBAEJ47oKpk8+DgUIdod7fV1vqOAMDrlZLPmqKoB+rrvXIgOP6w0WjYy3Ls5RL4bUk52bVm9fqnCk7M3CXU2ND8+MxM7BcIIftiyRYyntcdHh0bmr0wfmXl6p2SJB2KRmP3l4j7zejYUFtRAQAAgslm1Bv4nyGEDpYiIwjmjw0G/RjP866JiclNqqqWfKLq9fyZkdHBBXcnl9O71GDgD8bj0ncRQqZ8sRgzL9yYHH2pqICsOUTPLgA4CXNeZFmzWIS/YhYfjUZmvqPjuceSckrz25pS2h2cmlhbaBwhzr6kfsnL8Xhif55YYFl23Y3Jkdl7EVMoUSA4/q6qqNsBIPd11e52u45FwtG3CSH7yiEPAGC1Vt9dXGBmanDoygFLlbAjtzZCCMyC6VeaOpA1l9N7l1kwtauKaozHE28YTQaQpeR7+TqjxXheR0fHhhgt2CX1S3clEtKC16HL5djYe+niBU0CcmYA2W21/Qih5ZqDcoxlMZ24MaJJAABA87IVJ8Lh6N65Pr1B/+LIyLUfAhRZQvnM6ah7ZDHkAQB0vK6/HHxNTc2ruT5Zkldn/y5LACFk+2LIAwAwCGl6yGSt88KHXbmrBCHkqEgAz+vWLFZALJb4qNwYhFDhCSknkSwnQ4sVgDFeWg7+gQe2r1tAmkGTFQlACHWVg89nhJA9ot3dphV/eeCLp/Pw6K5IQP0S39uLFXCLwDG7zf1cKZxD9LSlUunHc/12u/2t2Vzl/rzu8zb8PZlM7bwdQgDgPK/nX2nddt+53//ht3LW2dS0fF0iLj2vquojuQFmwXRucPBKa8UCmpe1iOFwpAsAfLdJBFBKwVIlXJ2JxqKCxbwyHkvoCkAlv9/71U+7Oq+UJWDZ0hViJBL1cRynbNq0sSeeiPl6ei4NqIqq6TSmlB7X6bjuTEY5pgWfzwxGPZhMpt39/b3vzvWXFGCzulZjjM/DrauDwcAr8bjcgzGjZUuVBMH8k2uDX7wCAFDr8n2LEPI7SqmhTP6SzVbz6MDlz0/nDpT8EmOM22HOvUeWU2wp8iyLgRL6hk7Hrc2SBwC4MTlykmXZRozxn00mbVcphNA5jJmV+chr6oDd5l6jN/A/TqfSuwEAGITGMIsvGo3GTwTB3Dc2NjGSxdZYq4VIOOoNBANnKE0XPXE3brjHOTQ08k2MmVZOxzVJCbkFIQSCYEphzPaFQuGzTpfjb319PZ8UFXin/5OvrHPg/9HueAH/BSUqOuNZm4fyAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIxLTAyLTE5VDA4OjUyOjI1KzAwOjAwCmFGlgAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMS0wMi0xOVQwODo1MjoyMyswMDowMBjsyxAAAAAASUVORK5CYII=","description":"Base64 encoded logo of the asset"},"decimals":{"type":"integer","nullable":true,"maximum":255,"example":6,"description":"Number of decimal places of the asset unit"}},"required":["name","description","ticker","url","logo","decimals"]}},"required":["asset","policy_id","asset_name","fingerprint","quantity","initial_mint_tx_hash","mint_or_burn_count","metadata","onchain_metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/history":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction containing the asset action"},"action":{"type":"string","enum":["minted","burned"],"description":"Action executed upon the asset policy"},"amount":{"type":"string","description":"Asset amount of the specific action"}},"required":["tx_hash","action","amount"]},"example":[{"tx_hash":"2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531","amount":"10","action":"minted"},{"tx_hash":"9c190bc1ac88b2ab0c05a82d7de8b71b67a9316377e865748a89d4426c0d3005","amount":"5","action":"burned"},{"tx_hash":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0","amount":"5","action":"burned"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/txs":{"response":{"200":{"type":"array","items":{"type":"string","description":"Hash of the transaction"},"example":["8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/transactions":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","description":"Hash of the transaction"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"block_height":{"type":"integer","description":"Block height"},"block_time":{"type":"integer","example":1635505891,"description":"Block creation time in UNIX time"}},"required":["tx_hash","tx_index","block_height","block_time"]},"example":[{"tx_hash":"8788591983aa73981fc92d6cddbbe643959f5a784e84b8bee0db15823f575a5b","tx_index":6,"block_height":69,"block_time":1635505891},{"tx_hash":"52e748c4dec58b687b90b0b40d383b9fe1f24c1a833b7395cdf07dd67859f46f","tx_index":9,"block_height":4547,"block_time":1635505987},{"tx_hash":"e8073fd5318ff43eca18a852527166aa8008bee9ee9e891f585612b7e4ba700b","tx_index":0,"block_height":564654,"block_time":1834505492}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/{asset}/addresses":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address containing the specific asset"},"quantity":{"type":"string","description":"Asset quantity on the specific address"}},"required":["address","quantity"]},"example":[{"address":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz","quantity":"1"},{"address":"addr1qyhr4exrgavdcn3qhfcc9f939fzsch2re5ry9cwvcdyh4x4re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qdpvhza","quantity":"100000"},{"address":"addr1q8zup8m9ue3p98kxlxl9q8rnyan8hw3ul282tsl9s326dfj088lvedv4zckcj24arcpasr0gua4c5gq4zw2rpcpjk2lq8cmd9l","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"asset":{"type":"string"}}}},"/assets/policy/{policy_id}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"asset":{"type":"string","description":"Concatenation of the policy_id and hex-encoded asset_name"},"quantity":{"type":"string","description":"Current asset quantity"}},"required":["asset","quantity"]},"example":[{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a76e7574636f696e","quantity":"1"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb38a766e","quantity":"100000"},{"asset":"b0d07d45fe9514f80213f4020e5a61241458be626841cde717cb574636f696e","quantity":"18605647"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"policy_id":{"type":"string"}}}},"/scripts":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"script_hash":{"type":"string","description":"Script hash"}},"required":["script_hash"]},"example":[{"script_hash":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1"},{"script_hash":"e1457a0c47dfb7a2f6b8fbb059bdceab163c05d34f195b87b9f2b30e"},{"script_hash":"a6e63c0ff05c96943d1cc30bf53112ffff0f34b45986021ca058ec54"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/scripts/{script_hash}":{"response":{"200":{"type":"object","properties":{"script_hash":{"type":"string","example":"13a3efd825703a352a8f71f4e2758d08c28c564e8dfcce9f77776ad1","description":"Script hash"},"type":{"type":"string","enum":["timelock","plutusV1","plutusV2","plutusV3"],"example":"plutusV1","description":"Type of the script language"},"serialised_size":{"type":"integer","nullable":true,"description":"The size of the CBOR serialised script, if a Plutus script","example":3119}},"required":["script_hash","type","serialised_size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/json":{"response":{"200":{"type":"object","properties":{"json":{"nullable":true}},"required":["json"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","nullable":true,"description":"CBOR contents of the `plutus` script, null for `timelocks`"}},"required":["cbor"],"example":{"cbor":"4e4d01000033222220051200120011"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/{script_hash}/redeemers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string","example":"1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dce628516157f0","description":"Hash of the transaction"},"tx_index":{"type":"integer","example":0,"description":"The index of the redeemer pointer in the transaction"},"purpose":{"type":"string","enum":["spend","mint","cert","reward"],"example":"spend","description":"Validation purpose"},"redeemer_data_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash of the redeemer"},"datum_hash":{"type":"string","example":"923918e403bf43c34b4ef6b48eb2ee04babed17320d8d1b9ff9ad086e86f44ec","description":"Datum hash","deprecated":true},"unit_mem":{"type":"string","example":"1700","description":"The budget in Memory to run a script"},"unit_steps":{"type":"string","example":"476468","description":"The budget in CPU steps to run a script"},"fee":{"type":"string","example":"172033","description":"The fee consumed to run the script"}},"required":["tx_hash","tx_index","purpose","redeemer_data_hash","datum_hash","unit_mem","unit_steps","fee"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"script_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}":{"response":{"200":{"type":"object","properties":{"json_value":{"type":"object","additionalProperties":true,"description":"JSON content of the datum"}},"required":["json_value"],"example":{"json_value":{"int":42}}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/scripts/datum/{datum_hash}/cbor":{"response":{"200":{"type":"object","properties":{"cbor":{"type":"string","description":"CBOR serialized datum"}},"required":["cbor"],"example":{"cbor":"19a6aa"}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"datum_hash":{"type":"string"}}}},"/utils/addresses/xpub/{xpub}/{role}/{index}":{"response":{"200":{"type":"object","properties":{"xpub":{"type":"string","description":"Script hash"},"role":{"type":"integer","description":"Account role"},"index":{"type":"integer","description":"Address index"},"address":{"type":"string","description":"Derived address"}},"required":["xpub","role","index","address"],"example":[{"xpub":"d507c8f866691bd96e131334c355188b1a1d0b2fa0ab11545075aab332d77d9eb19657ad13ee581b56b0f8d744d66ca356b93d42fe176b3de007d53e9c4c4e7a","role":0,"index":0,"address":"addr1q90sqnljxky88s0jsnps48jd872p7znzwym0jpzqnax6qs5nfrlkaatu28n0qzmqh7f2cpksxhpc9jefx3wrl0a2wu8q5amen7"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"xpub":{"type":"string"},"role":{"type":"integer"},"index":{"type":"integer"}}}},"/utils/txs/evaluate":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/utils/txs/evaluate/utxos":{"response":{"200":{"type":"object","additionalProperties":true},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"version":{"type":"number","default":5}}}},"/ipfs/add":{"response":{"200":{"type":"object","properties":{"name":{"type":"string","example":"README.md","description":"Name of the file"},"ipfs_hash":{"type":"string","example":"QmZbHqiCxKEVX7QfijzJTkZiSi3WEVTcvANgNAWzDYgZDr","description":"IPFS hash of the file"},"size":{"type":"string","example":"125297","description":"IPFS node size in Bytes"}},"required":["name","ipfs_hash","size"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/ipfs/gateway/{IPFS_path}":{"response":{"200":{"type":"string","format":"binary"},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/add/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"queued","description":"State of the pin action"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["ipfs_hash","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"filecoin":{"type":"boolean"}}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"Path to the IPFS object"}}}},"/ipfs/pin/list":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time_created":{"type":"integer","description":"Creation time of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Pin time of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object, which is `queued` when we are retriving object. If this\nis successful the state is changed to `pinned` or `failed` if not. The state `gc` means the\npinned item has been garbage collected due to account being over storage quota or after it has\nbeen moved to `unpinned` state by removing the object pin.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}}},"/ipfs/pin/list/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"time_created":{"type":"integer","description":"Time of the creation of the IPFS object on our backends","example":1615551024},"time_pinned":{"type":"integer","description":"Time of the pin of the IPFS object on our backends","example":1615551024},"ipfs_hash":{"type":"string","description":"IPFS hash of the pinned object","example":"QmdVMnULrY95mth2XkwjxDtMHvzuzmvUPTotKE1tgqKbCx"},"size":{"type":"string","description":"Size of the object in Bytes","example":"1615551024"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"description":"State of the pinned object. We define 5 states: `queued`, `pinned`, `unpinned`, `failed`, `gc`.\nWhen the object is pending retrieval (i.e. after `/ipfs/pin/add/{IPFS_path}`), the state is `queued`.\nIf the object is already successfully retrieved, state is changed to `pinned` or `failed` otherwise.\nWhen object is unpinned (i.e. after `/ipfs/pin/remove/{IPFS_path}`) it is marked for garbage collection.\nState `gc` means that a previously `unpinned` item has been garbage collected due to account being over storage quota.\n","example":"pinned"},"filecoin":{"type":"boolean","description":"Whether filecoin was used to pin the resource."}},"required":["time_created","time_pinned","ipfs_hash","size","state","filecoin"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/ipfs/pin/remove/{IPFS_path}":{"response":{"200":{"type":"object","properties":{"ipfs_hash":{"type":"string","example":"QmPojRfAXYAXV92Dof7gtSgaVuxEk64xx9CKvprqu9VwA8","description":"IPFS hash of the pinned object"},"state":{"type":"string","enum":["queued","pinned","unpinned","failed","gc"],"example":"unpinned","description":"State of the pin action"}},"required":["ipfs_hash","state"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"IPFS_path":{"type":"string","description":"The path to the IPFS object"}}}},"/metrics":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day"}},"required":["time","calls"]},"example":[{"time":1612543884,"calls":42},{"time":1614523884,"calls":6942}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/metrics/endpoints":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"time":{"type":"integer","description":"Starting time of the call count interval (ends midnight UTC) in UNIX time"},"calls":{"type":"integer","description":"Sum of all calls for a particular day and endpoint"},"endpoint":{"type":"string","description":"Endpoint parent name"}},"required":["time","calls","endpoint"]},"example":[{"time":1612543814,"calls":182,"endpoint":"block"},{"time":1612543814,"calls":42,"endpoint":"epoch"},{"time":1612543812,"calls":775,"endpoint":"block"},{"time":1612523884,"calls":4,"endpoint":"epoch"},{"time":1612553884,"calls":89794,"endpoint":"block"}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network":{"response":{"200":{"type":"object","properties":{"supply":{"type":"object","properties":{"max":{"type":"string","description":"Maximum supply in Lovelaces","example":"45000000000000000"},"total":{"type":"string","description":"Current total (max supply - reserves) supply in Lovelaces","example":"32890715183299160"},"circulating":{"type":"string","description":"Current circulating (UTXOs + withdrawables) supply in Lovelaces","example":"32412601976210393"},"locked":{"type":"string","description":"Current supply locked by scripts in Lovelaces","example":"125006953355"},"treasury":{"type":"string","description":"Current supply locked in treasury","example":"98635632000000"},"reserves":{"type":"string","description":"Current supply locked in reserves","example":"46635632000000"}},"required":["max","total","circulating","locked","treasury","reserves"]},"stake":{"type":"object","properties":{"live":{"type":"string","example":"23204950463991654","description":"Current live stake in Lovelaces"},"active":{"type":"string","description":"Current active stake in Lovelaces","example":"22210233523456321"}},"required":["live","active"]}},"required":["supply","stake"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/network/eras":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"start":{"type":"object","description":"Start of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"end":{"type":"object","description":"End of the blockchain era,\nrelative to the start of the network\n","properties":{"time":{"type":"integer","description":"Time in seconds relative to the start time of the network"},"slot":{"type":"integer","description":"Absolute slot number"},"epoch":{"type":"integer","description":"Epoch number"}},"required":["time","slot","epoch"]},"parameters":{"type":"object","description":"Era parameters","properties":{"epoch_length":{"type":"integer","description":"Epoch length in number of slots"},"slot_length":{"type":"integer","description":"Slot length in seconds"},"safe_zone":{"type":"integer","description":"Zone in which it is guaranteed that no hard fork can take place"}},"required":["epoch_length","slot_length","safe_zone"]}},"required":["start","end","parameters"]},"example":[{"start":{"time":0,"slot":0,"epoch":0},"end":{"time":89856000,"slot":4492800,"epoch":208},"parameters":{"epoch_length":21600,"slot_length":20,"safe_zone":4320}},{"start":{"time":89856000,"slot":4492800,"epoch":208},"end":{"time":101952000,"slot":16588800,"epoch":236},"parameters":{"epoch_length":432000,"slot_length":1,"safe_zone":129600}}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"425":{"type":"object","properties":{"status_code":{"type":"integer","example":425},"error":{"type":"string","example":"Mempool Full"},"message":{"type":"string","example":"Mempool is full, please try resubmitting again later."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}}},"/nutlink/{address}":{"response":{"200":{"type":"object","properties":{"address":{"type":"string","description":"Bech32 encoded address","example":"addr1qxqs59lphg8g6qndelq8xwqn60ag3aeyfcp33c2kdp46a09re5df3pzwwmyq946axfcejy5n4x0y99wqpgtp2gd0k09qsgy6pz"},"metadata_url":{"type":"string","description":"URL of the specific metadata file","example":"https://nut.link/metadata.json"},"metadata_hash":{"type":"string","description":"Hash of the metadata file","example":"6bf124f217d0e5a0a8adb1dbd8540e1334280d49ab861127868339f43b3948af"},"metadata":{"type":"object","nullable":true,"description":"The cached metadata of the `metadata_url` file.","additionalProperties":true}},"required":["address","metadata_url","metadata_hash","metadata"]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Name of the ticker"},"count":{"type":"integer","description":"Number of ticker records"},"latest_block":{"type":"integer","description":"Block height of the latest record"}},"required":["name","count","latest_block"]},"example":[{"name":"ADAUSD","count":1980038,"latest_block":2657092},{"name":"ADAEUR","count":1980038,"latest_block":2657092},{"name":"ADABTC","count":1980038,"latest_block":2657092}]},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"}}}},"/nutlink/{address}/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"tx_hash":{"type":"string"},"block_height":{"type":"integer"},"tx_index":{"type":"integer"},"payload":{}},"required":["tx_hash","tx_index","block_height","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"ticker":{"type":"string","description":"Ticker for the pool record"}}}},"/nutlink/tickers/{ticker}":{"response":{"200":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","description":"Address of a metadata oracle"},"tx_hash":{"type":"string","description":"Hash of the transaction"},"block_height":{"type":"integer","description":"Block height of the record"},"tx_index":{"type":"integer","description":"Transaction index within the block"},"payload":{}},"required":["address","tx_hash","block_height","tx_index","payload"]}},"400":{"type":"object","properties":{"status_code":{"type":"integer","example":400},"error":{"type":"string","example":"Bad Request"},"message":{"type":"string","example":"Backend did not understand your request."}},"required":["error","message","status_code"]},"403":{"type":"object","properties":{"status_code":{"type":"integer","example":403},"error":{"type":"string","example":"Forbidden"},"message":{"type":"string","example":"Invalid project token."}},"required":["error","message","status_code"]},"404":{"type":"object","properties":{"status_code":{"type":"integer","example":404},"error":{"type":"string","example":"Not Found"},"message":{"type":"string","example":"The requested component has not been found."}},"required":["error","message","status_code"]},"418":{"type":"object","properties":{"status_code":{"type":"integer","example":418},"error":{"type":"string","example":"Requested Banned"},"message":{"type":"string","example":"IP has been auto-banned for flooding."}},"required":["error","message","status_code"]},"429":{"type":"object","properties":{"status_code":{"type":"integer","example":429},"error":{"type":"string","example":"Project Over Limit"},"message":{"type":"string","example":"Usage is over limit."}},"required":["error","message","status_code"]},"500":{"type":"object","properties":{"status_code":{"type":"integer","example":500},"error":{"type":"string","example":"Internal Server Error"},"message":{"type":"string","example":"An unexpected response was received from the backend."}},"required":["error","message","status_code"]}},"querystring":{"type":"object","properties":{"count":{"type":"integer","minimum":1,"maximum":100,"default":100},"page":{"type":"integer","minimum":1,"maximum":21474836,"default":1},"order":{"type":"string","enum":["asc","desc"],"default":"asc"}}},"params":{"type":"object","properties":{"ticker":{"type":"string","description":"Ticker for the pool record"}}}}}
diff --git a/openapi-merge.json b/openapi-merge.json
index 77630936..0cb89ae4 100644
--- a/openapi-merge.json
+++ b/openapi-merge.json
@@ -9,7 +9,7 @@
         "prepend": "/api/v2"
       },
       "operationSelection": {
-        "includeTags": ["Bitcoin", "Litecoin", "Dogecoin"]
+        "includeTags": ["SKIPBitcoin"]
       },
       "description": {
         "append": false
diff --git a/openapi.json b/openapi.json
index 2223eacb..c93e7d58 100644
--- a/openapi.json
+++ b/openapi.json
@@ -17,7 +17,7 @@
       "url": "https://opensource.org/licenses/MIT"
     },
     "termsOfService": "https://blockfrost.io/terms",
-    "description": "Blockfrost is an API as a service that allows users to interact with the Cardano blockchain, Midnight blockchain, and parts of their ecosystems.\n\n## Tokens\n\nAfter signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project.\nHTTP header of your request MUST include this `project_id` in order to authenticate against Blockfrost servers.\n\n## Available networks\n\nAt the moment, you can use the following networks. Please, note that each network has its own `project_id`.\n\n\n  \n    \n      \n      \n    \n    \n        \n        \n    \n    \n        \n        \n    \n    \n        \n        \n    \n    \n        \n        \n        \n    \n    \n        \n        \n    \n  \n
\n Network\n \n Endpoint\n
Cardano mainnet\n https://cardano-mainnet.blockfrost.io/api/v0\n
Cardano preprod\n https://cardano-preprod.blockfrost.io/api/v0\n
Cardano preview\n https://cardano-preview.blockfrost.io/api/v0\n
Midnight mainnet\n https://midnight-mainnet.blockfrost.io/api/v0\n Bitcoin mainnet\n https://bitcoin-mainnet.blockfrost.io/api/v2\n
InterPlanetary File System\n https://ipfs.blockfrost.io/api/v0\n
\n\n## Concepts\n\n* All endpoints return either a JSON object or an array.\n* Data is returned in *ascending* (oldest first, newest last) order, if not stated otherwise.\n * You might use the `?order=desc` query parameter to reverse this order.\n* By default, we return 100 results at a time. You have to use `?page=2` to list through the results.\n* All time and timestamp related fields (except `server_time`) are in seconds of UNIX time.\n* All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces.\n* Addresses, accounts and pool IDs are in Bech32 format.\n* All values are case sensitive.\n* All hex encoded values are lower case.\n* Examples are not based on real data. Any resemblance to actual events is purely coincidental.\n* We allow to upload files up to 100MB of size to IPFS. This might increase in the future.\n* Only pinned IPFS files are counted towards the IPFS quota.\n* Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.\n* We allow maximum of 100 queued pins per IPFS user.\n\n## Errors\n\n### HTTP Status codes\n\nThe following are HTTP status code your application might receive when reaching Blockfrost endpoints and\nit should handle all of these cases.\n\n* HTTP `400` return code is used when the request is not valid.\n* HTTP `402` return code is used when the projects exceed their daily request limit.\n* HTTP `403` return code is used when the request is not authenticated.\n* HTTP `404` return code is used when the resource doesn't exist.\n* HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`.\n* HTTP `425` return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.\n* HTTP `425` return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.\n* HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.\n* HTTP `500` return code is used when our endpoints are having a problem.\n\n### Error codes\n\nAn internal error code number is used for better indication of the error in question. It is passed using the following payload.\n\n```json\n{\n \"status_code\": 403,\n \"error\": \"Forbidden\",\n \"message\": \"Invalid project token.\"\n}\n```\n## Limits\n\nThere are two types of limits we are enforcing:\n\nThe first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time.\n\nThe second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow\neach user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another\nwhole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed.\nWe believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and\nwe will make sure to take it into account as much as we can.\n\n## SDKs\n\nWe support a number of SDKs that will help you in developing your application on top of Blockfrost.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Programming languageSDK
JavaScript\n blockfrost-js\n
Haskell\n blockfrost-haskell\n
Python\n blockfrost-python\n
Rust\n blockfrost-rust\n
Golang\n blockfrost-go\n
Ruby\n blockfrost-ruby\n
Java\n blockfrost-java\n
Scala\n blockfrost-scala\n
Swift\n blockfrost-swift\n
Kotlin\n blockfrost-kotlin\n
Elixir\n blockfrost-elixir\n
.NET\n blockfrost-dotnet\n
Arduino\n blockfrost-arduino\n
PHP\n blockfrost-php\n
Crystal\n blockfrost-crystal\n
\n\n\n## Midnight API\n\n\nThe Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data — blocks, transactions, contracts, and wallet-related events — indexed from the Midnight blockchain.\n\nAvailable networks: `mainnet`, `preprod`, `preview`\n\n| Service | URL | Protocol |\n|---------|-----|----------|\n| **Indexer HTTP API** | `https://midnight-{network}.blockfrost.io/api/v0` | HTTP POST (GraphQL) |\n| **Indexer Subscriptions API** | `wss://midnight-{network}.blockfrost.io/api/v0/ws` | WebSocket |\n| **Node RPC** | `https://rpc.midnight-{network}.blockfrost.io` | JSON-RPC |\n\n\nFor the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference:\n\n[![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/)\n" + "description": "Blockfrost is an API as a service that allows users to interact with the Cardano blockchain, Midnight blockchain, and parts of their ecosystems.\n\n## Tokens\n\nAfter signing up on https://blockfrost.io, a `project_id` token is automatically generated for each project.\nHTTP header of your request MUST include this `project_id` in order to authenticate against Blockfrost servers.\n\n## Available networks\n\nAt the moment, you can use the following networks. Please, note that each network has its own `project_id`.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
NetworkEndpoint
Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano preprodhttps://cardano-preprod.blockfrost.io/api/v0
Cardano previewhttps://cardano-preview.blockfrost.io/api/v0
Midnight mainnethttps://midnight-mainnet.blockfrost.io/api/v0
Midnight preprodhttps://midnight-preprod.blockfrost.io/api/v0
Midnight previewhttps://midnight-preview.blockfrost.io/api/v0
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
InterPlanetary File Systemhttps://ipfs.blockfrost.io/api/v0
\n\n## Concepts\n\n* All endpoints return either a JSON object or an array.\n* Data is returned in *ascending* (oldest first, newest last) order, if not stated otherwise.\n * You might use the `?order=desc` query parameter to reverse this order.\n* By default, we return 100 results at a time. You have to use `?page=2` to list through the results.\n* All time and timestamp related fields (except `server_time`) are in seconds of UNIX time.\n* All amounts are returned in Lovelaces, where 1 ADA = 1 000 000 Lovelaces.\n* Addresses, accounts and pool IDs are in Bech32 format.\n* All values are case sensitive.\n* All hex encoded values are lower case.\n* Examples are not based on real data. Any resemblance to actual events is purely coincidental.\n* We allow to upload files up to 100MB of size to IPFS. This might increase in the future.\n* Only pinned IPFS files are counted towards the IPFS quota.\n* Non-pinned IPFS files are subject to regular garbage collection and will be removed unless pinned.\n* We allow maximum of 100 queued pins per IPFS user.\n\n## Errors\n\n### HTTP Status codes\n\nThe following are HTTP status code your application might receive when reaching Blockfrost endpoints and\nit should handle all of these cases.\n\n* HTTP `400` return code is used when the request is not valid.\n* HTTP `402` return code is used when the projects exceed their daily request limit.\n* HTTP `403` return code is used when the request is not authenticated.\n* HTTP `404` return code is used when the resource doesn't exist.\n* HTTP `418` return code is used when the user has been auto-banned for flooding too much after previously receiving error code `402` or `429`.\n* HTTP `425` return code is used in Cardano networks, when the user has submitted a transaction when the mempool is already full, not accepting new txs straight away.\n* HTTP `425` return code is used in IPFS network, when the user has submitted a pin when the pin queue is already full, not accepting new pins straight away.\n* HTTP `429` return code is used when the user has sent too many requests in a given amount of time and therefore has been rate-limited.\n* HTTP `500` return code is used when our endpoints are having a problem.\n\n### Error codes\n\nAn internal error code number is used for better indication of the error in question. It is passed using the following payload.\n\n```json\n{\n \"status_code\": 403,\n \"error\": \"Forbidden\",\n \"message\": \"Invalid project token.\"\n}\n```\n## Limits\n\nThere are two types of limits we are enforcing:\n\nThe first depends on your plan and is the number of request we allow per day. We defined the day from midnight to midnight of UTC time.\n\nThe second is rate limiting. We limit an end user, distinguished by IP address, to 10 requests per second. On top of that, we allow\neach user to send burst of 500 requests, which cools off at rate of 10 requests per second. In essence, a user is allowed to make another\nwhole burst after (currently) 500/10 = 50 seconds. E.g. if a user attempts to make a call 3 seconds after whole burst, 30 requests will be processed.\nWe believe this should be sufficient for most of the use cases. If it is not and you have a specific use case, please get in touch with us, and\nwe will make sure to take it into account as much as we can.\n\n## SDKs\n\nWe support a number of SDKs that will help you in developing your application on top of Blockfrost.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
Programming languageSDK
JavaScript\n blockfrost-js\n
Haskell\n blockfrost-haskell\n
Python\n blockfrost-python\n
Rust\n blockfrost-rust\n
Golang\n blockfrost-go\n
Ruby\n blockfrost-ruby\n
Java\n blockfrost-java\n
Scala\n blockfrost-scala\n
Swift\n blockfrost-swift\n
Kotlin\n blockfrost-kotlin\n
Elixir\n blockfrost-elixir\n
.NET\n blockfrost-dotnet\n
Arduino\n blockfrost-arduino\n
PHP\n blockfrost-php\n
Crystal\n blockfrost-crystal\n
\n\n\n## Midnight API\n\n\nThe Midnight Indexer API exposes a GraphQL API that enables clients to query and subscribe to blockchain data — blocks, transactions, contracts, and wallet-related events — indexed from the Midnight blockchain.\n\nAvailable networks: `mainnet`, `preprod`, `preview`\n\n| Service | URL | Protocol |\n|---------|-----|----------|\n| **Indexer HTTP API** | `https://midnight-{network}.blockfrost.io/api/v0` | HTTP POST (GraphQL) |\n| **Indexer Subscriptions API** | `wss://midnight-{network}.blockfrost.io/api/v0/ws` | WebSocket |\n| **Node RPC** | `https://rpc.midnight-{network}.blockfrost.io` | JSON-RPC |\n\n\nFor the full documentation — queries, mutations, subscriptions, authentication options, and examples — see the Midnight GraphQL API Reference:\n\n[![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/)\n\n\n## Bitcoin API\n\nAccess the Bitcoin blockchain through the Blockbook API.\n\nEndpoint: `https://bitcoin-mainnet.blockfrost.io/api/v2`\n\n[![Explore the Bitcoin API →](https://img.shields.io/badge/Explore_the_Bitcoin_API_→-C77800?style=for-the-badge&logo=bitcoin&logoColor=white)](./blockbook/)\n\n\n## Litecoin API\n\nAccess the Litecoin blockchain through the Blockbook API.\n\nEndpoint: `https://litecoin-mainnet.blockfrost.io/api/v2`\n\n[![Explore the Litecoin API →](https://img.shields.io/badge/Explore_the_Litecoin_API_→-345D9D?style=for-the-badge&logo=litecoin&logoColor=white)](./blockbook/)\n\n\n## Dogecoin API\n\nAccess the Dogecoin blockchain through the Blockbook API.\n\nEndpoint: `https://dogecoin-mainnet.blockfrost.io/api/v2`\n\n[![Explore the Dogecoin API →](https://img.shields.io/badge/Explore_the_Dogecoin_API_→-9B7E1A?style=for-the-badge&logo=dogecoin&logoColor=white)](./blockbook/)\n" }, "servers": [ { @@ -49,18 +49,6 @@ { "name": "Metrics" }, - { - "name": "Bitcoin", - "description": "Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://bitcoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" - }, - { - "name": "Litecoin", - "description": "Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://litecoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" - }, - { - "name": "Dogecoin", - "description": "Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API.\n\n> **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..**\n\n> For example, to retrieve a block data for the first block, you would use:\n`https://dogecoin-mainnet.blockfrost.io/api/v2/block/1`\n\nIn addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors).\n" - }, { "name": "Cardano » Accounts" }, @@ -9028,1086 +9016,6 @@ } } } - }, - "/api/v2/status": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "get": { - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ], - "summary": "Blockchain status", - "operationId": "getStatus", - "description": "Get current status of Blockbook and its backend", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "blockbook": { - "type": "object", - "properties": { - "coin": { - "type": "string" - }, - "network": { - "type": "string" - }, - "host": { - "type": "string" - }, - "version": { - "type": "string" - }, - "gitCommit": { - "type": "string" - }, - "buildTime": { - "type": "string" - }, - "syncMode": { - "type": "boolean" - }, - "initialSync": { - "type": "boolean" - }, - "inSync": { - "type": "boolean" - }, - "bestHeight": { - "type": "integer" - }, - "lastBlockTime": { - "type": "string" - }, - "inSyncMempool": { - "type": "boolean" - }, - "lastMempoolTime": { - "type": "string" - }, - "mempoolSize": { - "type": "integer" - }, - "decimals": { - "type": "integer" - }, - "dbSize": { - "type": "integer" - }, - "hasFiatRates": { - "type": "boolean" - }, - "currentFiatRatesTime": { - "type": "string" - }, - "historicalFiatRatesTime": { - "type": "string" - }, - "about": { - "type": "string" - } - } - }, - "backend": { - "type": "object", - "properties": { - "chain": { - "type": "string" - }, - "blocks": { - "type": "integer" - }, - "headers": { - "type": "integer" - }, - "bestBlockHash": { - "type": "string" - }, - "difficulty": { - "type": "string" - }, - "sizeOnDisk": { - "type": "integer" - }, - "version": { - "type": "string" - }, - "subversion": { - "type": "string" - }, - "protocolVersion": { - "type": "string" - } - } - } - }, - "x-examples": { - "Example 1": { - "blockbook": { - "coin": "Bitcoin", - "host": "s4", - "version": "0.4.0", - "gitCommit": "83fe6672", - "buildTime": "2023-02-27T02:40:48+00:00", - "syncMode": true, - "initialSync": false, - "inSync": true, - "bestHeight": 784299, - "lastBlockTime": "2023-04-07T02:55:40.032567054Z", - "inSyncMempool": true, - "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", - "mempoolSize": 30785, - "decimals": 8, - "dbSize": 399834379691, - "hasFiatRates": true, - "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", - "historicalFiatRatesTime": "2023-04-07T00:00:00Z", - "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" - }, - "backend": { - "chain": "main", - "blocks": 784299, - "headers": 784299, - "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", - "difficulty": "47887764338536.25", - "sizeOnDisk": 534828732178, - "version": "240001", - "subversion": "/Satoshi:24.0.1/", - "protocolVersion": "70016" - } - } - } - }, - "examples": { - "Example 1": { - "value": { - "blockbook": { - "coin": "Bitcoin", - "host": "s4", - "version": "0.4.0", - "gitCommit": "83fe6672", - "buildTime": "2023-02-27T02:40:48+00:00", - "syncMode": true, - "initialSync": false, - "inSync": true, - "bestHeight": 784299, - "lastBlockTime": "2023-04-07T02:55:40.032567054Z", - "inSyncMempool": true, - "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", - "mempoolSize": 30785, - "decimals": 8, - "dbSize": 399834379691, - "hasFiatRates": true, - "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", - "historicalFiatRatesTime": "2023-04-07T00:00:00Z", - "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook" - }, - "backend": { - "chain": "main", - "blocks": 784299, - "headers": 784299, - "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", - "difficulty": "47887764338536.25", - "sizeOnDisk": 534828732178, - "version": "240001", - "subversion": "/Satoshi:24.0.1/", - "protocolVersion": "70016" - } - } - } - } - } - } - } - } - } - }, - "/api/v2/block/{blockHashOrHeight}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/blockHashOrHeight" - } - ], - "get": { - "summary": "Block", - "responses": { - "200": { - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "page": { - "type": "integer" - }, - "totalPages": { - "type": "integer" - }, - "itemsOnPage": { - "type": "integer" - }, - "hash": { - "type": "string" - }, - "previousBlockHash": { - "type": "string" - }, - "nextBlockHash": { - "type": "string" - }, - "height": { - "type": "integer" - }, - "confirmations": { - "type": "integer" - }, - "size": { - "type": "integer" - }, - "time": { - "type": "integer" - }, - "version": { - "type": "integer" - }, - "merkleRoot": { - "type": "string" - }, - "nonce": { - "type": "string" - }, - "bits": { - "type": "string" - }, - "difficulty": { - "type": "string" - }, - "txCount": { - "type": "integer" - }, - "txs": { - "type": "array", - "items": { - "type": "object", - "properties": { - "txid": { - "type": "string" - }, - "vin": { - "type": "array", - "items": { - "type": "object", - "properties": { - "n": { - "type": "integer" - }, - "isAddress": { - "type": "boolean" - }, - "value": { - "type": "string" - } - } - } - }, - "vout": { - "type": "array", - "items": { - "type": "object", - "properties": { - "value": { - "type": "string" - }, - "n": { - "type": "integer" - }, - "addresses": { - "type": "array", - "items": { - "type": "string" - } - }, - "isAddress": { - "type": "boolean" - } - } - } - }, - "blockHash": { - "type": "string" - }, - "blockHeight": { - "type": "integer" - }, - "confirmations": { - "type": "integer" - }, - "blockTime": { - "type": "integer" - }, - "value": { - "type": "string" - }, - "valueIn": { - "type": "string" - }, - "fees": { - "type": "string" - } - } - } - } - }, - "x-examples": { - "Example 1": { - "page": 1, - "totalPages": 1, - "itemsOnPage": 1000, - "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", - "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", - "height": 1, - "confirmations": 784303, - "size": 215, - "time": 1231469665, - "version": 1, - "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "nonce": "2573394689", - "bits": "1d00ffff", - "difficulty": "1", - "txCount": 1, - "txs": [ - { - "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "vin": [ - { - "n": 0, - "isAddress": false, - "value": "0" - } - ], - "vout": [ - { - "value": "5000000000", - "n": 0, - "addresses": [ - "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX" - ], - "isAddress": true - } - ], - "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "blockHeight": 1, - "confirmations": 784303, - "blockTime": 1231469665, - "value": "5000000000", - "valueIn": "0", - "fees": "0" - } - ] - } - } - }, - "examples": { - "Example 1": { - "value": { - "page": 1, - "totalPages": 1, - "itemsOnPage": 1000, - "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", - "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", - "height": 1, - "confirmations": 784303, - "size": 215, - "time": 1231469665, - "version": 1, - "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "nonce": "2573394689", - "bits": "1d00ffff", - "difficulty": "1", - "txCount": 1, - "txs": [ - { - "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "vin": [ - { - "n": 0, - "isAddress": false, - "value": "0" - } - ], - "vout": [ - { - "value": "5000000000", - "n": 0, - "addresses": [ - "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX" - ], - "isAddress": true - } - ], - "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "blockHeight": 1, - "confirmations": 784303, - "blockTime": 1231469665, - "value": "5000000000", - "valueIn": "0", - "fees": "0" - } - ] - } - } - } - } - }, - "description": "OK" - } - }, - "operationId": "getBlockV2", - "description": "Returns information about block with transactions, subject to paging.\n\nNote: Blockbook always follows the main chain of the backend it is attached to. If there is a rollback-reorg in the backend, Blockbook will also do rollback. When you ask for block by height, you will always get the main chain block. If you ask for block by hash, you may get the block from another fork but it is not guaranteed (backend may not keep it)", - "parameters": [ - { - "$ref": "#/components/parameters/page" - }, - { - "$ref": "#/components/parameters/pageSize" - } - ], - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } - }, - "/api/v2/block-index/{blockHeight}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/blockHeight" - } - ], - "get": { - "summary": "Block hash", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "blockHash": { - "type": "string" - } - }, - "x-examples": { - "Example 1": { - "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e" - } - } - }, - "examples": { - "Example 1": { - "value": { - "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e" - } - } - } - } - } - } - }, - "operationId": "getBlockHashV2", - "description": "Get block hash by its height\n\nNote: Blockbook always follows the main chain of the backend it is attached to.", - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } - }, - "/api/v2/tx-specific/{txId}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/txId" - } - ], - "get": { - "summary": "Transaction", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true - }, - "examples": { - "zCash": { - "value": { - "hex": "040000808...8e6e73cb009", - "txid": "7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913", - "overwintered": true, - "version": 4, - "versiongroupid": "892f2085", - "locktime": 0, - "expiryheight": 495680, - "vin": [], - "vout": [], - "vjoinsplit": [], - "valueBalance": 0, - "vShieldedSpend": [ - { - "cv": "50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962", - "anchor": "6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b", - "nullifier": "08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a", - "rk": "36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2", - "proof": "aecf824dbae8eea863ec6...73878c37391f01df520aa", - "spendAuthSig": "65b9477cb1ec5da...1178fe402e5702c646945197108339609" - }, - { - "cv": "a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c", - "anchor": "6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b", - "nullifier": "60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9", - "rk": "2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117", - "proof": "a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7", - "spendAuthSig": "feea902e01eac9ebd...b43b4af6b607ce5b0b38f708" - } - ], - "vShieldedOutput": [ - { - "cv": "23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab", - "cmu": "3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc", - "ephemeralKey": "057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870", - "encCiphertext": "a533d3b99b...a0204", - "outCiphertext": "4baabc15199504b1...c1ad6a", - "proof": "aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1" - } - ], - "bindingSig": "bc018af8808387...5130bb382ad8e6e73cb009", - "blockhash": "0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af", - "confirmations": 5222, - "time": 1552301566, - "blocktime": 1552301566 - } - } - } - } - } - } - }, - "operationId": "getTxSpecificV2", - "description": "Returns transaction data in the exact format as returned by backend, including all coin specific fields", - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } - }, - "/api/v2/address/{address}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/address" - } - ], - "get": { - "summary": "Address", - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ], - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "additionalProperties": true - }, - "examples": { - "Bitcoin-like, details set to \"txids\"": { - "value": { - "page": 1, - "totalPages": 1, - "itemsOnPage": 1000, - "address": "D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7", - "balance": "2432468097999991", - "totalReceived": "3992283916999979", - "totalSent": "1559815818999988", - "unconfirmedBalance": "0", - "unconfirmedTxs": 0, - "txs": 3, - "txids": [ - "461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308", - "bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10", - "5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d" - ] - } - } - } - } - } - } - }, - "operationId": "getAddressV2", - "description": "Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.\n\nThe **details** query parameter can specify the level of details returned by the request (default: \"txids\").\nPossible values are:\n\n**basic**: return only xpub balances, without any derived addresses and transactions\n\n**tokens**: basic + tokens (addresses) derived from the xpub, subject to tokens parameter\n\n**tokenBalances**: basic + tokens (addresses) derived from the xpub with balances, subject to tokens parameter\n\n**txids**: tokenBalances + list of txids, subject to from, to filter and paging\n\n**txs**: tokenBalances + list of transaction with details, subject to from, to filter and paging\n", - "parameters": [ - { - "$ref": "#/components/parameters/page" - }, - { - "$ref": "#/components/parameters/pageSize" - }, - { - "$ref": "#/components/parameters/fromBlock" - }, - { - "$ref": "#/components/parameters/toBlock" - }, - { - "$ref": "#/components/parameters/details" - } - ] - } - }, - "/api/v2/xpub/{xpub}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/xpub" - } - ], - "get": { - "summary": "Xpub", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "page": { - "type": "integer" - }, - "totalPages": { - "type": "integer" - }, - "itemsOnPage": { - "type": "integer" - }, - "address": { - "type": "string" - }, - "balance": { - "type": "string" - }, - "totalReceived": { - "type": "string" - }, - "totalSent": { - "type": "string" - }, - "unconfirmedBalance": { - "type": "string" - }, - "unconfirmedTxs": { - "type": "integer" - }, - "txs": { - "type": "integer" - }, - "txids": { - "type": "array", - "items": { - "type": "string" - } - }, - "usedTokens": { - "type": "integer" - }, - "tokens": { - "type": "array", - "items": { - "type": "object", - "properties": { - "type": { - "type": "string" - }, - "name": { - "type": "string" - }, - "path": { - "type": "string" - }, - "transfers": { - "type": "integer" - }, - "decimals": { - "type": "integer" - }, - "balance": { - "type": "string" - }, - "totalReceived": { - "type": "string" - }, - "totalSent": { - "type": "string" - } - } - } - }, - "secondaryValue": { - "type": "number" - } - }, - "x-examples": { - "Example 1": { - "page": 1, - "totalPages": 1, - "itemsOnPage": 1000, - "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", - "balance": "90000000", - "totalReceived": "3093381250", - "totalSent": "3083381250", - "unconfirmedBalance": "0", - "unconfirmedTxs": 0, - "txs": 5, - "txids": [ - "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", - "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", - "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", - "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", - "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f" - ], - "usedTokens": 2, - "tokens": [ - { - "type": "XPUBAddress", - "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", - "path": "m/44'/3'/0'/0/0", - "transfers": 3, - "decimals": 8, - "balance": "90000000", - "totalReceived": "2903986975", - "totalSent": "2803986975" - }, - { - "type": "XPUBAddress", - "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", - "path": "m/44'/3'/0'/1/0", - "transfers": 2, - "decimals": 8, - "balance": "0", - "totalReceived": "279394275", - "totalSent": "279394275" - } - ], - "secondaryValue": 21195.47633568 - } - } - }, - "examples": { - "Example 1": { - "value": { - "page": 1, - "totalPages": 1, - "itemsOnPage": 1000, - "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", - "balance": "90000000", - "totalReceived": "3093381250", - "totalSent": "3083381250", - "unconfirmedBalance": "0", - "unconfirmedTxs": 0, - "txs": 5, - "txids": [ - "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", - "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", - "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", - "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", - "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f" - ], - "usedTokens": 2, - "tokens": [ - { - "type": "XPUBAddress", - "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", - "path": "m/44'/3'/0'/0/0", - "transfers": 3, - "decimals": 8, - "balance": "90000000", - "totalReceived": "2903986975", - "totalSent": "2803986975" - }, - { - "type": "XPUBAddress", - "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", - "path": "m/44'/3'/0'/1/0", - "transfers": 2, - "decimals": 8, - "balance": "0", - "totalReceived": "279394275", - "totalSent": "279394275" - } - ], - "secondaryValue": 21195.47633568 - } - } - } - } - } - } - }, - "operationId": "getXpubV2", - "description": "Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins.\n\nBlockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation schemes, using either xpubs or output descriptors (see https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md)\n\nNote: usedTokens always returns total number of used addresses of xpub.\n\nDetailed documentation found here: https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub", - "parameters": [ - { - "$ref": "#/components/parameters/page" - }, - { - "$ref": "#/components/parameters/pageSize" - }, - { - "$ref": "#/components/parameters/fromBlock" - }, - { - "$ref": "#/components/parameters/toBlock" - }, - { - "$ref": "#/components/parameters/details" - }, - { - "$ref": "#/components/parameters/tokens" - }, - { - "$ref": "#/components/parameters/secondary" - } - ], - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } - }, - "/api/v2/utxo/{addressOrXpub}": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "parameters": [ - { - "$ref": "#/components/parameters/addressOrXpub" - } - ], - "get": { - "summary": "UTXOs", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "array", - "items": {} - }, - "examples": { - "Example 1": { - "value": [ - { - "txid": "13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9", - "vout": 0, - "value": "1422303206539", - "confirmations": 0, - "lockTime": 2648100 - }, - { - "txid": "a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac", - "vout": 1, - "value": "39748685", - "height": 2648043, - "confirmations": 47, - "coinbase": true - }, - { - "txid": "de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef", - "vout": 0, - "value": "122492339065", - "height": 2646043, - "confirmations": 2047 - }, - { - "txid": "9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9", - "vout": 0, - "value": "142771322208", - "height": 2644885, - "confirmations": 3205 - } - ] - } - } - } - } - } - }, - "operationId": "getUTXOV2", - "description": "Returns array of unspent transaction outputs of address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions. The query parameter confirmed=true disables return of unconfirmed transactions. The returned utxos are sorted by block height, newest blocks first. For xpubs or output descriptors, the response also contains address and derivation path of the utxo.\n\n\n\nUnconfirmed utxos do not have field height, the field confirmations has value 0 and may contain field lockTime, if not zero.\n\nCoinbase utxos have field coinbase set to true, however due to performance reasons only up to minimum coinbase confirmations limit (100). After this limit, utxos are not detected as coinbase.", - "parameters": [ - { - "$ref": "#/components/parameters/confirmed" - } - ], - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } - }, - "/api/v2/sendtx": { - "servers": [ - { - "url": "https://bitcoin-mainnet.blockfrost.io" - }, - { - "url": "https://litecoin-mainnet.blockfrost.io" - }, - { - "url": "https://dogecoin-mainnet.blockfrost.io" - } - ], - "post": { - "summary": "Submit transaction", - "operationId": "postSendTxV2", - "responses": { - "200": { - "description": "OK", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "result": { - "type": "string" - } - }, - "x-examples": { - "Example 1": { - "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25" - } - } - }, - "examples": { - "Example 1": { - "value": { - "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25" - } - } - } - } - } - } - }, - "description": "Sends new transaction to backend for broadcasting\n", - "requestBody": { - "content": { - "text/plain": { - "schema": { - "type": "object", - "properties": {} - } - } - }, - "description": "Transaction hex as plain text" - }, - "tags": [ - "Bitcoin", - "Litecoin", - "Dogecoin" - ] - } } }, "components": { @@ -18755,7 +17663,7 @@ "type": "integer", "example": 1 }, - "description": "specifies page of returned transactions, starting from 1. If out of range, Blockbook returns the closest possible page." + "description": "specifies page of returned transactions, starting from 1. If out of range, the closest possible page is returned." }, "pageSize": { "name": "pageSize", @@ -18763,9 +17671,12 @@ "required": false, "schema": { "type": "integer", + "minimum": 1, + "maximum": 1000, + "default": 1000, "example": 1000 }, - "description": "number of transactions returned by call (default and maximum 1000)" + "description": "Number of items returned per page (1-1000, default 1000)" }, "blockHeight": { "name": "blockHeight", @@ -18814,7 +17725,7 @@ "default": "txids", "example": "basic" }, - "description": "specifies level of details returned by request" + "description": "Level of detail in the response. Possible values:\n`basic` — address balances only (balance, totalReceived, totalSent, txs count), no pagination, no transaction data;\n`txids` — (default) adds pagination and a txids array of transaction hashes, subject to from/to filter and page/pageSize paging;\n`txslight` — replaces txids with lightweight transaction objects (vin/vout with addresses and values, block info, fees), subject to paging;\n`txs` — full transaction details including version, lockTime, size, vsize, and raw hex, subject to paging.\n" }, "fromBlock": { "name": "fromBlock", @@ -18824,7 +17735,7 @@ "type": "integer", "example": 10 }, - "description": "filter of the returned transactions from block height to block height (default no filter)" + "description": "Filter results from this block height (inclusive). Default is no filter." }, "toBlock": { "name": "toBlock", @@ -18834,7 +17745,7 @@ "type": "integer", "example": 100 }, - "description": "filter of the returned transactions from block height to block height (default no filter)" + "description": "Filter results up to this block height (inclusive). Default is no filter." }, "secondary": { "name": "secondary", @@ -18844,7 +17755,7 @@ "type": "string", "example": "usd" }, - "description": "specifies secondary (fiat) currency in which the token and total balances are returned in addition to crypto values" + "description": "Fiat currency code (e.g. `usd`, `eur`) to include fiat values alongside crypto balances in the response." }, "xpub": { "name": "xpub", @@ -18854,7 +17765,7 @@ "type": "string", "example": "tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN" }, - "description": "xpub or output descriptor, applicable only for Bitcoin-type coins" + "description": "Extended public key (xpub, ypub, zpub) or output descriptor. Regular addresses are not accepted — use the /address endpoint instead." }, "tokens": { "name": "tokens", @@ -18870,7 +17781,7 @@ ], "example": "used" }, - "description": "specifies what tokens (xpub addresses) are returned by the request (default nonzero)" + "description": "Controls which derived addresses (BIP44 child addresses) are included in the xpub response.\n`nonzero` — (default) only addresses with non-zero balance;\n`used` — all addresses with at least one transaction, including zero balance;\n`derived` — all addresses in the derivation gap, including never-used ones.\n" }, "confirmed": { "name": "confirmed", @@ -18880,7 +17791,7 @@ "type": "boolean", "example": true }, - "description": "confirmed=true disables return of unconfirmed transactions" + "description": "Set to `true` to exclude unconfirmed UTXOs from the response." }, "hex": { "name": "hex", diff --git a/openapi.yaml b/openapi.yaml index cf0ed827..2632284e 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -38,45 +38,52 @@ info: - - + + - - + + - - + + - - + + - - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + +
- Network - - Endpoint - NetworkEndpoint
Cardano mainnet - https://cardano-mainnet.blockfrost.io/api/v0 - Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano preprod - https://cardano-preprod.blockfrost.io/api/v0 - Cardano preprodhttps://cardano-preprod.blockfrost.io/api/v0
Cardano preview - https://cardano-preview.blockfrost.io/api/v0 - Cardano previewhttps://cardano-preview.blockfrost.io/api/v0
Midnight mainnet - https://midnight-mainnet.blockfrost.io/api/v0 - Bitcoin mainnet - https://bitcoin-mainnet.blockfrost.io/api/v2 - Midnight mainnethttps://midnight-mainnet.blockfrost.io/api/v0
InterPlanetary File System - https://ipfs.blockfrost.io/api/v0 - Midnight preprodhttps://midnight-preprod.blockfrost.io/api/v0
Midnight previewhttps://midnight-preview.blockfrost.io/api/v0
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
InterPlanetary File Systemhttps://ipfs.blockfrost.io/api/v0
@@ -339,86 +346,62 @@ info: [![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/) -servers: - - url: 'https://cardano-mainnet.blockfrost.io/api/v0' - description: Cardano Mainnet network - - url: 'https://cardano-preprod.blockfrost.io/api/v0' - description: Cardano Preprod network - - url: 'https://cardano-preview.blockfrost.io/api/v0' - description: Cardano Preview network - - url: 'https://localhost:3000' - description: local -security: - - project_id: [] -tags: - - name: Health - - name: Metrics - - name: Bitcoin - description: > - Blockbook Bitcoin integration allows you to access Bitcoin blockchain - using Blockbook API. - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + ## Bitcoin API - > For example, to retrieve a block data for the first block, you would - use: - `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` + Access the Bitcoin blockchain through the Blockbook API. - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). - - name: Litecoin - description: > - Blockbook Litecoin integration allows you to access Litecoin blockchain - using Blockbook API. + Endpoint: `https://bitcoin-mainnet.blockfrost.io/api/v2` - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + [![Explore the Bitcoin API + →](https://img.shields.io/badge/Explore_the_Bitcoin_API_→-C77800?style=for-the-badge&logo=bitcoin&logoColor=white)](./blockbook/) - > For example, to retrieve a block data for the first block, you would - use: - `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` + ## Litecoin API - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). - - name: Dogecoin - description: > - Blockbook Dogecoin integration allows you to access Dogecoin blockchain - using Blockbook API. + Access the Litecoin blockchain through the Blockbook API. - > **Please note that Blockfrost acts as a proxy for the subset of - Blockbook API endpoints. The API version in the URL corresponds to the - deployed Blockbook API version, which is currently V2..** + Endpoint: `https://litecoin-mainnet.blockfrost.io/api/v2` - > For example, to retrieve a block data for the first block, you would - use: + [![Explore the Litecoin API + →](https://img.shields.io/badge/Explore_the_Litecoin_API_→-345D9D?style=for-the-badge&logo=litecoin&logoColor=white)](./blockbook/) - `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` - In addition to error responses listed in Blockbook endpoints (such as - `404`, `412` and `500`), the API may also return error responses related - to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated - request). For the full list of Blockfrost error status codes, please see - [Blockfrost Errors](#section/Errors). + ## Dogecoin API + + + Access the Dogecoin blockchain through the Blockbook API. + + + Endpoint: `https://dogecoin-mainnet.blockfrost.io/api/v2` + + + [![Explore the Dogecoin API + →](https://img.shields.io/badge/Explore_the_Dogecoin_API_→-9B7E1A?style=for-the-badge&logo=dogecoin&logoColor=white)](./blockbook/) +servers: + - url: 'https://cardano-mainnet.blockfrost.io/api/v0' + description: Cardano Mainnet network + - url: 'https://cardano-preprod.blockfrost.io/api/v0' + description: Cardano Preprod network + - url: 'https://cardano-preview.blockfrost.io/api/v0' + description: Cardano Preview network + - url: 'https://localhost:3000' + description: local +security: + - project_id: [] +tags: + - name: Health + - name: Metrics - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets @@ -6978,850 +6961,6 @@ paths: $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' - /api/v2/status: - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - get: - tags: - - Bitcoin - - Litecoin - - Dogecoin - summary: Blockchain status - operationId: getStatus - description: Get current status of Blockbook and its backend - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - blockbook: - type: object - properties: - coin: - type: string - network: - type: string - host: - type: string - version: - type: string - gitCommit: - type: string - buildTime: - type: string - syncMode: - type: boolean - initialSync: - type: boolean - inSync: - type: boolean - bestHeight: - type: integer - lastBlockTime: - type: string - inSyncMempool: - type: boolean - lastMempoolTime: - type: string - mempoolSize: - type: integer - decimals: - type: integer - dbSize: - type: integer - hasFiatRates: - type: boolean - currentFiatRatesTime: - type: string - historicalFiatRatesTime: - type: string - about: - type: string - backend: - type: object - properties: - chain: - type: string - blocks: - type: integer - headers: - type: integer - bestBlockHash: - type: string - difficulty: - type: string - sizeOnDisk: - type: integer - version: - type: string - subversion: - type: string - protocolVersion: - type: string - x-examples: - Example 1: - blockbook: - coin: Bitcoin - host: s4 - version: 0.4.0 - gitCommit: 83fe6672 - buildTime: '2023-02-27T02:40:48+00:00' - syncMode: true - initialSync: false - inSync: true - bestHeight: 784299 - lastBlockTime: '2023-04-07T02:55:40.032567054Z' - inSyncMempool: true - lastMempoolTime: '2023-04-07T03:04:36.260327616Z' - mempoolSize: 30785 - decimals: 8 - dbSize: 399834379691 - hasFiatRates: true - currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' - historicalFiatRatesTime: '2023-04-07T00:00:00Z' - about: >- - Blockbook blockchain indexer for https://chain49.com/ - - based on trezor/blockbook - backend: - chain: main - blocks: 784299 - headers: 784299 - bestBlockHash: >- - 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 - difficulty: '47887764338536.25' - sizeOnDisk: 534828732178 - version: '240001' - subversion: '/Satoshi:24.0.1/' - protocolVersion: '70016' - examples: - Example 1: - value: - blockbook: - coin: Bitcoin - host: s4 - version: 0.4.0 - gitCommit: 83fe6672 - buildTime: '2023-02-27T02:40:48+00:00' - syncMode: true - initialSync: false - inSync: true - bestHeight: 784299 - lastBlockTime: '2023-04-07T02:55:40.032567054Z' - inSyncMempool: true - lastMempoolTime: '2023-04-07T03:04:36.260327616Z' - mempoolSize: 30785 - decimals: 8 - dbSize: 399834379691 - hasFiatRates: true - currentFiatRatesTime: '2023-04-07T03:00:04.080770962Z' - historicalFiatRatesTime: '2023-04-07T00:00:00Z' - about: >- - Blockbook blockchain indexer for https://chain49.com/ - - based on trezor/blockbook - backend: - chain: main - blocks: 784299 - headers: 784299 - bestBlockHash: >- - 00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719 - difficulty: '47887764338536.25' - sizeOnDisk: 534828732178 - version: '240001' - subversion: '/Satoshi:24.0.1/' - protocolVersion: '70016' - '/api/v2/block/{blockHashOrHeight}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/blockHashOrHeight' - get: - summary: Block - responses: - '200': - content: - application/json: - schema: - type: object - properties: - page: - type: integer - totalPages: - type: integer - itemsOnPage: - type: integer - hash: - type: string - previousBlockHash: - type: string - nextBlockHash: - type: string - height: - type: integer - confirmations: - type: integer - size: - type: integer - time: - type: integer - version: - type: integer - merkleRoot: - type: string - nonce: - type: string - bits: - type: string - difficulty: - type: string - txCount: - type: integer - txs: - type: array - items: - type: object - properties: - txid: - type: string - vin: - type: array - items: - type: object - properties: - 'n': - type: integer - isAddress: - type: boolean - value: - type: string - vout: - type: array - items: - type: object - properties: - value: - type: string - 'n': - type: integer - addresses: - type: array - items: - type: string - isAddress: - type: boolean - blockHash: - type: string - blockHeight: - type: integer - confirmations: - type: integer - blockTime: - type: integer - value: - type: string - valueIn: - type: string - fees: - type: string - x-examples: - Example 1: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - hash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - previousBlockHash: >- - 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f - nextBlockHash: >- - 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd - height: 1 - confirmations: 784303 - size: 215 - time: 1231469665 - version: 1 - merkleRoot: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - nonce: '2573394689' - bits: 1d00ffff - difficulty: '1' - txCount: 1 - txs: - - txid: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - vin: - - 'n': 0 - isAddress: false - value: '0' - vout: - - value: '5000000000' - 'n': 0 - addresses: - - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX - isAddress: true - blockHash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - blockHeight: 1 - confirmations: 784303 - blockTime: 1231469665 - value: '5000000000' - valueIn: '0' - fees: '0' - examples: - Example 1: - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - hash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - previousBlockHash: >- - 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f - nextBlockHash: >- - 000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd - height: 1 - confirmations: 784303 - size: 215 - time: 1231469665 - version: 1 - merkleRoot: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - nonce: '2573394689' - bits: 1d00ffff - difficulty: '1' - txCount: 1 - txs: - - txid: >- - 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098 - vin: - - 'n': 0 - isAddress: false - value: '0' - vout: - - value: '5000000000' - 'n': 0 - addresses: - - 12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX - isAddress: true - blockHash: >- - 00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048 - blockHeight: 1 - confirmations: 784303 - blockTime: 1231469665 - value: '5000000000' - valueIn: '0' - fees: '0' - description: OK - operationId: getBlockV2 - description: >- - Returns information about block with transactions, subject to paging. - - - Note: Blockbook always follows the main chain of the backend it is - attached to. If there is a rollback-reorg in the backend, Blockbook will - also do rollback. When you ask for block by height, you will always get - the main chain block. If you ask for block by hash, you may get the - block from another fork but it is not guaranteed (backend may not keep - it) - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/block-index/{blockHeight}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/blockHeight' - get: - summary: Block hash - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - blockHash: - type: string - x-examples: - Example 1: - blockHash: >- - ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e - examples: - Example 1: - value: - blockHash: >- - ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e - operationId: getBlockHashV2 - description: >- - Get block hash by its height - - - Note: Blockbook always follows the main chain of the backend it is - attached to. - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/tx-specific/{txId}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/txId' - get: - summary: Transaction - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - additionalProperties: true - examples: - zCash: - value: - hex: 040000808...8e6e73cb009 - txid: >- - 7a0a0ff6f67bac2a856c7296382b69151949878de6fb0d01a8efa197182b2913 - overwintered: true - version: 4 - versiongroupid: 892f2085 - locktime: 0 - expiryheight: 495680 - vin: [] - vout: [] - vjoinsplit: [] - valueBalance: 0 - vShieldedSpend: - - cv: >- - 50258bfa65caa9f42f4448b9194840c7da73afc8159faf7358140bfd0f237962 - anchor: >- - 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: >- - 08e5717f6606af7c2b01206ff833eaa6383bb49c7451534b2e16d588956fd10a - rk: >- - 36841a9be87a7022445b77f433cdd0355bbed498656ab399aede1e5285e9e4a2 - proof: aecf824dbae8eea863ec6...73878c37391f01df520aa - spendAuthSig: 65b9477cb1ec5da...1178fe402e5702c646945197108339609 - - cv: >- - a5aab3721e33d6d6360eabd21cbd07524495f202149abdc3eb30f245d503678c - anchor: >- - 6beb3b64ecb30033a9032e1a65a68899917625d1fdd2540e70f19f3078f5dd9b - nullifier: >- - 60e790d6d0e12e777fb2b18bc97cf42a92b1e47460e1bd0b0ffd294c23232cc9 - rk: >- - 2d741695e76351597712b4a04d2a4e108a116f376283d2d104219b86e2930117 - proof: >- - a0c2a6fdcbba966b9894...3a9c3118b76c8e2352d524cbb44c02decaeda7 - spendAuthSig: feea902e01eac9ebd...b43b4af6b607ce5b0b38f708 - vShieldedOutput: - - cv: >- - 23db384cde862f20238a1004e57ba18f114acabc7fd2ac029757f82af5bd4cab - cmu: >- - 3ff5a5ff521fabefb5287fef4feb2642d69ead5fe18e6ac717cfd76a8d4088bc - ephemeralKey: >- - 057ff6e059967784fa6ac34ad9ecfd9c0c0aba743b7cd444a65ecc32192d5870 - encCiphertext: a533d3b99b...a0204 - outCiphertext: 4baabc15199504b1...c1ad6a - proof: >- - aa1fb2706cba5...1ec7e81f5deea90d4f57713f3b4fc8d636908235fa378ebf1 - bindingSig: bc018af8808387...5130bb382ad8e6e73cb009 - blockhash: >- - 0000000001c4aa394e796dd1b82e358f114535204f6f5b6cf4ad58dc439c47af - confirmations: 5222 - time: 1552301566 - blocktime: 1552301566 - operationId: getTxSpecificV2 - description: >- - Returns transaction data in the exact format as returned by backend, - including all coin specific fields - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/address/{address}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/address' - get: - summary: Address - tags: - - Bitcoin - - Litecoin - - Dogecoin - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - additionalProperties: true - examples: - 'Bitcoin-like, details set to "txids"': - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: D5Z7XrtJNg7hAtznSDMXvfiFmMYphwuWz7 - balance: '2432468097999991' - totalReceived: '3992283916999979' - totalSent: '1559815818999988' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 3 - txids: - - >- - 461dd46d5d6f56d765f82e60e6bf0727a3a1d1cb8c4144373d805b152a21d308 - - >- - bdb5b47603c5d174eae3384c368068c8e9d2183b398ed0e31d125defa4447a10 - - >- - 5c1d2686d70d82bd8e84b5d3dc4bd0e8485e28cdc865336db6a5e40b2098277d - operationId: getAddressV2 - description: > - Returns balances and transactions of an address. The returned - transactions are sorted by block height, newest blocks first. - - - The **details** query parameter can specify the level of details - returned by the request (default: "txids"). - - Possible values are: - - - **basic**: return only xpub balances, without any derived addresses and - transactions - - - **tokens**: basic + tokens (addresses) derived from the xpub, subject to - tokens parameter - - - **tokenBalances**: basic + tokens (addresses) derived from the xpub with - balances, subject to tokens parameter - - - **txids**: tokenBalances + list of txids, subject to from, to filter and - paging - - - **txs**: tokenBalances + list of transaction with details, subject to - from, to filter and paging - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/fromBlock' - - $ref: '#/components/parameters/toBlock' - - $ref: '#/components/parameters/details' - '/api/v2/xpub/{xpub}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/xpub' - get: - summary: Xpub - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - page: - type: integer - totalPages: - type: integer - itemsOnPage: - type: integer - address: - type: string - balance: - type: string - totalReceived: - type: string - totalSent: - type: string - unconfirmedBalance: - type: string - unconfirmedTxs: - type: integer - txs: - type: integer - txids: - type: array - items: - type: string - usedTokens: - type: integer - tokens: - type: array - items: - type: object - properties: - type: - type: string - name: - type: string - path: - type: string - transfers: - type: integer - decimals: - type: integer - balance: - type: string - totalReceived: - type: string - totalSent: - type: string - secondaryValue: - type: number - x-examples: - Example 1: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: >- - dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF - balance: '90000000' - totalReceived: '3093381250' - totalSent: '3083381250' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 5 - txids: - - >- - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c - - >- - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 - - >- - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 - - >- - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 - - >- - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f - usedTokens: 2 - tokens: - - type: XPUBAddress - name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS - path: m/44'/3'/0'/0/0 - transfers: 3 - decimals: 8 - balance: '90000000' - totalReceived: '2903986975' - totalSent: '2803986975' - - type: XPUBAddress - name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj - path: m/44'/3'/0'/1/0 - transfers: 2 - decimals: 8 - balance: '0' - totalReceived: '279394275' - totalSent: '279394275' - secondaryValue: 21195.47633568 - examples: - Example 1: - value: - page: 1 - totalPages: 1 - itemsOnPage: 1000 - address: >- - dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF - balance: '90000000' - totalReceived: '3093381250' - totalSent: '3083381250' - unconfirmedBalance: '0' - unconfirmedTxs: 0 - txs: 5 - txids: - - >- - 383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c - - >- - 75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798 - - >- - e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876 - - >- - 57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23 - - >- - 9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f - usedTokens: 2 - tokens: - - type: XPUBAddress - name: DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS - path: m/44'/3'/0'/0/0 - transfers: 3 - decimals: 8 - balance: '90000000' - totalReceived: '2903986975' - totalSent: '2803986975' - - type: XPUBAddress - name: DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj - path: m/44'/3'/0'/1/0 - transfers: 2 - decimals: 8 - balance: '0' - totalReceived: '279394275' - totalSent: '279394275' - secondaryValue: 21195.47633568 - operationId: getXpubV2 - description: >- - Returns balances and transactions of an xpub or output descriptor, - applicable only for Bitcoin-type coins. - - - Blockbook supports BIP44, BIP49, BIP84 and BIP86 (Taproot) derivation - schemes, using either xpubs or output descriptors (see - https://github.com/bitcoin/bitcoin/blob/master/doc/descriptors.md) - - - Note: usedTokens always returns total number of used addresses of xpub. - - - Detailed documentation found here: - https://github.com/trezor/blockbook/blob/master/docs/api.md#get-xpub - parameters: - - $ref: '#/components/parameters/page' - - $ref: '#/components/parameters/pageSize' - - $ref: '#/components/parameters/fromBlock' - - $ref: '#/components/parameters/toBlock' - - $ref: '#/components/parameters/details' - - $ref: '#/components/parameters/tokens' - - $ref: '#/components/parameters/secondary' - tags: - - Bitcoin - - Litecoin - - Dogecoin - '/api/v2/utxo/{addressOrXpub}': - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - parameters: - - $ref: '#/components/parameters/addressOrXpub' - get: - summary: UTXOs - responses: - '200': - description: OK - content: - application/json: - schema: - type: array - items: {} - examples: - Example 1: - value: - - txid: >- - 13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9 - vout: 0 - value: '1422303206539' - confirmations: 0 - lockTime: 2648100 - - txid: >- - a79e396a32e10856c97b95f43da7e9d2b9a11d446f7638dbd75e5e7603128cac - vout: 1 - value: '39748685' - height: 2648043 - confirmations: 47 - coinbase: true - - txid: >- - de4f379fdc3ea9be063e60340461a014f372a018d70c3db35701654e7066b3ef - vout: 0 - value: '122492339065' - height: 2646043 - confirmations: 2047 - - txid: >- - 9e8eb9b3d2e8e4b5d6af4c43a9196dfc55a05945c8675904d8c61f404ea7b1e9 - vout: 0 - value: '142771322208' - height: 2644885 - confirmations: 3205 - operationId: getUTXOV2 - description: >- - Returns array of unspent transaction outputs of address or xpub, - applicable only for Bitcoin-type coins. By default, the list contains - both confirmed and unconfirmed transactions. The query parameter - confirmed=true disables return of unconfirmed transactions. The returned - utxos are sorted by block height, newest blocks first. For xpubs or - output descriptors, the response also contains address and derivation - path of the utxo. - - - - - Unconfirmed utxos do not have field height, the field confirmations has - value 0 and may contain field lockTime, if not zero. - - - Coinbase utxos have field coinbase set to true, however due to - performance reasons only up to minimum coinbase confirmations limit - (100). After this limit, utxos are not detected as coinbase. - parameters: - - $ref: '#/components/parameters/confirmed' - tags: - - Bitcoin - - Litecoin - - Dogecoin - /api/v2/sendtx: - servers: - - url: 'https://bitcoin-mainnet.blockfrost.io' - - url: 'https://litecoin-mainnet.blockfrost.io' - - url: 'https://dogecoin-mainnet.blockfrost.io' - post: - summary: Submit transaction - operationId: postSendTxV2 - responses: - '200': - description: OK - content: - application/json: - schema: - type: object - properties: - result: - type: string - x-examples: - Example 1: - result: >- - 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 - examples: - Example 1: - value: - result: >- - 7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25 - description: | - Sends new transaction to backend for broadcasting - requestBody: - content: - text/plain: - schema: - type: object - properties: {} - description: Transaction hex as plain text - tags: - - Bitcoin - - Litecoin - - Dogecoin components: schemas: onchain_metadata_cip25: @@ -14629,15 +13768,18 @@ components: example: 1 description: >- specifies page of returned transactions, starting from 1. If out of - range, Blockbook returns the closest possible page. + range, the closest possible page is returned. pageSize: name: pageSize in: query required: false schema: type: integer + minimum: 1 + maximum: 1000 + default: 1000 example: 1000 - description: number of transactions returned by call (default and maximum 1000) + description: 'Number of items returned per page (1-1000, default 1000)' blockHeight: name: blockHeight in: path @@ -14677,7 +13819,21 @@ components: - txs default: txids example: basic - description: specifies level of details returned by request + description: > + Level of detail in the response. Possible values: + + `basic` — address balances only (balance, totalReceived, totalSent, txs + count), no pagination, no transaction data; + + `txids` — (default) adds pagination and a txids array of transaction + hashes, subject to from/to filter and page/pageSize paging; + + `txslight` — replaces txids with lightweight transaction objects + (vin/vout with addresses and values, block info, fees), subject to + paging; + + `txs` — full transaction details including version, lockTime, size, + vsize, and raw hex, subject to paging. fromBlock: name: fromBlock in: query @@ -14685,9 +13841,7 @@ components: schema: type: integer example: 10 - description: >- - filter of the returned transactions from block height to block height - (default no filter) + description: Filter results from this block height (inclusive). Default is no filter. toBlock: name: toBlock in: query @@ -14696,8 +13850,8 @@ components: type: integer example: 100 description: >- - filter of the returned transactions from block height to block height - (default no filter) + Filter results up to this block height (inclusive). Default is no + filter. secondary: name: secondary in: query @@ -14706,8 +13860,8 @@ components: type: string example: usd description: >- - specifies secondary (fiat) currency in which the token and total - balances are returned in addition to crypto values + Fiat currency code (e.g. `usd`, `eur`) to include fiat values alongside + crypto balances in the response. xpub: name: xpub in: path @@ -14716,7 +13870,9 @@ components: type: string example: >- tpubDC88gkaZi5HvJGxGDNLADkvtdpni3mLmx6vr2KnXmWMG8zfkBRggsxHVBkUpgcwPe2KKpkyvTJCdXHb1UHEWE64vczyyPQfHr1skBcsRedN - description: 'xpub or output descriptor, applicable only for Bitcoin-type coins' + description: >- + Extended public key (xpub, ypub, zpub) or output descriptor. Regular + addresses are not accepted — use the /address endpoint instead. tokens: name: tokens in: query @@ -14729,9 +13885,17 @@ components: - used - derived example: used - description: >- - specifies what tokens (xpub addresses) are returned by the request - (default nonzero) + description: > + Controls which derived addresses (BIP44 child addresses) are included in + the xpub response. + + `nonzero` — (default) only addresses with non-zero balance; + + `used` — all addresses with at least one transaction, including zero + balance; + + `derived` — all addresses in the derivation gap, including never-used + ones. confirmed: name: confirmed in: query @@ -14739,7 +13903,7 @@ components: schema: type: boolean example: true - description: confirmed=true disables return of unconfirmed transactions + description: Set to `true` to exclude unconfirmed UTXOs from the response. hex: name: hex in: path diff --git a/package.json b/package.json index b766d690..4184b13a 100644 --- a/package.json +++ b/package.json @@ -15,8 +15,9 @@ "build": "yarn sync-version && rimraf lib && yarn tsc && yarn bundle && yarn generate-types && yarn generate-json-schema", "copy-spec": "cp ./openapi.yaml ./docs/blockfrost-openapi.yaml", "lint": "scalar validate ./src/definitions.yaml", - "bundle": "yarn redocly bundle -o ./blockfrost-openapi.yaml src/definitions.yaml && yarn openapi-merge-cli && yarn redocly bundle -o ./openapi.json ./openapi.yaml && yarn copy-spec && yarn build:midnight-docs", + "bundle": "yarn redocly bundle -o ./blockfrost-openapi.yaml src/definitions.yaml && yarn openapi-merge-cli && yarn redocly bundle -o ./openapi.json ./openapi.yaml && yarn copy-spec && yarn build:midnight-docs && yarn build:blockbook-docs", "build:midnight-docs": "yarn spectaql ./spectaql.yaml && cp ./midnight-indexer-api.graphql ./docs/midnight/midnight-indexer-api.graphql", + "build:blockbook-docs": "cp ./blockbook.yaml ./docs/blockbook/blockbook-openapi.yaml", "generate-types": "yarn openapi-typescript ./blockfrost-openapi.yaml --output ./src/generated-types.ts", "generate-types:rust": "openapi-generator-cli generate -i openapi.yaml -g rust -o ./rust -c rust/openapi-generator.json --global-property models,modelDocs=false,apis=false,apiDocs=false,supportingFiles && node rust/fix-cargo.js", "generate-json-schema": "node lib/scripts/generate-json-schema.js > json-schema.json", diff --git a/src/definitions.yaml b/src/definitions.yaml index 3529e06c..93a8942e 100644 --- a/src/definitions.yaml +++ b/src/definitions.yaml @@ -28,45 +28,52 @@ info: - - + + - - + + - - + + - - + + - - - + + - - + + + + + + + + + + + + + + + + + + + + + + + + + +
- Network - - Endpoint - NetworkEndpoint
Cardano mainnet - https://cardano-mainnet.blockfrost.io/api/v0 - Cardano mainnethttps://cardano-mainnet.blockfrost.io/api/v0
Cardano preprod - https://cardano-preprod.blockfrost.io/api/v0 - Cardano preprodhttps://cardano-preprod.blockfrost.io/api/v0
Cardano preview - https://cardano-preview.blockfrost.io/api/v0 - Cardano previewhttps://cardano-preview.blockfrost.io/api/v0
Midnight mainnet - https://midnight-mainnet.blockfrost.io/api/v0 - Bitcoin mainnet - https://bitcoin-mainnet.blockfrost.io/api/v2 - Midnight mainnethttps://midnight-mainnet.blockfrost.io/api/v0
InterPlanetary File System - https://ipfs.blockfrost.io/api/v0 - Midnight preprodhttps://midnight-preprod.blockfrost.io/api/v0
Midnight previewhttps://midnight-preview.blockfrost.io/api/v0
Bitcoin mainnethttps://bitcoin-mainnet.blockfrost.io/api/v2
Bitcoin testnethttps://bitcoin-testnet.blockfrost.io/api/v2
Litecoin mainnethttps://litecoin-mainnet.blockfrost.io/api/v2
Dogecoin mainnethttps://dogecoin-mainnet.blockfrost.io/api/v2
InterPlanetary File Systemhttps://ipfs.blockfrost.io/api/v0
@@ -250,6 +257,33 @@ info: [![Explore the Midnight API →](https://img.shields.io/badge/Explore_the_Midnight_API_→-0033AD?style=for-the-badge)](./midnight/) + + ## Bitcoin API + + Access the Bitcoin blockchain through the Blockbook API. + + Endpoint: `https://bitcoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Bitcoin API →](https://img.shields.io/badge/Explore_the_Bitcoin_API_→-C77800?style=for-the-badge&logo=bitcoin&logoColor=white)](./blockbook/) + + + ## Litecoin API + + Access the Litecoin blockchain through the Blockbook API. + + Endpoint: `https://litecoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Litecoin API →](https://img.shields.io/badge/Explore_the_Litecoin_API_→-345D9D?style=for-the-badge&logo=litecoin&logoColor=white)](./blockbook/) + + + ## Dogecoin API + + Access the Dogecoin blockchain through the Blockbook API. + + Endpoint: `https://dogecoin-mainnet.blockfrost.io/api/v2` + + [![Explore the Dogecoin API →](https://img.shields.io/badge/Explore_the_Dogecoin_API_→-9B7E1A?style=for-the-badge&logo=dogecoin&logoColor=white)](./blockbook/) + servers: - url: https://cardano-mainnet.blockfrost.io/api/v0 description: Cardano Mainnet network @@ -266,36 +300,6 @@ security: tags: - name: Health - name: Metrics - - name: Bitcoin - description: | - Blockbook Bitcoin integration allows you to access Bitcoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://bitcoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - - name: Litecoin - description: | - Blockbook Litecoin integration allows you to access Litecoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://litecoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - - name: Dogecoin - description: | - Blockbook Dogecoin integration allows you to access Dogecoin blockchain using Blockbook API. - - > **Please note that Blockfrost acts as a proxy for the subset of Blockbook API endpoints. The API version in the URL corresponds to the deployed Blockbook API version, which is currently V2..** - - > For example, to retrieve a block data for the first block, you would use: - `https://dogecoin-mainnet.blockfrost.io/api/v2/block/1` - - In addition to error responses listed in Blockbook endpoints (such as `404`, `412` and `500`), the API may also return error responses related to Blockfrost (e.g. `400` for invalid path or `403` for unauthenticated request). For the full list of Blockfrost error status codes, please see [Blockfrost Errors](#section/Errors). - name: Cardano » Accounts - name: Cardano » Addresses - name: Cardano » Assets diff --git a/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap b/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap index 99873ab5..b75fffde 100644 --- a/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap +++ b/test/tests/__snapshots__/get-schema-for-endpoint.test.ts.snap @@ -4546,526 +4546,6 @@ exports[`getSchemaForEndpoint > generateSchemas 1`] = ` }, }, }, - "/api/v2/": { - "response": { - "200": { - "properties": { - "backend": { - "properties": { - "bestBlockHash": { - "type": "string", - }, - "blocks": { - "type": "integer", - }, - "chain": { - "type": "string", - }, - "difficulty": { - "type": "string", - }, - "headers": { - "type": "integer", - }, - "protocolVersion": { - "type": "string", - }, - "sizeOnDisk": { - "type": "integer", - }, - "subversion": { - "type": "string", - }, - "version": { - "type": "string", - }, - }, - "type": "object", - }, - "blockbook": { - "properties": { - "about": { - "type": "string", - }, - "bestHeight": { - "type": "integer", - }, - "buildTime": { - "type": "string", - }, - "coin": { - "type": "string", - }, - "currentFiatRatesTime": { - "type": "string", - }, - "dbSize": { - "type": "integer", - }, - "decimals": { - "type": "integer", - }, - "gitCommit": { - "type": "string", - }, - "hasFiatRates": { - "type": "boolean", - }, - "historicalFiatRatesTime": { - "type": "string", - }, - "host": { - "type": "string", - }, - "inSync": { - "type": "boolean", - }, - "inSyncMempool": { - "type": "boolean", - }, - "initialSync": { - "type": "boolean", - }, - "lastBlockTime": { - "type": "string", - }, - "lastMempoolTime": { - "type": "string", - }, - "mempoolSize": { - "type": "integer", - }, - "syncMode": { - "type": "boolean", - }, - "version": { - "type": "string", - }, - }, - "type": "object", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "backend": { - "bestBlockHash": "00000000000000000000df1072b381603f20d3e6877cf4689c743e90d2dde719", - "blocks": 784299, - "chain": "main", - "difficulty": "47887764338536.25", - "headers": 784299, - "protocolVersion": "70016", - "sizeOnDisk": 534828732178, - "subversion": "/Satoshi:24.0.1/", - "version": "240001", - }, - "blockbook": { - "about": "Blockbook blockchain indexer for https://chain49.com/ - based on trezor/blockbook", - "bestHeight": 784299, - "buildTime": "2023-02-27T02:40:48+00:00", - "coin": "Bitcoin", - "currentFiatRatesTime": "2023-04-07T03:00:04.080770962Z", - "dbSize": 399834379691, - "decimals": 8, - "gitCommit": "83fe6672", - "hasFiatRates": true, - "historicalFiatRatesTime": "2023-04-07T00:00:00Z", - "host": "s4", - "inSync": true, - "inSyncMempool": true, - "initialSync": false, - "lastBlockTime": "2023-04-07T02:55:40.032567054Z", - "lastMempoolTime": "2023-04-07T03:04:36.260327616Z", - "mempoolSize": 30785, - "syncMode": true, - "version": "0.4.0", - }, - }, - }, - }, - }, - }, - "/api/v2/address/{address}": { - "response": { - "200": { - "additionalProperties": true, - "type": "object", - }, - }, - }, - "/api/v2/block-index/{blockHeight}": { - "response": { - "200": { - "properties": { - "blockHash": { - "type": "string", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "blockHash": "ed8f3af8c10ca70a136901c6dd3adf037f0aea8a93fbe9e80939214034300f1e", - }, - }, - }, - }, - }, - "/api/v2/block/{blockHashOrHeight}": { - "response": { - "200": { - "properties": { - "bits": { - "type": "string", - }, - "confirmations": { - "type": "integer", - }, - "difficulty": { - "type": "string", - }, - "hash": { - "type": "string", - }, - "height": { - "type": "integer", - }, - "itemsOnPage": { - "type": "integer", - }, - "merkleRoot": { - "type": "string", - }, - "nextBlockHash": { - "type": "string", - }, - "nonce": { - "type": "string", - }, - "page": { - "type": "integer", - }, - "previousBlockHash": { - "type": "string", - }, - "size": { - "type": "integer", - }, - "time": { - "type": "integer", - }, - "totalPages": { - "type": "integer", - }, - "txCount": { - "type": "integer", - }, - "txs": { - "items": { - "properties": { - "blockHash": { - "type": "string", - }, - "blockHeight": { - "type": "integer", - }, - "blockTime": { - "type": "integer", - }, - "confirmations": { - "type": "integer", - }, - "fees": { - "type": "string", - }, - "txid": { - "type": "string", - }, - "value": { - "type": "string", - }, - "valueIn": { - "type": "string", - }, - "vin": { - "items": { - "properties": { - "isAddress": { - "type": "boolean", - }, - "n": { - "type": "integer", - }, - "value": { - "type": "string", - }, - }, - "type": "object", - }, - "type": "array", - }, - "vout": { - "items": { - "properties": { - "addresses": { - "items": { - "type": "string", - }, - "type": "array", - }, - "isAddress": { - "type": "boolean", - }, - "n": { - "type": "integer", - }, - "value": { - "type": "string", - }, - }, - "type": "object", - }, - "type": "array", - }, - }, - "type": "object", - }, - "type": "array", - }, - "version": { - "type": "integer", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "bits": "1d00ffff", - "confirmations": 784303, - "difficulty": "1", - "hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "height": 1, - "itemsOnPage": 1000, - "merkleRoot": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "nextBlockHash": "000000006a625f06636b8bb6ac7b960a8d03705d1ace08b1a19da3fdcc99ddbd", - "nonce": "2573394689", - "page": 1, - "previousBlockHash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f", - "size": 215, - "time": 1231469665, - "totalPages": 1, - "txCount": 1, - "txs": [ - { - "blockHash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048", - "blockHeight": 1, - "blockTime": 1231469665, - "confirmations": 784303, - "fees": "0", - "txid": "0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098", - "value": "5000000000", - "valueIn": "0", - "vin": [ - { - "isAddress": false, - "n": 0, - "value": "0", - }, - ], - "vout": [ - { - "addresses": [ - "12c6DSiU4Rq3P4ZxziKxzrL5LmMBrzjrJX", - ], - "isAddress": true, - "n": 0, - "value": "5000000000", - }, - ], - }, - ], - "version": 1, - }, - }, - }, - }, - }, - "/api/v2/sendtx": { - "response": { - "200": { - "properties": { - "result": { - "type": "string", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25", - }, - }, - }, - }, - }, - "/api/v2/sendtx/{hex}": { - "response": { - "200": { - "properties": { - "result": { - "type": "string", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25", - }, - }, - }, - }, - }, - "/api/v2/tx-specific/{txId}": { - "response": { - "200": { - "additionalProperties": true, - "type": "object", - }, - }, - }, - "/api/v2/utxo/{addressOrXpub}": { - "response": { - "200": { - "items": {}, - "type": "array", - }, - }, - }, - "/api/v2/xpub/{xpub}": { - "response": { - "200": { - "properties": { - "address": { - "type": "string", - }, - "balance": { - "type": "string", - }, - "itemsOnPage": { - "type": "integer", - }, - "page": { - "type": "integer", - }, - "secondaryValue": { - "type": "number", - }, - "tokens": { - "items": { - "properties": { - "balance": { - "type": "string", - }, - "decimals": { - "type": "integer", - }, - "name": { - "type": "string", - }, - "path": { - "type": "string", - }, - "totalReceived": { - "type": "string", - }, - "totalSent": { - "type": "string", - }, - "transfers": { - "type": "integer", - }, - "type": { - "type": "string", - }, - }, - "type": "object", - }, - "type": "array", - }, - "totalPages": { - "type": "integer", - }, - "totalReceived": { - "type": "string", - }, - "totalSent": { - "type": "string", - }, - "txids": { - "items": { - "type": "string", - }, - "type": "array", - }, - "txs": { - "type": "integer", - }, - "unconfirmedBalance": { - "type": "string", - }, - "unconfirmedTxs": { - "type": "integer", - }, - "usedTokens": { - "type": "integer", - }, - }, - "type": "object", - "x-examples": { - "Example 1": { - "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF", - "balance": "90000000", - "itemsOnPage": 1000, - "page": 1, - "secondaryValue": 21195.47633568, - "tokens": [ - { - "balance": "90000000", - "decimals": 8, - "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS", - "path": "m/44'/3'/0'/0/0", - "totalReceived": "2903986975", - "totalSent": "2803986975", - "transfers": 3, - "type": "XPUBAddress", - }, - { - "balance": "0", - "decimals": 8, - "name": "DKu2a8Wo6zC2dmBBYXwUG3fxWDHbKnNiPj", - "path": "m/44'/3'/0'/1/0", - "totalReceived": "279394275", - "totalSent": "279394275", - "transfers": 2, - "type": "XPUBAddress", - }, - ], - "totalPages": 1, - "totalReceived": "3093381250", - "totalSent": "3083381250", - "txids": [ - "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c", - "75fb93d47969ac92112628e39148ad22323e96f0004c18f8c75938cffb6c1798", - "e8cd84f204b4a42b98e535e72f461dd9832aa081458720b0a38db5856a884876", - "57833d50969208091bd6c950599a1b5cf9d66d992ae8a8d3560fb943b98ebb23", - "9cfd6295f20e74ddca6dd816c8eb71a91e4da70fe396aca6f8ce09dc2947839f", - ], - "txs": 5, - "unconfirmedBalance": "0", - "unconfirmedTxs": 0, - "usedTokens": 2, - }, - }, - }, - }, - }, "/assets": { "querystring": { "properties": { diff --git a/vercel.json b/vercel.json index b5f232b8..c7df27b5 100644 --- a/vercel.json +++ b/vercel.json @@ -4,6 +4,11 @@ "source": "/midnight", "destination": "/midnight/", "permanent": true + }, + { + "source": "/blockbook", + "destination": "/blockbook/", + "permanent": true } ] }