# 🔎 Decode Transaction API

The **Decode Transaction API** allows you to decode any blockchain transaction into a structured and human-readable format.

* **Input**:
  *  **`tx_hash`** :string ***(required)*** – the hash of the transaction you want to decode.
  *  **`type`** : string (optional)- protocol type, e.g: DEX .
  *  **`protocol`** : string (optional)- protocol name, e.g:  Uniswap V4 .
  *  **`token`** : string (optional)- token address involving in the transaction.
* **Output**: A standardized JSON object that includes the transaction’s protocol type, user action, participants, tokens involved, value in USD, and other relevant metadata.

This API makes it easy to transform raw blockchain transaction data into meaningful business or user activity insights.

**Endpoint**<br>

```
https://[chain_name]-api.txdecoder.xyz/premium/transaction/decode?tx_hash=[transaction_hash]

```

**Example code**

```javascript
const axios = require('axios')

const main = async() => {
    const { data } = await axios.get(
    `https://ethereum-api.txdecoder.xyz/premium/transaction/decode?tx_hash=0xf74e5042eb57b5cd0e308e8b3108c9a0d631514829aeee728e40e61564ced0ba`,
    {
        headers: {
            "x-api-key": process.env.API_KEY
        }
    })
    console.log(data)
}
main()

```

\
**Response format**

```javascript
{
    [transaction_hash]: [
        // List of user actions
    ]
}
```

**Example Response**<br>

```
{
    "0xf74e5042eb57b5cd0e308e8b3108c9a0d631514829aeee728e40e61564ced0ba": [
        {
            "type": "LENDING",
            "protocol": "Morpho",
            "source": "Morpho",
            "action": "repay",
            "participants": [
                {
                    "address": "0x9fb1750Da6266a05601855bb62767eBC742707B1",
                    "type": "signer"
                },
                {
                    "address": "0x9fb1750Da6266a05601855bb62767eBC742707B1",
                    "type": "repayer"
                },
                {
                    "address": "0x4095F064B8d3c3548A3bebfd0Bbfd04750E30077",
                    "type": "initiator"
                }
            ],
            "pool_id": "0xBBBBBbbBBb9cC5e90e3b3Af64bdAF62C37EEFFCb",
            "tokens": [
                {
                    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                    "name": "USD Coin",
                    "symbol": "USDC",
                    "decimals": 6,
                    "amount": "264463759538",
                    "ui_amount": "264463.759538"
                }
            ],
            "value_usd": 264463.759538,
            "extra_data": {
                "shares": "246984185247671317"
            },
            "log_index": 89,
            "block_number": 23187124,
            "block_hash": "0x0226dfc0c5ab0b5cc331d94bbda20664e28ce8aa730777a9855d42c7cd79ccae",
            "tx_hash": "0xf74e5042eb57b5cd0e308e8b3108c9a0d631514829aeee728e40e61564ced0ba",
            "timestamp": 1755751139
        },
    ]
}

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://txdecoder.gitbook.io/docs/api-documentations/decode-transaction-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.