Check Transaction Skill

This skill allows users to check the status of a blockchain transaction by providing a TxId. It queries the AOX transaction API (https://api.aox.xyz/tx/[txid]) and returns a human-readable summary of the transaction.

API Endpoint

URL: https://api.aox.xyz/tx/[txid]
Method: GET
Authentication: None required

Example Request:

curl -s "https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"

Example JSON Response:

{ "rawId": 1773112604581, "createdAt": "2026-03-10T03:16:44.581Z", "updatedAt": "2026-03-10T03:22:18.7Z", "txType": "mint", "chainType": "arweave", "txId": "ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs", "sender": "kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134", "recipient": "kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134", "quantity": "25100000000000", "symbol": "AR", "decimals": 12, "blockHeight": 1873352, "fromTokenId": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA", "toTokenId": "xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10", "fee": "0", "feeRecipient": "", "confirmNum": 10, "confirmRange": -1670, "status": "waiting", "targetChainTxHash": "" }

Skill Usage

User Queries:

Example Input: "Check transaction ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Output: Returns status, amount, sender, receiver, confirmations, and timestamp

Example Input: "Status of TxId ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"
Output: Structured transaction info

CLI Example:

Query a transaction

curl -s "https://api.aox.xyz/tx/ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs"

Sample Output (Human-Readable):

Transaction Status: ⏳ Waiting TxId: ZKmbSYqAYGMJKVldJ6nqDG_wT9SRBy44YDa6XNrfIUs Type: mint Chain: arweave From: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134 To: kRdpOYaT5pUUiNFDaUymqO1VcybZpAfNPnNdls-A134 Amount: 25.1 AR (quantity: 25100000000000, decimals: 12) Block Height: 1873352 From Token ID: AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA To Token ID: xU9zFkq3X2ZQ6olwNVvr1vUWIjc3kXTWr7xKQD6dh10 Fee: 0 Confirmations: 10 Confirm Range: -1670 Target Chain Tx Hash: (empty) Created At: 2026-03-10T03:16:44.581Z Updated At: 2026-03-10T03:22:18.7Z

Notes & Best Practices

1. TxId format: Must start with 0x or valid AOX format.
2. Error handling: If the TxId is invalid or not found, the API will return an error:

{ "error": "Transaction not found" }

3. Confirmations: Include confirmNum to show network confirmation count.
4. No API key required: Public endpoint, no authentication needed.
5. JSON vs human-readable: The agent should format the JSON into readable message.
6. Amount calculation: amount = quantity / (10^decimals)
7. Status mapping:
   • waiting → ⏳ Waiting
   • success → ✅ Success
   • failed → ❌ Failed
8. Target chain hash: If targetChainTxHash exists, display for cross-chain info.

References