wallet

Get transaction by hash

Returns a transaction by its hash. The **chain** query parameter is required because the same hash format can exist on different chains (e.g. 0x-style on EVM chains).

GET/api/wallet/non-custodial/transactions/{txHash}

Authentication

Requires JWT

Note

Include your JWT in the Authorization: Bearer YOUR_TOKEN header (user-facing apps, RBAC). View authentication guide →

Path Parameters

Name	Type	Required	Description
`txHash`	string	Yes	Transaction hash (e.g. 0x... for EVM, or block explorer format for UTXO)

Query Parameters

Name	Type	Required	Description
`chain`	string	Yes	Chain the transaction belongs to (required for lookup)

SDK setup

Create a client and set credentials (JWT and/or API key) before calling the API. Match the authentication type shown above.

import { MudbaseClient } from "mudbase";

const client = new MudbaseClient();
client.setJWT("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig");
import { MudbaseClient } from "mudbase";

const client = new MudbaseClient();
client.setJWT("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig");

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const result = await client.wallet.getTransactionByHash({
  txHash: "feed connect"
});
const result = await client.wallet.getTransactionByHash({
  txHash: "feed connect"
});

Try It Live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

JWT Bearer Token Use the auth endpoints to obtain a JWT.

Path Parameters

txHash

Query Parameters

chain*

No Request Yet

Send a request to see the full inspector

Responses

200Transaction details

json

{
  "success": true,
  "data": {
    "_id": "65a1b2c3d4e5f6789012345b",
    "txHash": "0xabc123def4567890123456789012345678901234567890123456789012345678",
    "mainTxHash": "0xabc123def4567890123456789012345678901234567890123456789012345678",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "chain": "ethereum",
    "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "to": "0xdef4567890123456789012345678901234567890",
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "toAddress": "0xdef4567890123456789012345678901234567890",
    "amount": "0.1",
    "currency": "ETH",
    "type": "transfer",
    "status": "completed",
    "mainTxStatus": "confirmed",
    "confirmations": 12,
    "blockNumber": 12345678,
    "blockHash": "0xdef7890123456789012345678901234567890123456789012345678901234567",
    "networkFee": "0.00021",
    "mainTxConfirmedAt": "2026-01-22T10:00:00.000Z",
    "tokenTransfers": [
      {
        "tokenAddress": "0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e",
        "from": "0x1194d844f5c5a9adc488835e1f506dafbb579341",
        "to": "0x000000000000000000000000000000000ce106a5",
        "value": "80",
        "formattedAmount": "0.000076",
        "tokenSymbol": "USD₮",
        "tokenDecimals": 6,
        "isIncoming": true
      }
    ],
    "createdAt": "2026-01-22T10:00:00.000Z",
    "updatedAt": "2026-01-22T10:00:00.000Z"
  }
}
{
  "success": true,
  "data": {
    "_id": "65a1b2c3d4e5f6789012345b",
    "txHash": "0xabc123def4567890123456789012345678901234567890123456789012345678",
    "mainTxHash": "0xabc123def4567890123456789012345678901234567890123456789012345678",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "chain": "ethereum",
    "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "to": "0xdef4567890123456789012345678901234567890",
    "fromAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "toAddress": "0xdef4567890123456789012345678901234567890",
    "amount": "0.1",
    "currency": "ETH",
    "type": "transfer",
    "status": "completed",
    "mainTxStatus": "confirmed",
    "confirmations": 12,
    "blockNumber": 12345678,
    "blockHash": "0xdef7890123456789012345678901234567890123456789012345678901234567",
    "networkFee": "0.00021",
    "mainTxConfirmedAt": "2026-01-22T10:00:00.000Z",
    "tokenTransfers": [
      {
        "tokenAddress": "0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e",
        "from": "0x1194d844f5c5a9adc488835e1f506dafbb579341",
        "to": "0x000000000000000000000000000000000ce106a5",
        "value": "80",
        "formattedAmount": "0.000076",
        "tokenSymbol": "USD₮",
        "tokenDecimals": 6,
        "isIncoming": true
      }
    ],
    "createdAt": "2026-01-22T10:00:00.000Z",
    "updatedAt": "2026-01-22T10:00:00.000Z"
  }
}

400Bad Request - missing or invalid chain (add ?chain=ethereum)

json

{
  "success": false,
  "error": "Chain parameter is required. Add ?chain=ethereum (or binance, polygon, celo, bitcoin) to your request."
}
{
  "success": false,
  "error": "Chain parameter is required. Add ?chain=ethereum (or binance, polygon, celo, bitcoin) to your request."
}

401Authentication required or invalid token.

404Transaction not found (exact backend message).

429Rate limit exceeded.

Errors

Code	Meaning
`400`	Bad Request - missing or invalid chain (add ?chain=ethereum)
`401`	Authentication required or invalid token.
`404`	Transaction not found (exact backend message).
`429`	Rate limit exceeded.

Run in Postman Download OpenAPI

Next steps

Edit this page on GitHub