Block Book

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/status":{"get":{"tags":["BlockBook"],"operationId":"getStatus","summary":"Get Blockbook and backend status.","description":"Returns Blockbook sync state and connected backend metadata.\n\nLoad estimate: Low; constant-size status metadata.","responses":{"200":{"description":"Current Blockbook and backend status.","content":{"application/json":{"schema":{"type":"object","properties":{"blockbook":{"type":"object","required":["coin","network","host","version","gitCommit","buildTime","syncMode","initialSync","inSync","bestHeight","decimals","about"],"properties":{"coin":{"type":"string","description":"Coin name."},"network":{"type":"string","description":"Network identifier."},"host":{"type":"string","description":"Blockbook instance hostname."},"version":{"type":"string","description":"Blockbook version string."},"gitCommit":{"type":"string","description":"Git commit hash."},"buildTime":{"type":"string","description":"Build timestamp."},"syncMode":{"type":"boolean","description":"Whether sync mode is enabled."},"initialSync":{"type":"boolean","description":"Whether the initial sync is still in progress."},"inSync":{"type":"boolean","description":"Whether the indexer is in sync with the blockchain."},"bestHeight":{"type":"integer","description":"Current best block height."},"lastBlockTime":{"type":"string","description":"Timestamp of the last indexed block."},"inSyncMempool":{"type":"boolean","description":"Whether the mempool is in sync."},"lastMempoolTime":{"type":"string","description":"Timestamp of the last mempool update."},"mempoolSize":{"type":"integer","description":"Number of transactions in the mempool."},"decimals":{"type":"integer","description":"Number of decimals for the native currency."},"dbSize":{"type":"integer","format":"int64","description":"Size of the database in bytes."},"hasFiatRates":{"type":"boolean","description":"Whether fiat rates are available."},"hasTokenFiatRates":{"type":"boolean","description":"Whether token fiat rates are available."},"currentFiatRatesTime":{"type":"string","description":"Timestamp of the latest fiat rates."},"historicalFiatRatesTime":{"type":"string","description":"Timestamp of the latest historical fiat rates."},"historicalTokenFiatRatesTime":{"type":"string","description":"Timestamp of the latest token fiat rates."},"about":{"type":"string","description":"About text."}},"description":"The blockbook field."},"backend":{"type":"object","properties":{"chain":{"type":"string","description":"Blockchain name."},"blocks":{"type":"integer","description":"Total number of blocks."},"bestBlockHash":{"type":"string","description":"Hash of the best block."},"difficulty":{"type":"string","description":"Current difficulty."},"version":{"type":"string","description":"Backend version."}},"description":"The backend field."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/":{"get":{"tags":["BlockBook"],"operationId":"getApiIndexStatus","summary":"Get status from the API index handler.","description":"Alias served by the same handler as /api/status on full public\ninterfaces.\n\nLoad estimate: Low; constant-size status metadata.","responses":{"200":{"description":"Current Blockbook and backend status.","content":{"application/json":{"schema":{"$ref":"#/paths/~1api~1status/get/responses/200/content/application~1json/schema"}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/block-index/{height}":{"get":{"tags":["BlockBook"],"operationId":"getBlockHashByHeight","summary":"Get a block hash by height.","description":"Returns the block hash for a height on the backend main chain.\nBlockbook follows the backend main chain; after a rollback or reorg,\nheight lookups resolve to the current main-chain block.\n\nLoad estimate: Low; indexed height-to-hash lookup.","parameters":[{"name":"height","in":"path","required":true,"description":"Block height on the backend main chain.","schema":{"type":"integer","minimum":0,"description":"Block height on the backend main chain."}}],"responses":{"200":{"description":"Block hash at the requested height.","content":{"application/json":{"schema":{"type":"object","required":["blockHash"],"properties":{"blockHash":{"type":"string","description":"Block hash."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/block/{blockId}":{"get":{"tags":["BlockBook"],"operationId":"getBlock","summary":"Get a block by height or hash.","description":"Returns block information with paged transactions. When full\ntransaction details are unavailable, the response can contain only\ntransaction ids.\n\nBlockbook follows the backend main chain. Height lookups always return\nthe current main-chain block. Hash lookups can return a block from\nanother fork only if the backend still keeps it.\n\nLoad estimate: Medium; grows mainly with block transaction count and\nrequested page.","parameters":[{"name":"blockId","in":"path","required":true,"description":"Block height or block hash.","schema":{"type":"string","description":"Block height or block hash."}},{"name":"page","in":"query","description":"1-based page index. Values outside safe bounds are sanitized to the closest possible page.","schema":{"type":"integer","minimum":1,"description":"1-based page index. Values outside safe bounds are sanitized to the closest possible page."}}],"responses":{"200":{"description":"Block details.","content":{"application/json":{"schema":{"type":"object","required":["hash","height","confirmations","txCount"],"properties":{"page":{"type":"integer","description":"Current page number."},"totalPages":{"type":"integer","description":"Total number of pages."},"itemsOnPage":{"type":"integer","description":"Number of items on this page."},"hash":{"type":"string","description":"Block hash."},"previousBlockHash":{"type":"string","description":"Previous block hash."},"nextBlockHash":{"type":"string","description":"Next block hash."},"height":{"type":"integer","description":"Block height."},"confirmations":{"type":"integer","minimum":0,"description":"Number of confirmations."},"size":{"type":"integer","description":"Block size in bytes."},"time":{"type":"integer","format":"int64","description":"Block timestamp (Unix)."},"version":{"oneOf":[{"type":"string","description":"Protocol or object version."},{"type":"integer","description":"Protocol or object version."}],"description":"Block version."},"merkleRoot":{"type":"string","description":"Merkle root."},"nonce":{"type":"string","description":"Block nonce."},"bits":{"type":"string","description":"Bits representation."},"difficulty":{"type":"string","description":"Difficulty target."},"tx":{"type":"array","description":"Transaction ids when full transactions are not returned.","items":{"type":"string","description":"Single entry in the tx array."}},"txCount":{"type":"integer","description":"Total number of transactions in the block."},"txs":{"type":"array","description":"Full transaction details for this page.","items":{"type":"object","required":["txid","vin","vout","blockHeight","confirmations","blockTime"],"properties":{"txid":{"type":"string","description":"Transaction id."},"version":{"type":"integer","description":"Transaction version."},"lockTime":{"type":"integer","description":"Lock time."},"vin":{"type":"array","items":{"type":"object","required":["n","isAddress"],"properties":{"txid":{"type":"string","description":"Input transaction id."},"vout":{"type":"integer","minimum":0,"description":"Output index."},"sequence":{"type":"integer","description":"Sequence number."},"n":{"type":"integer","minimum":0,"description":"Input index within the transaction."},"addresses":{"type":"array","items":{"type":"string","description":"Single entry in the addresses array."},"description":"Array of addresses."},"isAddress":{"type":"boolean","description":"Whether the input is address-based."},"isOwn":{"type":"boolean","description":"Whether this input belongs to the queried account."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Input value in lowest denomination."},"hex":{"type":"string","description":"Script hex."},"asm":{"type":"string","description":"Script assembly."},"coinbase":{"type":"string","description":"Coinbase data if applicable."}},"description":"Object containing items details."},"description":"Transaction inputs."},"vout":{"type":"array","items":{"type":"object","required":["n","addresses","isAddress"],"properties":{"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Output value."},"n":{"type":"integer","minimum":0,"description":"Output index."},"spent":{"type":"boolean","description":"Whether this output is spent."},"spentTxId":{"type":"string","description":"Spending transaction id if spent."},"spentIndex":{"type":"integer","description":"Spending input index."},"spentHeight":{"type":"integer","description":"Block height where spent."},"hex":{"type":"string","description":"Output script hex."},"asm":{"type":"string","description":"Script assembly."},"addresses":{"oneOf":[{"type":"array","items":{"type":"string","description":"Single entry in the item array."},"description":"The addresses field."}],"description":"Recipient addresses."},"isAddress":{"type":"boolean","description":"Whether the output is address-based."},"isOwn":{"type":"boolean","description":"Whether this output belongs to the queried account."},"type":{"type":"string","description":"Output type."}},"description":"Object containing items details."},"description":"Transaction outputs."},"blockHash":{"type":"string","description":"Block hash containing this transaction."},"blockHeight":{"type":"integer","description":"-1 for unconfirmed transactions."},"confirmations":{"type":"integer","minimum":0,"description":"Number of confirmations."},"confirmationETABlocks":{"type":"integer","description":"Estimated blocks until confirmation."},"confirmationETASeconds":{"type":"integer","format":"int64","description":"Estimated seconds until confirmation."},"blockTime":{"type":"integer","format":"int64","description":"Block timestamp."},"size":{"type":"integer","description":"Transaction size."},"vsize":{"type":"integer","description":"Virtual transaction size."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Total output value."},"valueIn":{"type":"string","pattern":"^-?[0-9]+$","description":"Total input value."},"fees":{"type":"string","pattern":"^-?[0-9]+$","description":"Transaction fees."},"hex":{"type":"string","description":"Serialized transaction hex."},"rbf":{"type":"boolean","description":"Replace-by-fee flag."},"coinSpecificData":{"description":"Raw blockchain-specific transaction data."},"chainExtraData":{"type":"object","required":["payloadType"],"properties":{"payloadType":{"type":"string","description":"Discriminator for normalized chain-specific payloads."},"payload":{"description":"The payload field."}},"description":"Chain-specific extra data."},"tokenTransfers":{"type":"array","items":{"type":"object","required":["type","standard","from","to","contract"],"properties":{"standard":{"type":"string","description":"Token standard name."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"contract":{"type":"string","description":"Token contract address."},"name":{"type":"string","description":"Token name."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"integer","description":"Token decimals."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transferred amount in token base units."},"multiTokenValues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$","description":"Token ID."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Token value."}},"description":"Object containing items details."},"description":"Multi-token values for ERC-1155."}},"description":"Object containing items details."},"description":"Token transfers."},"ethereumSpecific":{"type":"object","required":["status","nonce"],"properties":{"type":{"type":"integer","description":"Transaction type."},"createdContract":{"type":"string","description":"Address of created contract."},"status":{"type":"integer","description":"1 success, 0 failed, -1 pending."},"error":{"type":"string","description":"Error message if failed."},"nonce":{"type":"integer","format":"int64","description":"Transaction nonce."},"gasLimit":{"type":"integer","format":"int64","description":"Gas limit."},"gasUsed":{"type":"integer","format":"int64","description":"Gas used."},"gasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"Gas price."},"maxPriorityFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max priority fee per gas."},"maxFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max fee per gas."},"baseFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Base fee per gas."},"l1Fee":{"type":"integer","format":"int64","description":"L1 fee (optimistic rollups)."},"l1FeeScalar":{"type":"string","description":"L1 fee scalar."},"l1GasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"L1 gas price."},"l1GasUsed":{"type":"integer","format":"int64","description":"L1 gas used."},"data":{"type":"string","description":"Input data hex."},"parsedData":{"type":"object","required":["methodId","name"],"properties":{"methodId":{"type":"string","description":"First 4 bytes of the input data."},"name":{"type":"string","description":"Parsed function name when recognized."},"function":{"type":"string","description":"Full function signature."},"params":{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Parameter type."},"values":{"type":"array","items":{"type":"string","description":"Single entry in the values array."},"description":"Parameter values."}},"description":"Object containing items details."},"description":"Parsed parameters."}},"description":"Parsed input data."},"internalTransfers":{"type":"array","items":{"type":"object","required":["type","from","to"],"properties":{"type":{"type":"integer","description":"Transfer type."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transfer value."}},"description":"Object containing items details."},"description":"Internal transfers."}},"description":"Ethereum-specific transaction data."},"addressAliases":{"type":"object","additionalProperties":{"type":"object","properties":{"Type":{"type":"string","description":"Alias type."},"Alias":{"type":"string","description":"Alias name."}}},"description":"Address alias map."}},"description":"Transaction in the block."}},"addressAliases":{"type":"object","additionalProperties":{"type":"object","properties":{"Type":{"type":"string","description":"Alias type."},"Alias":{"type":"string","description":"Alias name."}}},"description":"Address alias map for the block."}},"description":"Block with transactions."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/rawblock/{blockId}":{"get":{"tags":["BlockBook"],"operationId":"getRawBlock","summary":"Get raw block hex.","description":"Returns raw serialized block data.\n\nLoad estimate: High for large blocks; payload size grows with the raw\nblock size.","parameters":[{"name":"blockId","in":"path","required":true,"description":"Block height or block hash.","schema":{"type":"string","description":"Block height or block hash."}}],"responses":{"200":{"description":"Raw block data.","content":{"application/json":{"schema":{"type":"object","required":["hex"],"properties":{"hex":{"type":"string","description":"Raw block hex."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/block-filters/":{"get":{"tags":["BlockBook"],"operationId":"getBlockFilters","summary":"Get compact block filters.","description":"Returns compact block filters for the script type configured on this\nBlockbook instance. Provide either lastN or a from/to range. When to is\nomitted for a range, the current best height is used.\n\nLoad estimate: High for wide ranges; work and payload grow linearly\nwith the number of requested filters.","parameters":[{"name":"scriptType","in":"query","required":true,"description":"Script type configured for block filters on this instance, for example taproot.","schema":{"type":"string","description":"Script type configured for block filters on this instance, for example taproot."}},{"name":"lastN","in":"query","description":"Return filters for the last N blocks.","schema":{"type":"integer","minimum":1,"description":"Return filters for the last N blocks."}},{"name":"from","in":"query","description":"First block height in the requested range.","schema":{"type":"integer","minimum":0,"description":"First block height in the requested range."}},{"name":"to","in":"query","description":"Last block height in the requested range. Defaults to the current best height when omitted.","schema":{"type":"integer","minimum":0,"description":"Last block height in the requested range. Defaults to the current best height when omitted."}}],"responses":{"200":{"description":"Block filters keyed by block height.","content":{"application/json":{"schema":{"type":"object","required":["P","M","zeroedKey","blockFilters"],"properties":{"P":{"type":"integer","description":"Parameter P."},"M":{"type":"integer","format":"int64","description":"Parameter M."},"zeroedKey":{"type":"boolean","description":"Whether zeroed key was used."},"blockFilters":{"type":"object","additionalProperties":{"type":"object","required":["blockHash","filter"],"properties":{"blockHash":{"type":"string","description":"Block hash."},"filter":{"type":"string","description":"Compact filter hex."}}},"description":"Map of block heights to filter objects."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/tx/{txid}":{"get":{"tags":["BlockBook"],"operationId":"getTransaction","summary":"Get a normalized transaction.","description":"Returns normalized transaction data with the same general structure for\nall supported coins. Coin-specific fields that do not fit the common\nshape are omitted here; use getTransactionSpecific for backend-native\nJSON.\n\nBitcoin-like confirmed transactions include blockHash, confirmations,\nblockTime, size/vsize, value/valueIn, fees, and hex. Unconfirmed\ntransactions can include confirmationETABlocks and\nconfirmationETASeconds.\n\nEthereum-like transactions have one vin and one vout, tokenTransfers,\nethereumSpecific execution data, and optional addressAliases. Parsed\ninput data is included when the 4byte signature can be resolved.\n\nFor mined transactions, blockTime is the block timestamp. For mempool\ntransactions, blockTime is when this Blockbook instance first learned\nabout the transaction and can differ between instances.\n\nLoad estimate: Medium; grows with inputs, outputs, token transfers,\naddress aliases, and spending=true extra lookups.","parameters":[{"name":"txid","in":"path","required":true,"description":"Transaction id/hash.","schema":{"type":"string","description":"Transaction id/hash."}},{"name":"spending","in":"query","description":"Include spending transaction metadata for UTXO outputs when available.","schema":{"type":"boolean","description":"Include spending transaction metadata for UTXO outputs when available."}}],"responses":{"200":{"description":"Normalized transaction.","content":{"application/json":{"schema":{"type":"object","required":["txid","vin","vout","blockHeight","confirmations","blockTime"],"properties":{"txid":{"type":"string","description":"Transaction id."},"version":{"type":"integer","description":"Transaction version."},"lockTime":{"type":"integer","description":"Lock time."},"vin":{"type":"array","items":{"type":"object","required":["n","isAddress"],"properties":{"txid":{"type":"string","description":"Input transaction id."},"vout":{"type":"integer","minimum":0,"description":"Output index."},"sequence":{"type":"integer","description":"Sequence number."},"n":{"type":"integer","minimum":0,"description":"Input index within the transaction."},"addresses":{"type":"array","items":{"type":"string","description":"Single entry in the addresses array."},"description":"Array of addresses."},"isAddress":{"type":"boolean","description":"Whether the input is address-based."},"isOwn":{"type":"boolean","description":"Whether this input belongs to the queried account."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Input value in lowest denomination."},"hex":{"type":"string","description":"Script hex."},"asm":{"type":"string","description":"Script assembly."},"coinbase":{"type":"string","description":"Coinbase data if applicable."}},"description":"Object containing items details."},"description":"Transaction inputs."},"vout":{"type":"array","items":{"type":"object","required":["n","addresses","isAddress"],"properties":{"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Output value."},"n":{"type":"integer","minimum":0,"description":"Output index."},"spent":{"type":"boolean","description":"Whether this output is spent."},"spentTxId":{"type":"string","description":"Spending transaction id if spent."},"spentIndex":{"type":"integer","description":"Spending input index."},"spentHeight":{"type":"integer","description":"Block height where spent."},"hex":{"type":"string","description":"Output script hex."},"asm":{"type":"string","description":"Script assembly."},"addresses":{"oneOf":[{"type":"array","items":{"type":"string","description":"Single entry in the item array."},"description":"The addresses field."}],"description":"Recipient addresses."},"isAddress":{"type":"boolean","description":"Whether the output is address-based."},"isOwn":{"type":"boolean","description":"Whether this output belongs to the queried account."},"type":{"type":"string","description":"Output type."}},"description":"Object containing items details."},"description":"Transaction outputs."},"blockHash":{"type":"string","description":"Block hash containing this transaction."},"blockHeight":{"type":"integer","description":"-1 for unconfirmed transactions."},"confirmations":{"type":"integer","minimum":0,"description":"Number of confirmations."},"confirmationETABlocks":{"type":"integer","description":"Estimated blocks until confirmation."},"confirmationETASeconds":{"type":"integer","format":"int64","description":"Estimated seconds until confirmation."},"blockTime":{"type":"integer","format":"int64","description":"Block timestamp."},"size":{"type":"integer","description":"Transaction size."},"vsize":{"type":"integer","description":"Virtual transaction size."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Total output value."},"valueIn":{"type":"string","pattern":"^-?[0-9]+$","description":"Total input value."},"fees":{"type":"string","pattern":"^-?[0-9]+$","description":"Transaction fees."},"hex":{"type":"string","description":"Serialized transaction hex."},"rbf":{"type":"boolean","description":"Replace-by-fee flag."},"coinSpecificData":{"description":"Raw blockchain-specific transaction data."},"chainExtraData":{"type":"object","required":["payloadType"],"properties":{"payloadType":{"type":"string","description":"Discriminator for normalized chain-specific payloads."},"payload":{"description":"The payload field."}},"description":"Chain-specific extra data."},"tokenTransfers":{"type":"array","items":{"type":"object","required":["type","standard","from","to","contract"],"properties":{"standard":{"type":"string","description":"Token standard name."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"contract":{"type":"string","description":"Token contract address."},"name":{"type":"string","description":"Token name."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"integer","description":"Token decimals."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transferred amount in token base units."},"multiTokenValues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$","description":"Token ID."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Token value."}},"description":"Object containing items details."},"description":"Multi-token values for ERC-1155."}},"description":"Object containing items details."},"description":"Token transfers."},"ethereumSpecific":{"type":"object","required":["status","nonce"],"properties":{"type":{"type":"integer","description":"Transaction type."},"createdContract":{"type":"string","description":"Address of created contract."},"status":{"type":"integer","description":"1 success, 0 failed, -1 pending."},"error":{"type":"string","description":"Error message if failed."},"nonce":{"type":"integer","format":"int64","description":"Transaction nonce."},"gasLimit":{"type":"integer","format":"int64","description":"Gas limit."},"gasUsed":{"type":"integer","format":"int64","description":"Gas used."},"gasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"Gas price."},"maxPriorityFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max priority fee per gas."},"maxFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max fee per gas."},"baseFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Base fee per gas."},"l1Fee":{"type":"integer","format":"int64","description":"L1 fee (optimistic rollups)."},"l1FeeScalar":{"type":"string","description":"L1 fee scalar."},"l1GasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"L1 gas price."},"l1GasUsed":{"type":"integer","format":"int64","description":"L1 gas used."},"data":{"type":"string","description":"Input data hex."},"parsedData":{"type":"object","required":["methodId","name"],"properties":{"methodId":{"type":"string","description":"First 4 bytes of the input data."},"name":{"type":"string","description":"Parsed function name when recognized."},"function":{"type":"string","description":"Full function signature."},"params":{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Parameter type."},"values":{"type":"array","items":{"type":"string","description":"Single entry in the values array."},"description":"Parameter values."}},"description":"Object containing items details."},"description":"Parsed parameters."}},"description":"Parsed input data."},"internalTransfers":{"type":"array","items":{"type":"object","required":["type","from","to"],"properties":{"type":{"type":"integer","description":"Transfer type."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transfer value."}},"description":"Object containing items details."},"description":"Internal transfers."}},"description":"Ethereum-specific transaction data."},"addressAliases":{"type":"object","additionalProperties":{"type":"object","properties":{"Type":{"type":"string","description":"Alias type."},"Alias":{"type":"string","description":"Alias name."}}},"description":"Address alias map."}},"description":"Normalized transaction object."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/tx-specific/{txid}":{"get":{"tags":["BlockBook"],"operationId":"getTransactionSpecific","summary":"Get blockchain-specific transaction JSON.","description":"Returns transaction data in the exact backend-specific format. Use this\nwhen a chain exposes fields that are intentionally absent from the\nnormalized Tx schema.\n\nLoad estimate: Medium; payload size depends on chain-specific fields\nand transaction complexity.","parameters":[{"name":"txid","in":"path","required":true,"description":"Transaction id/hash.","schema":{"type":"string","description":"Transaction id/hash."}}],"responses":{"200":{"description":"Chain-specific transaction payload.","content":{"application/json":{"schema":{"description":"Arbitrary chain-specific transaction payload."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/rawtx/{txid}":{"get":{"tags":["BlockBook"],"operationId":"getRawTransaction","summary":"Get raw transaction hex.","description":"Unversioned public endpoint exposed by Blockbook for raw transaction\ndata.\n\nLoad estimate: Medium; payload size grows with raw transaction size.","parameters":[{"name":"txid","in":"path","required":true,"description":"Transaction id/hash.","schema":{"type":"string","description":"Transaction id/hash."}}],"responses":{"200":{"description":"Raw transaction hex as a JSON string.","content":{"application/json":{"schema":{"type":"string","description":"Raw hex string."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/sendtx/{hex}":{"get":{"tags":["BlockBook"],"operationId":"sendTransactionByGet","summary":"Broadcast a raw transaction using the path.","description":"Broadcasts hex-encoded raw transaction data. Prefer POST for large\npayloads.\n\nLoad estimate: High; validates and forwards to the backend, with cost\ngrowing with transaction size and backend mempool policy checks.","parameters":[{"name":"hex","in":"path","required":true,"description":"Raw transaction.","schema":{"type":"string","pattern":"^[0-9a-fA-F]+$","description":"Raw transaction."}}],"responses":{"200":{"description":"Broadcast result.","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"string","description":"Broadcast transaction id/hash."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/sendtx/":{"post":{"tags":["BlockBook"],"operationId":"sendTransactionByPost","summary":"Broadcast a raw transaction using the request body.","description":"Broadcasts hex-encoded raw transaction data from the request body. The\ntrailing slash is mandatory in the Blockbook handler. POST bodies are\nlimited to 8 MiB.\n\nLoad estimate: High; validates and forwards to the backend, with cost\ngrowing with transaction size and backend mempool policy checks.","requestBody":{"required":true,"content":{"text/plain":{"schema":{"type":"string","pattern":"^[0-9a-fA-F]+$","description":"Alternative schema variant for this parameter or payload."}}},"description":"Request body."},"responses":{"200":{"description":"Broadcast result.","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"string","description":"Broadcast transaction id/hash."}},"description":"Object containing schema details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}

{"openapi":"3.0.0","info":{"title":"BSC Blockbook API","version":"2.0.0-draft"},"tags":[{"name":"BlockBook","description":"BlockBook operations."}],"servers":[{"url":"https://bsc-blockbook.nownodes.io","description":"NOWNodes BSC Blockbook endpoint."}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"NOWNodes API key passed in the api-key header."}},"schemas":{"UnauthorizedPlainTextError":{"type":"string","description":"Plain-text response returned when an API key is present but not accepted by NOWNodes."},"MethodNotAllowedPlainTextError":{"type":"string","description":"Plain-text response returned by the gateway for malformed or unsupported gateway-level requests."},"MissingApiKeyPlainTextError":{"type":"string","description":"Plain-text response returned when the api-key header is missing."}}},"paths":{"/api/v2/address/{address}":{"get":{"tags":["BlockBook"],"operationId":"getAddress","summary":"Get address/account details.","description":"Returns balances and transactions of an address. Transactions are\nsorted by block height with newest blocks first. Response size is\ncontrolled by the details parameter.\n\nAt details=basic, mempool transactions are not aggregated:\nunconfirmedBalance, unconfirmedSending, and unconfirmedReceiving are\nomitted, and unconfirmedTxs reports the raw mempool index size for the\naddress.\n\nLoad estimate: Variable; basic is low, token/tokenBalances and\ntxids/txslight are medium, and txs can be high as it grows with\npageSize, transactions, token rows, filters, and protocol enrichment.","parameters":[{"name":"address","in":"path","required":true,"description":"BNB Smart Chain address in 0x-prefixed hexadecimal format.","schema":{"type":"string","description":"BNB Smart Chain address in 0x-prefixed hexadecimal format."}},{"name":"page","in":"query","required":false,"description":"Page number of the returned transaction list. Pagination starts from 1.","schema":{"type":"integer","format":"int32","default":1,"minimum":1,"description":"Requested transaction-history page number."}},{"name":"pageSize","in":"query","required":false,"description":"Maximum number of transactions returned on one page.","schema":{"type":"integer","format":"int32","default":1000,"minimum":1,"maximum":1000,"description":"Number of transactions requested per page."}},{"name":"from","in":"query","required":false,"description":"Start block height filter for transactions, inclusive.","schema":{"type":"integer","format":"int64","minimum":0,"description":"Lowest block height included in the transaction search."}},{"name":"to","in":"query","required":false,"description":"End block height filter for transactions, inclusive.","schema":{"type":"integer","format":"int64","minimum":0,"description":"Highest block height included in the transaction search."}},{"name":"details","in":"query","required":false,"description":"Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.","schema":{"type":"string","enum":["basic","tokens","tokenBalances","txids","txslight","txs"],"default":"txids","description":"Blockbook response detail level."}},{"name":"tokens","in":"query","required":false,"description":"Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.","schema":{"type":"string","enum":["used","nonzero","derived"],"description":"Token inclusion mode for the address query."}},{"name":"secondary","in":"query","required":false,"description":"When true, includes secondary currency values in supported balance and transaction fields.","schema":{"type":"boolean","default":false,"description":"Whether to include secondary fiat or currency amounts."}},{"name":"contract","in":"query","required":false,"description":"Smart-contract address used to filter token-related address data.","schema":{"type":"string","description":"Token contract address used by the Blockbook address query."}},{"name":"filter","in":"query","description":"Filter account history by input/output side, or by numeric token/internal filter id.","schema":{"oneOf":[{"type":"string","enum":["inputs","outputs"],"description":"Item value."},{"type":"integer","minimum":0,"description":"Item value."}],"description":"Filter account history by input/output side, or by numeric token/internal filter id."}},{"name":"protocols","in":"query","description":"Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","description":"Single entry in the schema array."},"description":"Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected."}}],"responses":{"200":{"description":"Address/account details.","content":{"application/json":{"schema":{"type":"object","required":["address","unconfirmedTxs","txs"],"properties":{"page":{"type":"integer","description":"Current page number."},"totalPages":{"type":"integer","description":"Total number of pages."},"itemsOnPage":{"type":"integer","description":"Number of items on this page."},"address":{"type":"string","description":"The queried address."},"balance":{"type":"string","pattern":"^-?[0-9]+$","description":"Confirmed balance."},"totalReceived":{"type":"string","pattern":"^-?[0-9]+$","description":"Total received amount."},"totalSent":{"type":"string","pattern":"^-?[0-9]+$","description":"Total sent amount."},"unconfirmedBalance":{"type":"string","pattern":"^-?[0-9]+$","description":"Unconfirmed balance."},"unconfirmedTxs":{"type":"integer","description":"Number of unconfirmed transactions."},"unconfirmedSending":{"type":"string","pattern":"^-?[0-9]+$","description":"Unconfirmed sending amount."},"unconfirmedReceiving":{"type":"string","pattern":"^-?[0-9]+$","description":"Unconfirmed receiving amount."},"txs":{"type":"integer","description":"Total number of transactions."},"addrTxCount":{"type":"integer","description":"Alternative transaction count field."},"nonTokenTxs":{"type":"integer","description":"Number of non-token transactions."},"internalTxs":{"type":"integer","description":"Number of internal transactions."},"transactions":{"type":"array","items":{"type":"object","required":["txid","vin","vout","blockHeight","confirmations","blockTime"],"properties":{"txid":{"type":"string","description":"Transaction id."},"version":{"type":"integer","description":"Transaction version."},"lockTime":{"type":"integer","description":"Lock time."},"vin":{"type":"array","items":{"type":"object","required":["n","isAddress"],"properties":{"txid":{"type":"string","description":"Input transaction id."},"vout":{"type":"integer","minimum":0,"description":"Output index."},"sequence":{"type":"integer","description":"Sequence number."},"n":{"type":"integer","minimum":0,"description":"Input index within the transaction."},"addresses":{"type":"array","items":{"type":"string","description":"Single entry in the addresses array."},"description":"Array of addresses."},"isAddress":{"type":"boolean","description":"Whether the input is address-based."},"isOwn":{"type":"boolean","description":"Whether this input belongs to the queried account."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Input value in lowest denomination."},"hex":{"type":"string","description":"Script hex."},"asm":{"type":"string","description":"Script assembly."},"coinbase":{"type":"string","description":"Coinbase data if applicable."}},"description":"Object containing items details."},"description":"Transaction inputs."},"vout":{"type":"array","items":{"type":"object","required":["n","addresses","isAddress"],"properties":{"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Output value."},"n":{"type":"integer","minimum":0,"description":"Output index."},"spent":{"type":"boolean","description":"Whether this output is spent."},"spentTxId":{"type":"string","description":"Spending transaction id if spent."},"spentIndex":{"type":"integer","description":"Spending input index."},"spentHeight":{"type":"integer","description":"Block height where spent."},"hex":{"type":"string","description":"Output script hex."},"asm":{"type":"string","description":"Script assembly."},"addresses":{"oneOf":[{"type":"array","items":{"type":"string","description":"Single entry in the item array."},"description":"The addresses field."}],"description":"Recipient addresses."},"isAddress":{"type":"boolean","description":"Whether the output is address-based."},"isOwn":{"type":"boolean","description":"Whether this output belongs to the queried account."},"type":{"type":"string","description":"Output type."}},"description":"Object containing items details."},"description":"Transaction outputs."},"blockHash":{"type":"string","description":"Block hash containing this transaction."},"blockHeight":{"type":"integer","description":"-1 for unconfirmed transactions."},"confirmations":{"type":"integer","minimum":0,"description":"Number of confirmations."},"confirmationETABlocks":{"type":"integer","description":"Estimated blocks until confirmation."},"confirmationETASeconds":{"type":"integer","format":"int64","description":"Estimated seconds until confirmation."},"blockTime":{"type":"integer","format":"int64","description":"Block timestamp."},"size":{"type":"integer","description":"Transaction size."},"vsize":{"type":"integer","description":"Virtual transaction size."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Total output value."},"valueIn":{"type":"string","pattern":"^-?[0-9]+$","description":"Total input value."},"fees":{"type":"string","pattern":"^-?[0-9]+$","description":"Transaction fees."},"hex":{"type":"string","description":"Serialized transaction hex."},"rbf":{"type":"boolean","description":"Replace-by-fee flag."},"coinSpecificData":{"description":"Raw blockchain-specific transaction data."},"chainExtraData":{"type":"object","required":["payloadType"],"properties":{"payloadType":{"type":"string","description":"Discriminator for normalized chain-specific payloads."},"payload":{"description":"The payload field."}},"description":"Chain-specific extra data."},"tokenTransfers":{"type":"array","items":{"type":"object","required":["type","standard","from","to","contract"],"properties":{"standard":{"type":"string","description":"Token standard name."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"contract":{"type":"string","description":"Token contract address."},"name":{"type":"string","description":"Token name."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"integer","description":"Token decimals."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transferred amount in token base units."},"multiTokenValues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$","description":"Token ID."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Token value."}},"description":"Object containing items details."},"description":"Multi-token values for ERC-1155."}},"description":"Object containing items details."},"description":"Token transfers."},"ethereumSpecific":{"type":"object","required":["status","nonce"],"properties":{"type":{"type":"integer","description":"Transaction type."},"createdContract":{"type":"string","description":"Address of created contract."},"status":{"type":"integer","description":"1 success, 0 failed, -1 pending."},"error":{"type":"string","description":"Error message if failed."},"nonce":{"type":"integer","format":"int64","description":"Transaction nonce."},"gasLimit":{"type":"integer","format":"int64","description":"Gas limit."},"gasUsed":{"type":"integer","format":"int64","description":"Gas used."},"gasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"Gas price."},"maxPriorityFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max priority fee per gas."},"maxFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Max fee per gas."},"baseFeePerGas":{"type":"string","pattern":"^-?[0-9]+$","description":"Base fee per gas."},"l1Fee":{"type":"integer","format":"int64","description":"L1 fee (optimistic rollups)."},"l1FeeScalar":{"type":"string","description":"L1 fee scalar."},"l1GasPrice":{"type":"string","pattern":"^-?[0-9]+$","description":"L1 gas price."},"l1GasUsed":{"type":"integer","format":"int64","description":"L1 gas used."},"data":{"type":"string","description":"Input data hex."},"parsedData":{"type":"object","required":["methodId","name"],"properties":{"methodId":{"type":"string","description":"First 4 bytes of the input data."},"name":{"type":"string","description":"Parsed function name when recognized."},"function":{"type":"string","description":"Full function signature."},"params":{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"Parameter type."},"values":{"type":"array","items":{"type":"string","description":"Single entry in the values array."},"description":"Parameter values."}},"description":"Object containing items details."},"description":"Parsed parameters."}},"description":"Parsed input data."},"internalTransfers":{"type":"array","items":{"type":"object","required":["type","from","to"],"properties":{"type":{"type":"integer","description":"Transfer type."},"from":{"type":"string","description":"Sender address."},"to":{"type":"string","description":"Recipient address."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Transfer value."}},"description":"Object containing items details."},"description":"Internal transfers."}},"description":"Ethereum-specific transaction data."},"addressAliases":{"type":"object","additionalProperties":{"type":"object","properties":{"Type":{"type":"string","description":"Alias type."},"Alias":{"type":"string","description":"Alias name."}}},"description":"Address alias map."}},"description":"Object containing items details."},"description":"Full transactions when detail level includes transaction bodies."},"txids":{"type":"array","items":{"type":"string","description":"Single entry in the txids array."},"description":"Transaction ids when detail is txids."},"nonce":{"type":"string","description":"Account nonce (Ethereum)."},"usedTokens":{"type":"integer","description":"Number of used addresses for XPUB."},"tokens":{"type":"array","items":{"type":"object","required":["type","standard","name","transfers"],"properties":{"standard":{"type":"string","description":"Token standard name."},"name":{"type":"string","description":"Token name."},"path":{"type":"string","description":"Derivation path for XPUB tokens."},"contract":{"type":"string","description":"Token contract address."},"transfers":{"type":"integer","description":"Number of token transfers."},"symbol":{"type":"string","description":"Token symbol."},"decimals":{"type":"integer","description":"Token decimals."},"balance":{"type":"string","pattern":"^-?[0-9]+$","description":"Token balance."},"baseValue":{"type":"number","description":"Base currency value (e.g., ETH)."},"secondaryValue":{"type":"number","description":"Secondary currency value (e.g., USD)."},"ids":{"type":"array","items":{"type":"string","pattern":"^-?[0-9]+$","description":"Single entry in the ids array."},"description":"Token IDs for ERC-1155."},"multiTokenValues":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^-?[0-9]+$","description":"Token ID."},"value":{"type":"string","pattern":"^-?[0-9]+$","description":"Token value."}},"description":"Object containing items details."},"description":"Multi-token balances."},"totalReceived":{"type":"string","pattern":"^-?[0-9]+$","description":"Total received token amount."},"totalSent":{"type":"string","pattern":"^-?[0-9]+$","description":"Total sent token amount."},"protocols":{"type":"array","description":"Indexed protocol identifiers.","items":{"type":"string","description":"Single entry in the protocols array."}}},"description":"Object containing items details."},"description":"Token rows."},"secondaryValue":{"type":"number","description":"Total secondary currency value."},"tokensBaseValue":{"type":"number","description":"Sum of token base values."},"tokensSecondaryValue":{"type":"number","description":"Sum of token secondary values."},"totalBaseValue":{"type":"number","description":"Total base value including tokens."},"totalSecondaryValue":{"type":"number","description":"Total secondary value including tokens."},"contractInfo":{"type":"object","required":["type","standard","contract","name","symbol","decimals","blockHeight"],"properties":{"standard":{"type":"string","description":"Token standard name."},"contract":{"type":"string","description":"Contract address."},"name":{"type":"string","description":"Contract name."},"symbol":{"type":"string","description":"Contract symbol."},"decimals":{"type":"integer","description":"Contract decimals."},"createdInBlock":{"type":"integer","description":"Block where contract was created."},"destructedInBlock":{"type":"integer","description":"Block where contract was destructed."},"rates":{"type":"object","properties":{"baseRate":{"type":"number","description":"Base rate."},"currency":{"type":"string","description":"Currency code."},"secondaryRate":{"type":"number","description":"Secondary rate."}},"description":"Contract rates."},"protocols":{"type":"object","properties":{"erc4626":{"type":"object","properties":{"asset":{"type":"object","required":["contract","decimals"],"properties":{"contract":{"type":"string","description":"Asset contract address."},"name":{"type":"string","description":"Asset name."},"symbol":{"type":"string","description":"Asset symbol."},"decimals":{"type":"integer","description":"Asset decimals."}},"description":"Underlying asset metadata."},"share":{"type":"object","required":["contract","decimals"],"properties":{"contract":{"type":"string","description":"Share contract address."},"name":{"type":"string","description":"Share name."},"symbol":{"type":"string","description":"Share symbol."},"decimals":{"type":"integer","description":"Share decimals."}},"description":"Share token metadata."},"totalAssets":{"type":"string","pattern":"^-?[0-9]+$","description":"Total assets in the vault."},"convertToAssets1Share":{"type":"string","pattern":"^-?[0-9]+$","description":"Conversion rate 1 share to assets."},"convertToShares1Asset":{"type":"string","pattern":"^-?[0-9]+$","description":"Conversion rate 1 asset to shares."},"previewDeposit1Asset":{"type":"string","pattern":"^-?[0-9]+$","description":"Preview of deposit for 1 asset."},"previewRedeem1Share":{"type":"string","pattern":"^-?[0-9]+$","description":"Preview of redeem for 1 share."},"error":{"type":"string","description":"Error message if any."}},"description":"ERC4626 protocol data."}},"description":"Protocol enrichments."},"blockHeight":{"type":"integer","description":"Indexer best block height at time of contract info retrieval."}},"description":"Contract metadata if address is a contract."},"addressAliases":{"type":"object","additionalProperties":{"type":"object","properties":{"Type":{"type":"string","description":"Alias type."},"Alias":{"type":"string","description":"Alias name."}}},"description":"Address alias map."},"stakingPools":{"type":"array","items":{"type":"object","required":["contract","name"],"properties":{"contract":{"type":"string","description":"Staking pool contract address."},"name":{"type":"string","description":"Staking pool name."},"pendingBalance":{"type":"string","pattern":"^-?[0-9]+$","description":"Pending balance."},"pendingDepositedBalance":{"type":"string","pattern":"^-?[0-9]+$","description":"Pending deposited balance."},"depositedBalance":{"type":"string","pattern":"^-?[0-9]+$","description":"Deposited balance."},"withdrawTotalAmount":{"type":"string","pattern":"^-?[0-9]+$","description":"Withdraw total amount."},"claimableAmount":{"type":"string","pattern":"^-?[0-9]+$","description":"Claimable amount."},"restakedReward":{"type":"string","pattern":"^-?[0-9]+$","description":"Restaked reward."},"autocompoundBalance":{"type":"string","pattern":"^-?[0-9]+$","description":"Autocompound balance."}},"description":"Object containing items details."},"description":"Staking pool data."},"chainExtraData":{"type":"object","required":["payloadType"],"properties":{"payloadType":{"type":"string","description":"Discriminator for chain-specific account data."},"payload":{"description":"The payload field."}},"description":"Chain-specific extra account data."}},"description":"Address/account details."}}}},"401":{"description":"Unauthorized: API key is present but rejected by the NOWNodes gateway.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/UnauthorizedPlainTextError"}}}},"405":{"description":"Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MethodNotAllowedPlainTextError"}}}},"422":{"description":"Missing API key. The NOWNodes gateway returns plain text for this error.","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/MissingApiKeyPlainTextError"}}}},"default":{"description":"Public API error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message."}},"description":"Object containing schema details."}}}}}}}}}