Merkl Developer Portal logo
get

/v4/analytics/transactions/{chainId}

Get states by transaction hashes (V2)

Retrieves position states associated with the given transaction hashes from the V2 position_states table. Returns enriched state data including protocol, action, and token metadata derived from state descriptions. States of a set holding decrypted confidential amounts (Zama ERC-7984 plaintext balances) are withheld.

Path parameters

chainIdnumber | string
required

Chain ID to query

Query parameters

txHashesstring
required

Comma-separated transaction hashes (e.g., 0x123,0x456)

positionKeyFilterstring

Optional substring filter for position key

timestampsstring

Comma-separated Unix timestamps (seconds) aligned with txHashes

Responses

200
Response for status 200
Schema
object
dataobject[]
required
stateTypeenumpositionglobal
blockNumbernumber
blockTimestampnumber
chainIdnumber
storingIdstring
positionKeystring
positionGranularityKeystring
ownerstring
protocolstring
actionstring
identifierstring
stateany
txHashesstring[]
totalCountnumber
required
Total number of states found
Example
{
  "data": [
    {
      "stateType": "position",
      "blockNumber": 0,
      "blockTimestamp": 0,
      "chainId": 0,
      "storingId": "string",
      "positionKey": "string",
      "positionGranularityKey": "string",
      "owner": "string",
      "protocol": "string",
      "action": "string",
      "identifier": "string",
      "state": null,
      "txHashes": [
        "string"
      ]
    }
  ],
  "totalCount": 0
}