API-Based Stateless Transaction

Stateless Transaction Lookup API

Query any on-chain transaction by its hash — without persisting anything to the database. The API fetches the transaction directly from the blockchain RPC, parses it into a structured format with sub-transactions, balance changes, and enriched asset metadata, and returns it in a single GraphQL call.

GraphQL Endpoint

POST /graphql

Query

query GetStatelessTransaction($txHash: String!, $platform: Platform!) {
  getStatelessTransaction(txHash: $txHash, platform: $platform) {
    identifier
    platform
    fromAddress
    toAddress
    blockNumber
    timestamp
    success
    methodId
    decodedFunctionName
    subTransactions {
      typeId
      sender
      recipient
      assetIdentifier
      asset {
        identifier
        symbol
        name
        decimals
      }
      amount
      type
      balanceFactor
      timestamp
    }
    balanceChanges {
      account
      assetIdentifier
      asset {
        identifier
        symbol
        name
        decimals
      }
      balanceBefore
      balanceAfter
      diff
    }
  }
}

Variables

Example Request

{
  "query": "query($txHash: String!, $platform: Platform!) { getStatelessTransaction(txHash: $txHash, platform: $platform) { identifier platform fromAddress toAddress blockNumber timestamp success methodId decodedFunctionName subTransactions { typeId sender recipient assetIdentifier asset { identifier symbol name decimals } amount type balanceFactor } balanceChanges { account assetIdentifier asset { identifier symbol name decimals } balanceBefore balanceAfter diff } } }",
  "variables": {
    "txHash": "0x1a2c1d615f1812def157f57cbe2a050ea0b610d60b27bad0ea60e3e47d206030",
    "platform": "ETHEREUM"
  }
}

Example Response

{
  "data": {
    "getStatelessTransaction": {
      "identifier": "0x1a2c1d615f1812def157f57cbe2a050ea0b610d60b27bad0ea60e3e47d206030",
      "platform": "ETHEREUM",
      "fromAddress": "0xabc...123",
      "toAddress": "0xdef...456",
      "blockNumber": 18500000,
      "timestamp": "2024-10-28T12:34:56+00:00",
      "success": true,
      "methodId": "0xa9059cbb",
      "decodedFunctionName": "transfer",
      "subTransactions": [
        {
          "typeId": "log_0",
          "sender": "0xabc...123",
          "recipient": "0xdef...456",
          "assetIdentifier": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "asset": {
            "identifier": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "symbol": "USDT",
            "name": "Tether USD",
            "decimals": 6
          },
          "amount": "1000.50",
          "type": "TOKEN_TRANSFER",
          "balanceFactor": -1
        },
        {
          "typeId": "gas",
          "sender": "0xabc...123",
          "recipient": "0x0000000000000000000000000000000000000000",
          "assetIdentifier": "native",
          "asset": {
            "identifier": "native",
            "symbol": "ETH",
            "name": null,
            "decimals": 18
          },
          "amount": "0.002145",
          "type": "GAS",
          "balanceFactor": -1
        }
      ],
      "balanceChanges": [
        {
          "account": "0xabc...123",
          "assetIdentifier": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "asset": {
            "identifier": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "symbol": "USDT",
            "name": "Tether USD",
            "decimals": 6
          },
          "balanceBefore": "5000.00",
          "balanceAfter": "3999.50",
          "diff": "-1000.50"
        }
      ]
    }
  }
}

Response Fields

Transaction (top level)

SubTransaction

Each sub-transaction represents a single value movement (native transfer, token transfer, or gas fee).

BalanceChange

Shows the on-chain balance of each account+asset pair immediately before and after the transaction.

AssetInfo

Supported Networks

All EVM-compatible blockchains are supported. Pass the network name as the platform variable.

The full list includes 100+ EVM networks. Any chain listed under the Platform enum with EVM support will work. If a network is missing, contact us.

How It Works

1. Fetch — The transaction and its receipt are fetched from the chain's RPC node.

2. Parse — Native transfers, ERC-20 token transfers (from event logs), and gas fees are extracted into sub-transactions.

3. Balance snapshots — For each account+asset involved, the on-chain balance is queried at blockNumber - 1 (before) and blockNumber (after).

4. Asset enrichment — Each asset is enriched with symbol, name, and decimals from our database. If an asset is unknown, decimals are fetched directly from the token contract's RPC.

5. Function decoding — The method ID is resolved to a human-readable function name using the contract's ABI (if available) or a signature database.

Limitations

Error Handling

All errors are logged server-side. If you consistently get null for a valid transaction, contact support.

Testing with cURL

curl -X POST https://<your-bff-host>/graphql \\\\
  -H "Content-Type: application/json" \\\\
  -H "Authorization: Bearer <your-jwt-token>" \\\\
  -d '{
    "query": "query($txHash: String!, $platform: Platform!) { getStatelessTransaction(txHash: $txHash, platform: $platform) { identifier platform fromAddress toAddress blockNumber timestamp success methodId decodedFunctionName subTransactions { typeId sender recipient assetIdentifier asset { identifier symbol name decimals } amount type balanceFactor } balanceChanges { account assetIdentifier asset { identifier symbol name decimals } balanceBefore balanceAfter diff } } }",
    "variables": {
      "txHash": "0x1a2c1d615f1812def157f57cbe2a050ea0b610d60b27bad0ea60e3e47d206030",
      "platform": "ETHEREUM"
    }
  }'

Testing with Postman

1. Set the request to POST https://<your-bff-host>/graphql

2. Under Headers, add:

   • Content-Type: application/json

   • Authorization: Bearer <your-jwt-token>

3. Under Body (raw JSON), paste the query and variables from the example above

4. Click Send

Testing with GraphiQL

If you have access to the BFF's GraphiQL interface (/graphql in a browser), you can paste the query directly and provide the variables in the Variables panel. Note that GraphiQL requests from localhost may bypass authentication for introspection, but the actual query still requires a valid token in the Authorization header.