Verify

Verify Tracking

Check whether a transaction contains valid Turtle tracking data. Useful for debugging or confirming attribution independently.

curl -X GET "https://earn.turtle.xyz/v1/actions/verify?chainId=1&txHash=0xedfdf71e..."

Query Parameters

chainId

integer

required

The chain ID where the transaction was executed (e.g., 1 for Ethereum, 42161 for Arbitrum).

txHash

string

required

The transaction hash to verify (0x followed by 64 hex characters).

Response

{
  "tag": "turtle:v1:dist123:ref456",
  "metadata": {
    "distributorId": "dist123",
    "referralCode": "ref456"
  },
  "signatureValid": true
}

tag

string

The raw tracking tag found in the transaction data.

metadata

object

Parsed tracking metadata containing distributorId and optionally referralCode.

signatureValid

boolean

required

Whether the tracking signature is from Turtle’s attribution wallet.

error

string

Error message if verification failed (e.g., no tracking data found).