> For the complete documentation index, see [llms.txt](https://docs.stacks.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stacks.co/reference/api/stacks-blockchain-api/transactions.md). # Transactions Endpoints to obtain transaction details and to broadcast transactions to the network ## Get block transactions > Retrieves transactions confirmed in a single block ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/blocks/{height_or_hash}/transactions":{"get":{"operationId":"get_block_transactions","summary":"Get block transactions","tags":["Transactions"],"description":"Retrieves transactions confirmed in a single block","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index"},{"schema":{"anyOf":[{"type":"string","enum":["latest"]},{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Block hash","description":"Block hash","type":"string"},{"title":"Block height","description":"Block height","type":"integer"}]},"in":"path","name":"height_or_hash","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"anyOf":[{"title":"TokenTransferTransactionSummary","description":"Token transfer transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"type":"string"},"amount":{"description":"Transfer amount as Integer string (64-bit unsigned integer)","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"title":"SmartContractTransactionSummary","description":"Smart contract transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["clarity_version","contract_id"],"properties":{"clarity_version":{"anyOf":[{"description":"The Clarity version of the contract. Versioned contract transactions declare it; for the rest it is the version the node resolved from the epoch the contract was deployed in. Null only when it could not be determined, which happens for contracts indexed from a chainstate predating the point where the Stacks node began reporting it.","type":"number"},{"type":"null"}]},"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"}}}}},{"title":"ContractCallTransactionSummary","description":"Contract call transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"},"function_name":{"description":"Name of the Clarity function to be invoked","type":"string"}}}}},{"title":"PoisonMicroblockTransactionSummary","description":"Poison microblock transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"title":"CoinbaseTransactionSummary","description":"Coinbase transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","coinbase"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["coinbase"]},"coinbase":{"type":"object","required":["alt_recipient"],"properties":{"alt_recipient":{"anyOf":[{"description":"A principal that will receive the miner rewards for this coinbase transaction. Can be either a standard principal or contract principal. Only specified for `coinbase-to-alt-recipient` transaction types, otherwise null.","type":"string"},{"type":"null"}]}}}}},{"title":"TenureChangeTransactionSummary","description":"Tenure change transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","tenure_change"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["tenure_change"]},"tenure_change":{"type":"object","required":["cause"],"properties":{"cause":{"description":"Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.","anyOf":[{"type":"string","enum":["block_found"]},{"type":"string","enum":["extended"]},{"type":"string","enum":["extended_runtime"]},{"type":"string","enum":["extended_read_count"]},{"type":"string","enum":["extended_read_length"]},{"type":"string","enum":["extended_write_count"]},{"type":"string","enum":["extended_write_length"]}]}}}}}]}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get principal transactions > Returns a list of confirmed transactions sent or received by a Stacks principal, including the transaction summary, the involvement of the principal in the transaction, and the balances affected by the transaction. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/transactions":{"get":{"operationId":"get_principal_transactions","summary":"Get principal transactions","tags":["Transactions"],"description":"Returns a list of confirmed transactions sent or received by a Stacks principal, including the transaction summary, the involvement of the principal in the transaction, and the balances affected by the transaction.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index"},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"type":"object","required":["transaction","involvement","balance_changes","affected_balances"],"properties":{"transaction":{"anyOf":[{"title":"TokenTransferTransactionSummary","description":"Token transfer transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"type":"string"},"amount":{"description":"Transfer amount as Integer string (64-bit unsigned integer)","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"title":"SmartContractTransactionSummary","description":"Smart contract transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["clarity_version","contract_id"],"properties":{"clarity_version":{"anyOf":[{"description":"The Clarity version of the contract. Versioned contract transactions declare it; for the rest it is the version the node resolved from the epoch the contract was deployed in. Null only when it could not be determined, which happens for contracts indexed from a chainstate predating the point where the Stacks node began reporting it.","type":"number"},{"type":"null"}]},"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"}}}}},{"title":"ContractCallTransactionSummary","description":"Contract call transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"},"function_name":{"description":"Name of the Clarity function to be invoked","type":"string"}}}}},{"title":"PoisonMicroblockTransactionSummary","description":"Poison microblock transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"title":"CoinbaseTransactionSummary","description":"Coinbase transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","coinbase"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["coinbase"]},"coinbase":{"type":"object","required":["alt_recipient"],"properties":{"alt_recipient":{"anyOf":[{"description":"A principal that will receive the miner rewards for this coinbase transaction. Can be either a standard principal or contract principal. Only specified for `coinbase-to-alt-recipient` transaction types, otherwise null.","type":"string"},{"type":"null"}]}}}}},{"title":"TenureChangeTransactionSummary","description":"Tenure change transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","tenure_change"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["tenure_change"]},"tenure_change":{"type":"object","required":["cause"],"properties":{"cause":{"description":"Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.","anyOf":[{"type":"string","enum":["block_found"]},{"type":"string","enum":["extended"]},{"type":"string","enum":["extended_runtime"]},{"type":"string","enum":["extended_read_count"]},{"type":"string","enum":["extended_read_length"]},{"type":"string","enum":["extended_write_count"]},{"type":"string","enum":["extended_write_length"]}]}}}}}]},"involvement":{"description":"How the principal is involved in the transaction.","anyOf":[{"type":"string","enum":["sender"]},{"type":"string","enum":["sponsor"]},{"type":"string","enum":["affected"]}]},"balance_changes":{"type":"object","required":["stx"],"properties":{"stx":{"type":"object","required":["sent","received","net"],"properties":{"sent":{"description":"Total sent from the given address, including the tx fee, in micro-STX as an integer string.","type":"string"},"received":{"description":"Total received by the given address in micro-STX as an integer string.","type":"string"},"net":{"description":"Net change in the principal's STX balance in micro-STX as an integer string.","type":"string"}}}}},"affected_balances":{"type":"object","required":["stx","ft","nft"],"properties":{"stx":{"description":"Whether the principal's STX balance was affected by the transaction","type":"boolean"},"ft":{"description":"Whether the principal's FT balance was affected by the transaction","type":"boolean"},"nft":{"description":"Whether the principal's NFT balance was affected by the transaction","type":"boolean"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get inbound STX transfers > Returns the individual inbound STX events crediting a principal. Includes native stx-transfer transactions, \`send-many-memo\` bulk-send legs, any other STX transfer event crediting the principal, and STX mints (which have a null \`sender\`), each with its own sender, amount, and memo. A transaction that credits the principal multiple times yields one result per event. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/transfers/stx/inbound":{"get":{"operationId":"get_principal_inbound_stx_transfers","summary":"Get inbound STX transfers","tags":["Transactions"],"description":"Returns the individual inbound STX events crediting a principal. Includes native stx-transfer transactions, `send-many-memo` bulk-send legs, any other STX transfer event crediting the principal, and STX mints (which have a null `sender`), each with its own sender, amount, and memo. A transaction that credits the principal multiple times yields one result per event.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index"},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"title":"PrincipalStxTransfer","type":"object","required":["sender","recipient","amount","memo","transaction","block"],"properties":{"sender":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"recipient":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]},"transaction":{"type":"object","required":["tx_id","event_index"],"properties":{"tx_id":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"},"event_index":{"description":"Index of the event within the transaction","type":"integer"}}},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get outbound STX transfers > Returns the individual outbound STX events debiting a principal. Includes native stx-transfer transactions, \`send-many-memo\` bulk-send legs, any other STX transfer event debiting the principal, and STX burns (which have a null \`recipient\`), each with its own recipient, amount, and memo. A transaction that debits the principal multiple times yields one result per event. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/transfers/stx/outbound":{"get":{"operationId":"get_principal_outbound_stx_transfers","summary":"Get outbound STX transfers","tags":["Transactions"],"description":"Returns the individual outbound STX events debiting a principal. Includes native stx-transfer transactions, `send-many-memo` bulk-send legs, any other STX transfer event debiting the principal, and STX burns (which have a null `recipient`), each with its own recipient, amount, and memo. A transaction that debits the principal multiple times yields one result per event.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index"},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"title":"PrincipalStxTransfer","type":"object","required":["sender","recipient","amount","memo","transaction","block"],"properties":{"sender":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"recipient":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]},"transaction":{"type":"object","required":["tx_id","event_index"],"properties":{"tx_id":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"},"event_index":{"description":"Index of the event within the transaction","type":"integer"}}},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get fungible token transfers > Returns a principal's transfer history for a single fungible token as one feed, newest first, combining the events that credit it and the events that debit it. Includes mints (which have a null \`sender\`) and burns (which have a null \`recipient\`). A transaction that moves the token several times for this principal yields one result per event. Amounts are in the token's own base units. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/transfers/ft/{asset_identifier}":{"get":{"operationId":"get_principal_ft_transfers","summary":"Get fungible token transfers","tags":["Transactions"],"description":"Returns a principal's transfer history for a single fungible token as one feed, newest first, combining the events that credit it and the events that debit it. Includes mints (which have a null `sender`) and burns (which have a null `recipient`). A transaction that moves the token several times for this principal yields one result per event. Amounts are in the token's own base units.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index"},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true},{"schema":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","type":"string"},"in":"path","name":"asset_identifier","required":true,"description":"Asset Identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating individual events by their position in the chain. Format: block_height:microblock_sequence:tx_index:event_index","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"title":"PrincipalFtTransfer","type":"object","required":["sender","recipient","amount","transaction","block"],"properties":{"sender":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"recipient":{"anyOf":[{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},{"type":"null"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Transfer amount, in the token's own base units","type":"string"},"transaction":{"type":"object","required":["tx_id","event_index"],"properties":{"tx_id":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"},"event_index":{"description":"Index of the event within the transaction","type":"integer"}}},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get principal transaction balance changes > Returns the balance changes for a principal's transaction ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/transactions/{tx_id}/balance-changes":{"get":{"operationId":"get_principal_transaction_balance_changes","summary":"Get principal transaction balance changes","tags":["Transactions"],"description":"Returns the balance changes for a principal's transaction","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:\\S+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating principal transaction balance changes. Format: `:` where `asset_type` is a numeric tag (1=STX, 2=FT, 3=NFT) and `asset_identifier` is `` for STX or a fully-qualified Clarity asset id such as `SP000…contract-name::asset-name` for FT/NFT."},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true},{"schema":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","type":"string"},"in":"path","name":"tx_id","required":true,"description":"Transaction ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating principal transaction balance changes. Format: `:` where `asset_type` is a numeric tag (1=STX, 2=FT, 3=NFT) and `asset_identifier` is `` for STX or a fully-qualified Clarity asset id such as `SP000…contract-name::asset-name` for FT/NFT.","pattern":"^[0-9]+:\\S+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating principal transaction balance changes. Format: `:` where `asset_type` is a numeric tag (1=STX, 2=FT, 3=NFT) and `asset_identifier` is `` for STX or a fully-qualified Clarity asset id such as `SP000…contract-name::asset-name` for FT/NFT.","pattern":"^[0-9]+:\\S+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating principal transaction balance changes. Format: `:` where `asset_type` is a numeric tag (1=STX, 2=FT, 3=NFT) and `asset_identifier` is `` for STX or a fully-qualified Clarity asset id such as `SP000…contract-name::asset-name` for FT/NFT.","pattern":"^[0-9]+:\\S+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"type":"object","required":["asset","balance_change"],"properties":{"asset":{"anyOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["type","identifier"],"properties":{"type":{"description":"The asset type that was affected by the balance change.","anyOf":[{"type":"string","enum":["ft"]},{"type":"string","enum":["nft"]}]},"identifier":{"description":"The identifier of the asset that was affected by the balance change.","type":"string"}}}]},"balance_change":{"type":"object","required":["sent","received","net"],"properties":{"sent":{"description":"Amount sent by the principal","type":"string"},"received":{"description":"Amount received by the principal","type":"string"},"net":{"description":"Net balance change for the principal","type":"string"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get principal balance changes > Returns the balance changes for a principal across one or more transactions, as a single paginated flat array ordered by chain position descending then by asset. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/balance-changes":{"get":{"operationId":"get_principal_balance_changes","summary":"Get principal balance changes","tags":["Transactions"],"description":"Returns the balance changes for a principal across one or more transactions, as a single paginated flat array ordered by chain position descending then by asset.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+:\\S+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating principal balance changes across multiple transactions. Format: `::::`."},{"schema":{"minItems":1,"maxItems":20,"uniqueItems":true,"type":"array","items":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"}},"in":"query","name":"tx_id","required":true,"description":"Transaction ids to query balance changes for. Provide as repeated querystring values (`?tx_id=A&tx_id=B`) or as a single comma-separated value (`?tx_id=A,B`)."},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating principal balance changes across multiple transactions. Format: `::::`.","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+:\\S+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating principal balance changes across multiple transactions. Format: `::::`.","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+:\\S+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating principal balance changes across multiple transactions. Format: `::::`.","pattern":"^[0-9]+:[0-9]+:[0-9]+:[0-9]+:\\S+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"type":"object","required":["tx_id","asset","balance_change"],"properties":{"tx_id":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"},"asset":{"anyOf":[{"type":"object","required":["type"],"properties":{"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["type","identifier"],"properties":{"type":{"description":"The asset type that was affected by the balance change.","anyOf":[{"type":"string","enum":["ft"]},{"type":"string","enum":["nft"]}]},"identifier":{"description":"The identifier of the asset that was affected by the balance change.","type":"string"}}}]},"balance_change":{"type":"object","required":["sent","received","net"],"properties":{"sent":{"description":"Amount sent by the principal","type":"string"},"received":{"description":"Amount received by the principal","type":"string"},"net":{"description":"Net balance change for the principal","type":"string"}}}}}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get principal mempool transactions > Returns a list of pending mempool transactions that involve a principal — as the sender, a token-transfer recipient, the deployed contract, or the called contract. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/principals/{principal}/mempool/transactions":{"get":{"operationId":"get_principal_mempool_transactions","summary":"Get principal mempool transactions","tags":["Transactions"],"description":"Returns a list of pending mempool transactions that involve a principal — as the sender, a token-transfer recipient, the deployed contract, or the called contract.","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^\\d+:(0x)?[a-fA-F0-9]{64}$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating mempool transactions. Format: receipt_time:tx_id"},{"schema":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"in":"path","name":"principal","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"pattern":"^\\d+:(0x)?[a-fA-F0-9]{64}$","description":"Cursor for paginating mempool transactions. Format: receipt_time:tx_id","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"pattern":"^\\d+:(0x)?[a-fA-F0-9]{64}$","description":"Cursor for paginating mempool transactions. Format: receipt_time:tx_id","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"pattern":"^\\d+:(0x)?[a-fA-F0-9]{64}$","description":"Cursor for paginating mempool transactions. Format: receipt_time:tx_id","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"anyOf":[{"title":"TokenTransferMempoolTransactionSummary","description":"Token transfer mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"type":"string"},"amount":{"description":"Transfer amount as Integer string (64-bit unsigned integer)","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"title":"SmartContractMempoolTransactionSummary","description":"Smart contract mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["clarity_version","contract_id"],"properties":{"clarity_version":{"anyOf":[{"description":"The Clarity version of the contract, only specified for versioned contract transactions, otherwise null. A pending deploy has not been executed, so the version an unversioned one will resolve to is not yet known.","type":"number"},{"type":"null"}]},"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"}}}}},{"title":"ContractCallMempoolTransactionSummary","description":"Contract call mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"},"function_name":{"description":"Name of the Clarity function to be invoked","type":"string"}}}}},{"title":"PoisonMicroblockMempoolTransactionSummary","description":"Poison microblock mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"title":"CoinbaseMempoolTransactionSummary","description":"Coinbase mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["coinbase"]}}},{"title":"TenureChangeMempoolTransactionSummary","description":"Tenure change mempool transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"type":{"type":"string","enum":["tenure_change"]}}}]}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get transactions > Retrieves a list of recently mined transactions ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/transactions":{"get":{"operationId":"get_transactions","summary":"Get transactions","tags":["Transactions"],"description":"Retrieves a list of recently mined transactions","parameters":[{"schema":{"minimum":1,"default":20,"maximum":50,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":50,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"description":"Cursor for paginating transactions. Format: block_height:microblock_sequence:tx_index","pattern":"^[0-9]+:[0-9]+:[0-9]+$","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"anyOf":[{"title":"TokenTransferTransactionSummary","description":"Token transfer transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"type":"string"},"amount":{"description":"Transfer amount as Integer string (64-bit unsigned integer)","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"title":"SmartContractTransactionSummary","description":"Smart contract transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["clarity_version","contract_id"],"properties":{"clarity_version":{"anyOf":[{"description":"The Clarity version of the contract. Versioned contract transactions declare it; for the rest it is the version the node resolved from the epoch the contract was deployed in. Null only when it could not be determined, which happens for contracts indexed from a chainstate predating the point where the Stacks node began reporting it.","type":"number"},{"type":"null"}]},"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"}}}}},{"title":"ContractCallTransactionSummary","description":"Contract call transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"},"function_name":{"description":"Name of the Clarity function to be invoked","type":"string"}}}}},{"title":"PoisonMicroblockTransactionSummary","description":"Poison microblock transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"title":"CoinbaseTransactionSummary","description":"Coinbase transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","coinbase"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["coinbase"]},"coinbase":{"type":"object","required":["alt_recipient"],"properties":{"alt_recipient":{"anyOf":[{"description":"A principal that will receive the miner rewards for this coinbase transaction. Can be either a standard principal or contract principal. Only specified for `coinbase-to-alt-recipient` transaction types, otherwise null.","type":"string"},{"type":"null"}]}}}}},{"title":"TenureChangeTransactionSummary","description":"Tenure change transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","tenure_change"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["tenure_change"]},"tenure_change":{"type":"object","required":["cause"],"properties":{"cause":{"description":"Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.","anyOf":[{"type":"string","enum":["block_found"]},{"type":"string","enum":["extended"]},{"type":"string","enum":["extended_runtime"]},{"type":"string","enum":["extended_read_count"]},{"type":"string","enum":["extended_read_length"]},{"type":"string","enum":["extended_write_count"]},{"type":"string","enum":["extended_write_length"]}]}}}}}]}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get a batch of transactions > Retrieves the summaries of up to 20 mined transactions in a single call, given their transaction ids. Provide them as repeated querystring values (\`?tx\_id=A\&tx\_id=B\`) or as a single comma-separated value (\`?tx\_id=A,B\`). Results are returned in canonical chain order (newest first), not in the order the ids were supplied. Only transactions mined in the canonical chain are returned: an id that is unknown, non-canonical, or still in the mempool is absent from \`results\` rather than reported as an error, so compare the response against the ids you sent to find the ones that did not resolve. Use \`GET /extended/v3/transactions/{tx\_id}\` for a single transaction, which also covers mempool transactions. ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/transactions/batch":{"get":{"operationId":"get_transactions_batch","summary":"Get a batch of transactions","tags":["Transactions"],"description":"Retrieves the summaries of up to 20 mined transactions in a single call, given their transaction ids. Provide them as repeated querystring values (`?tx_id=A&tx_id=B`) or as a single comma-separated value (`?tx_id=A,B`). Results are returned in canonical chain order (newest first), not in the order the ids were supplied. Only transactions mined in the canonical chain are returned: an id that is unknown, non-canonical, or still in the mempool is absent from `results` rather than reported as an error, so compare the response against the ids you sent to find the ones that did not resolve. Use `GET /extended/v3/transactions/{tx_id}` for a single transaction, which also covers mempool transactions.","parameters":[{"schema":{"minItems":1,"maxItems":20,"uniqueItems":true,"type":"array","items":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","description":"Transaction ID","type":"string"}},"in":"query","name":"tx_id","required":true,"description":"Transaction ids to fetch summaries for. Provide as repeated querystring values (`?tx_id=A&tx_id=B`) or as a single comma-separated value (`?tx_id=A,B`)."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"title":"TransactionBatchResponse","type":"object","required":["results"],"properties":{"results":{"type":"array","items":{"anyOf":[{"title":"TokenTransferTransactionSummary","description":"Token transfer transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"type":"string"},"amount":{"description":"Transfer amount as Integer string (64-bit unsigned integer)","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"title":"SmartContractTransactionSummary","description":"Smart contract transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["clarity_version","contract_id"],"properties":{"clarity_version":{"anyOf":[{"description":"The Clarity version of the contract. Versioned contract transactions declare it; for the rest it is the version the node resolved from the epoch the contract was deployed in. Null only when it could not be determined, which happens for contracts indexed from a chainstate predating the point where the Stacks node began reporting it.","type":"number"},{"type":"null"}]},"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"}}}}},{"title":"ContractCallTransactionSummary","description":"Contract call transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract identifier formatted as `.`","type":"string"},"function_name":{"description":"Name of the Clarity function to be invoked","type":"string"}}}}},{"title":"PoisonMicroblockTransactionSummary","description":"Poison microblock transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"title":"CoinbaseTransactionSummary","description":"Coinbase transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","coinbase"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["coinbase"]},"coinbase":{"type":"object","required":["alt_recipient"],"properties":{"alt_recipient":{"anyOf":[{"description":"A principal that will receive the miner rewards for this coinbase transaction. Can be either a standard principal or contract principal. Only specified for `coinbase-to-alt-recipient` transaction types, otherwise null.","type":"string"},{"type":"null"}]}}}}},{"title":"TenureChangeTransactionSummary","description":"Tenure change transaction summary","type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","type","tenure_change"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"type":{"type":"string","enum":["tenure_change"]},"tenure_change":{"type":"object","required":["cause"],"properties":{"cause":{"description":"Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.","anyOf":[{"type":"string","enum":["block_found"]},{"type":"string","enum":["extended"]},{"type":"string","enum":["extended_runtime"]},{"type":"string","enum":["extended_read_count"]},{"type":"string","enum":["extended_read_length"]},{"type":"string","enum":["extended_write_count"]},{"type":"string","enum":["extended_write_length"]}]}}}}}]}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get transaction > Retrieves details for a given transaction, including both mined and mempool transactions ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/transactions/{tx_id}":{"get":{"operationId":"get_transaction","summary":"Get transaction","tags":["Transactions"],"description":"Retrieves details for a given transaction, including both mined and mempool transactions","parameters":[{"schema":{"uniqueItems":true,"type":"array","items":{"anyOf":[{"type":"string","enum":["function_args"]},{"type":"string","enum":["source_code"]},{"type":"string","enum":["post_conditions"]},{"type":"string","enum":["result"]}]}},"in":"query","name":"include","required":false,"description":"Heavy fields to include in the response. Omitted by default to keep the payload lean. Provide as repeated querystring values (`?include=A&include=B`) or as a single comma-separated value (`?include=A,B`)."},{"schema":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","type":"string"},"in":"path","name":"tx_id","required":true,"description":"Transaction ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"anyOf":[{"anyOf":[{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"description":"Recipient of the token transfer","type":"string"},"amount":{"description":"Amount of the token transfer","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["contract_id","clarity_version"],"properties":{"contract_id":{"description":"Contract ID of the smart contract","type":"string"},"clarity_version":{"anyOf":[{"description":"Clarity version of the smart contract","type":"number"},{"type":"null"}]},"source_code":{"description":"Source code of the smart contract. Only present when requested via the `include=source_code` query param.","type":"string"}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract ID of the contract call","type":"string"},"function_name":{"description":"Function name of the contract call","type":"string"},"function_args":{"description":"List of arguments used to invoke the function. Only present when requested via the `include=function_args` query param.","type":"array","items":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["poison_microblock"]}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type","tenure_change"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["tenure_change"]},"tenure_change":{"type":"object","required":["tenure_consensus_hash","prev_tenure_consensus_hash","burn_view_consensus_hash","previous_tenure_end","previous_tenure_blocks","cause","pubkey_hash"],"properties":{"tenure_consensus_hash":{"description":"Consensus hash of this tenure. Corresponds to the sortition in which the miner of this block was chosen.","type":"string"},"prev_tenure_consensus_hash":{"description":"Consensus hash of the previous tenure. Corresponds to the sortition of the previous winning block-commit.","type":"string"},"burn_view_consensus_hash":{"description":"Current consensus hash on the underlying burnchain. Corresponds to the last-seen sortition.","type":"string"},"previous_tenure_end":{"description":"(Hex string) Stacks Block hash","type":"string"},"previous_tenure_blocks":{"description":"The number of blocks produced in the previous tenure.","type":"integer"},"cause":{"description":"Cause of change in mining tenure. Depending on cause, tenure can be ended or extended.","anyOf":[{"type":"string","enum":["block_found"]},{"type":"string","enum":["extended"]},{"type":"string","enum":["extended_runtime"]},{"type":"string","enum":["extended_read_count"]},{"type":"string","enum":["extended_read_length"]},{"type":"string","enum":["extended_write_count"]},{"type":"string","enum":["extended_write_length"]}]},"pubkey_hash":{"description":"(Hex string) The ECDSA public key hash of the current tenure.","type":"string"}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","block","bitcoin_block","status","parent_block","event_count","execution_cost","vm_error","type","coinbase"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"block":{"type":"object","required":["height","hash","index_hash","time","time_iso","tx_index"],"properties":{"height":{"description":"Height of the block this transactions was associated with","type":"integer"},"hash":{"description":"Hash of the blocked this transactions was associated with","type":"string"},"index_hash":{"description":"Hash of the index block this transactions was associated with","type":"string"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"tx_index":{"description":"Index of the transaction, indicating the order. Starts at `0` and increases with each transaction","type":"integer"}}},"bitcoin_block":{"type":"object","required":["height","time","time_iso"],"properties":{"height":{"description":"Height of the anchor burn block.","type":"integer"},"time":{"description":"Unix timestamp (in seconds) indicating when this block was mined.","type":"number"},"time_iso":{"description":"The `time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"}}},"status":{"description":"Status of the transaction","anyOf":[{"type":"string","enum":["success"]},{"type":"string","enum":["abort_by_response"]},{"type":"string","enum":["abort_by_post_condition"]},{"type":"string","enum":["problematic_skipped"]}]},"parent_block":{"type":"object","required":["hash","index_hash"],"properties":{"hash":{"description":"Hash of the parent block","type":"string"},"index_hash":{"description":"Index block hash of the parent block","type":"string"}}},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"event_count":{"description":"Number of events in the transaction","type":"integer"},"execution_cost":{"type":"object","required":["read_count","read_length","runtime","write_count","write_length"],"properties":{"read_count":{"description":"Number of reads in the transaction","type":"integer"},"read_length":{"description":"Length of reads in the transaction","type":"integer"},"runtime":{"description":"Runtime of the transaction","type":"integer"},"write_count":{"description":"Number of writes in the transaction","type":"integer"},"write_length":{"description":"Length of writes in the transaction","type":"integer"}}},"vm_error":{"anyOf":[{"description":"VM error of the transaction","type":"string"},{"type":"null"}]},"result":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"type":{"type":"string","enum":["coinbase"]},"coinbase":{"type":"object","required":["payload","alt_recipient","vrf_proof"],"properties":{"payload":{"description":"Payload of the coinbase transaction","type":"string"},"alt_recipient":{"anyOf":[{"description":"Alt recipient of the coinbase transaction","type":"string"},{"type":"null"}]},"vrf_proof":{"anyOf":[{"description":"VRF proof of the coinbase transaction","type":"string"},{"type":"null"}]}}}}}]},{"anyOf":[{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type","token_transfer"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["token_transfer"]},"token_transfer":{"type":"object","required":["recipient","amount","memo"],"properties":{"recipient":{"description":"Recipient of the token transfer","type":"string"},"amount":{"description":"Amount of the token transfer","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type","smart_contract"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["smart_contract"]},"smart_contract":{"type":"object","required":["contract_id","clarity_version"],"properties":{"contract_id":{"description":"Contract ID of the smart contract","type":"string"},"clarity_version":{"anyOf":[{"description":"Clarity version of the smart contract","type":"number"},{"type":"null"}]},"source_code":{"description":"Source code of the smart contract. Only present when requested via the `include=source_code` query param.","type":"string"}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type","contract_call"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["contract_call"]},"contract_call":{"type":"object","required":["contract_id","function_name"],"properties":{"contract_id":{"description":"Contract ID of the contract call","type":"string"},"function_name":{"description":"Function name of the contract call","type":"string"},"function_args":{"description":"List of arguments used to invoke the function. Only present when requested via the `include=function_args` query param.","type":"array","items":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}}}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["poison_microblock"]}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["tenure_change"]}}},{"type":"object","required":["tx_id","sender","sponsor","fee_rate","receipt_time","receipt_time_iso","receipt_block_height","status","replaced_by_tx_id","type"],"properties":{"tx_id":{"description":"Transaction ID","type":"string"},"sender":{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},"sponsor":{"anyOf":[{"type":"object","required":["address","nonce"],"properties":{"address":{"description":"Address of the transaction initiator","type":"string"},"nonce":{"description":"Nonce of the transaction initiator","type":"integer"}}},{"type":"null"}]},"fee_rate":{"description":"Transaction fee as Integer string (64-bit unsigned integer).","type":"string"},"receipt_time":{"description":"A unix timestamp (in seconds) indicating when the transaction broadcast was received by the node.","type":"integer"},"receipt_time_iso":{"description":"The `receipt_time` as an ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) UTC timestamp.","type":"string"},"receipt_block_height":{"description":"Height of the block this transaction was received by the node","type":"integer"},"status":{"description":"Status of the mempool transaction","anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["dropped_replace_by_fee"]},{"type":"string","enum":["dropped_replace_across_fork"]},{"type":"string","enum":["dropped_too_expensive"]},{"type":"string","enum":["dropped_stale_garbage_collect"]},{"type":"string","enum":["dropped_problematic"]}]},"post_condition_mode":{"description":"Post condition mode of the transaction. Only present when requested via the `include=post_conditions` query param.","anyOf":[{"type":"string","enum":["allow"]},{"type":"string","enum":["deny"]},{"type":"string","enum":["originator"]}]},"post_conditions":{"description":"Only present when requested via the `include=post_conditions` query param.","type":"array","items":{"anyOf":[{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["stx"]}}},{"type":"object","required":["principal","condition_code","amount","type","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["fungible"]},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","type","asset_value","asset"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent"]},{"type":"string","enum":["not_sent"]},{"type":"string","enum":["maybe_sent"]}]},"type":{"type":"string","enum":["non_fungible"]},"asset_value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},"asset":{"type":"object","required":["asset_name","contract_address","contract_name"],"properties":{"asset_name":{"type":"string"},"contract_address":{"type":"string"},"contract_name":{"type":"string"}}}}},{"type":"object","required":["principal","condition_code","amount","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["sent_equal_to"]},{"type":"string","enum":["sent_greater_than"]},{"type":"string","enum":["sent_greater_than_or_equal_to"]},{"type":"string","enum":["sent_less_than"]},{"type":"string","enum":["sent_less_than_or_equal_to"]}]},"amount":{"type":"string"},"type":{"type":"string","enum":["staking"]}}},{"type":"object","required":["principal","condition_code","type"],"properties":{"principal":{"anyOf":[{"type":"object","required":["type_id"],"properties":{"type_id":{"type":"string","enum":["principal_origin"]}}},{"type":"object","required":["type_id","address"],"properties":{"type_id":{"type":"string","enum":["principal_standard"]},"address":{"type":"string"}}},{"type":"object","required":["type_id","address","contract_name"],"properties":{"type_id":{"type":"string","enum":["principal_contract"]},"address":{"type":"string"},"contract_name":{"type":"string"}}}]},"condition_code":{"anyOf":[{"type":"string","enum":["not_performed"]},{"type":"string","enum":["maybe_performed"]},{"type":"string","enum":["performed"]}]},"type":{"type":"string","enum":["pox"]}}}]}},"replaced_by_tx_id":{"anyOf":[{"description":"ID of another transaction which replaced this one","type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["coinbase"]}}}]}]}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` ## Get transaction events > Retrieves events for a given transaction ID ```json {"openapi":"3.0.3","info":{"title":"Stacks Blockchain API","version":"9.6.0"},"tags":[{"name":"Transactions","description":"Endpoints to obtain transaction details and to broadcast transactions to the network"}],"servers":[{"url":"https://api.hiro.so/","description":"mainnet"}],"paths":{"/extended/v3/transactions/{tx_id}/events":{"get":{"operationId":"get_transaction_events","summary":"Get transaction events","tags":["Transactions"],"description":"Retrieves events for a given transaction ID","parameters":[{"schema":{"minimum":1,"default":20,"maximum":100,"type":"integer"},"in":"query","name":"limit","required":false,"description":"Number of results per page"},{"schema":{"pattern":"^[0-9]+$","type":"string"},"in":"query","name":"cursor","required":false,"description":"Cursor for paginating transaction events. Format: event_index"},{"schema":{"pattern":"^(0x)?[a-fA-F0-9]{64}$","title":"Transaction ID","type":"string"},"in":"path","name":"tx_id","required":true,"description":"Transaction ID"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["total","limit","cursor","results"],"properties":{"total":{"type":"integer"},"limit":{"minimum":1,"default":20,"maximum":100,"description":"Number of results per page","type":"integer"},"cursor":{"type":"object","required":["next","previous","current"],"properties":{"next":{"anyOf":[{"pattern":"^[0-9]+$","description":"Cursor for paginating transaction events. Format: event_index","type":"string"},{"type":"null"}]},"previous":{"anyOf":[{"pattern":"^[0-9]+$","description":"Cursor for paginating transaction events. Format: event_index","type":"string"},{"type":"null"}]},"current":{"anyOf":[{"pattern":"^[0-9]+$","description":"Cursor for paginating transaction events. Format: event_index","type":"string"},{"type":"null"}]}}},"results":{"type":"array","items":{"anyOf":[{"type":"object","required":["event_index","type","contract_log"],"properties":{"event_index":{"type":"integer"},"type":{"type":"string","enum":["contract_log"]},"contract_log":{"type":"object","required":["contract_id","topic","value"],"properties":{"contract_id":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"},"topic":{"type":"string","enum":["print"]},"value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}}}},{"type":"object","required":["event_index","type","stx_lock"],"properties":{"event_index":{"type":"integer"},"type":{"type":"string","enum":["stx_lock"]},"stx_lock":{"type":"object","required":["amount","unlock_bitcoin_height","address"],"properties":{"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"},"unlock_bitcoin_height":{"title":"Block height","description":"Block height","type":"integer"},"address":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]}}}}},{"type":"object","required":["event_index","type","stx_asset"],"properties":{"event_index":{"type":"integer"},"type":{"type":"string","enum":["stx_asset"]},"stx_asset":{"anyOf":[{"type":"object","required":["type","sender","recipient","amount","memo"],"properties":{"type":{"type":"string","enum":["transfer"]},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"},"memo":{"anyOf":[{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}},{"type":"null"}]}}},{"type":"object","required":["type","recipient","amount"],"properties":{"type":{"type":"string","enum":["mint"]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"}}},{"type":"object","required":["type","sender","amount"],"properties":{"type":{"type":"string","enum":["burn"]},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"}}}]}}},{"type":"object","required":["event_index","type","ft_asset"],"properties":{"event_index":{"type":"integer"},"type":{"type":"string","enum":["ft_asset"]},"ft_asset":{"anyOf":[{"type":"object","required":["type","asset_identifier","sender","recipient","amount"],"properties":{"type":{"type":"string","enum":["transfer"]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"}}},{"type":"object","required":["type","recipient","asset_identifier","amount"],"properties":{"type":{"type":"string","enum":["mint"]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"}}},{"type":"object","required":["type","sender","asset_identifier","amount"],"properties":{"type":{"type":"string","enum":["burn"]},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"amount":{"pattern":"^[0-9]+$","title":"Amount","description":"Amount","type":"string"}}}]}}},{"type":"object","required":["event_index","type","nft_asset"],"properties":{"event_index":{"type":"integer"},"type":{"type":"string","enum":["nft_asset"]},"nft_asset":{"anyOf":[{"type":"object","required":["type","asset_identifier","sender","recipient","value"],"properties":{"type":{"type":"string","enum":["transfer"]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}},{"type":"object","required":["type","recipient","asset_identifier","value"],"properties":{"type":{"type":"string","enum":["mint"]},"recipient":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}},{"type":"object","required":["type","sender","asset_identifier","value"],"properties":{"type":{"type":"string","enum":["burn"]},"sender":{"anyOf":[{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}$","title":"Stacks Address","description":"Stacks Address","type":"string"},{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}$","title":"Smart Contract ID","description":"Smart Contract ID","type":"string"}]},"asset_identifier":{"pattern":"^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{28,41}\\.[a-zA-Z]([a-zA-Z0-9]|[-_]){0,39}::[a-zA-Z]([a-zA-Z0-9]|[-_!?+<>=/*]){0,127}$","title":"Asset Identifier","description":"Asset Identifier","type":"string"},"value":{"type":"object","required":["hex","repr"],"properties":{"hex":{"type":"string"},"repr":{"type":"string"}}}}}]}}}]}}}}}}},"4XX":{"description":"Default Response","content":{"application/json":{"schema":{"title":"Error Response","additionalProperties":true,"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}}}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.stacks.co/reference/api/stacks-blockchain-api/transactions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.