Skip to main content

Meta Track

Track a meta transaction status using the queue_id returned by Meta Broadcast, or by tx_hash.

Request URL

https://testnet.api.euclidprotocol.com/api/v1/txn/track/meta-txn

Example

curl --request POST \
  --url https://api.euclidprotocol.com/api/v1/txn/track/meta-txn \
  --header 'content-type: application/json' \
  --data '{
    "queue_id": "1772700210201242"
}'
{
  "response": {
    "type": "meta_txn",
    "tx_status": "queued",
    "is_completed": false,
    "source_chain_uid": "vsl",
    "meta_source_chain_uid": "monad",
    "destination_chain_uid": ["monad"],
    "meta_txn_sub_type": ["swap"],
    "meta_call_txn_response": [
      {
        "type": "swap",
        "token_in": "mon",
        "token_out": "usdt",
        "token": "",
        "amount_in": "40000000000000000",
        "amount_out": ""
      }
    ],
    "status": [
      {
        "chain_uid": "vsl",
        "status": "queued",
        "msg": "queued",
        "tx_hash": ""
      }
    ]
  }
}

Parameters

FieldTypeDescription
queue_idstringQueue ID returned by Meta Broadcast. Recommended tracking key.
tx_hashstringOptional fallback if queue ID is not available.
chainstringChain UID field accepted by API. For meta tracking, backend tracks on VSL.

Response Fields

FieldTypeDescription
response.typestringTracker response type (meta_txn).
response.tx_statusstringCurrent status (pending, queued, success, failed).
response.is_completedbooleanWhether the meta transaction reached a terminal state.
response.meta_txn_sub_typestring[]Meta call types included (for example swap, transfer_voucher, withdraw_voucher).
response.meta_call_txn_responseobject[]Metadata summary originally passed in meta transaction payload.
response.statusobject[]Per-stage status details.
note

Use queue_id as the primary tracker key. It is created in broadcast and persisted by the API for status updates.