receipts.get

A signed receipt by id.

Details

Endpoint: GET /v1/receipts/:id
Credits: 1
Rate class: Light. Counts against your light requests per second.

Returns a receipt made by tx.receipt or tx.build, with its signature. Receipts never change, so they cache forever.

Parameters

Name	Type	Description
idrequired	string	Receipt id, 32 hex characters.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

curl "https://api.tide.ad/v1/receipts/8e56072be767fadb73a18169d8dcfc3c" \
  -H "x-api-key: YOUR_API_KEY"

TypeScript

const res = await fetch("https://api.tide.ad/v1/receipts/8e56072be767fadb73a18169d8dcfc3c", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "id": "8e56072be767fadb73a18169d8dcfc3c",
  "url": "https://tide.ad/proof/8e56072be767fadb73a18169d8dcfc3c",
  "receipt": {
    "v": 1,
    "kind": "tide.tx-receipt",
    "network": "mainnet",
    "issued_at": "2026-11-04T21:30:30.485Z",
    "intent": {
      "action": "swap",
      "pass": "0x03c7bd6a3d4910f56fea05dedb632efd9824c82f22ef274180b7b8756ce47bac",
      "coin_in": "USDC",
      "coin_out": "SUI",
      "amount": "0.2",
      "max_spend": {
        "USDC": "0.2"
      },
      "min_receive": {
        "SUI": "0.2"
      }
    },
    "tx": {
      "digest": "CRDtuCsNNkMdAZmrfRhPNuNjztCwmpWhcrn3EwBqJGn3",
      "bytes_base64": "AAAIAQEDx71qPUkQ9W/qBd7bYy79mCTILyLvJ0GAt7h1bOR7rCdEUDwAAAAAAQEB0wA4LmCLB/lnlucHq5IlNZf8TBmRcsw1YnqtbC0kPywEAAAAAAAAAAABAXbK8L1HRthibkCkVJBPCjzi9lMC/ac831EoacmR4WAxJ0RQPAAAAAABAgBADQMAAAAAAAAH26NGcuMMsGWx+T46tVMYdo/W/vZsFZQsn3y4RuL5AOcEdXNkYwRVU0RDAAIet8V+PyvQ/Gy53P/RQ+qVfk2Y+AXDWHM/dt7gZn/gsXbK8L1HRthibkCkVJBPCjzi9lMC/ac831EoacmR4WAxAQEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABgEAAAAAAAAAAAEB2qRikmMsPE2PMfI+oPmzaij/NnfpaEmA5EOEA6Z6PY8uBRgAAAAAAAABAbjX2eZqYMI556YBEO/PjebHBVgO2STQ3eFB9KDiyQEF6ghFFgAAAAABAAiCUM4MAAAAAAMAIe/y/MyDpsXseJoKRKc7e3iE61DEGKu0F5asFKH+RoMEcGFzcwpiZWdpbl9zd2FwAgfbo0Zy4wywZbH5Pjq1Uxh2j9b+9mwVlCyffLhG4vkA5wR1c2RjBFVTREMABwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACA3N1aQNTVUkABQEAAAEBAAECAAEDAAEEAAAh7/L8zIOmxex4mgpEpzt7eITrUMQYq7QXlqwUof5GgwRwYXNzDGNldHVzX2FfdG9fYgQH26NGcuMMsGWx+T46tVMYdo/W/vZsFZQsn3y4RuL5AOcEdXNkYwRVU0RDAAcAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgNzdWkDU1VJAAfbo0Zy4wywZbH5Pjq1Uxh2j9b+9mwVlCyffLhG4vkA5wR1c2RjBFVTREMABwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACA3N1aQNTVUkABQEAAAIAAAEFAAEGAAEEAAAh7/L8zIOmxex4mgpEpzt7eITrUMQYq7QXlqwUof5GgwRwYXNzC2ZpbmlzaF9zd2FwAgfbo0Zy4wywZbH5Pjq1Uxh2j9b+9mwVlCyffLhG4vkA5wR1c2RjBFVTREMABwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACA3N1aQNTVUkAAwEAAAIBAAEHALVp9TcTgOM5A4wM3OJyliHTa/yJ50DCjjl2vwQ1ftq2ALVp9TcTgOM5A4wM3OJyliHTa/yJ50DCjjl2vwQ1ftq2ZAAAAAAAAADLFAMAAAAAAAIBFQUAAAAAAAABFgUAAAAAAAAAACA1g0qKwXykj7FKyPmcF8mHR+ld0HKUrkGkazgiRqRJmwE3FNc=",
      "sender": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
      "gas_owner": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
      "gas_budget": "201931",
      "gas_price": "100",
      "expiration": "{\"ValidDuring\":{\"minEpoch\":\"1301\",\"maxEpoch\":\"1302\",\"minTimestamp\":null,\"maxTimestamp\":null,\"chain\":\"4btiuiMPvEENsttpZC7CZ53DruC3MAgfznDbASZ7DR6S\",\"nonce\":3608426241},\"$kind\":\"ValidDuring\"}",
      "commands": [
        "0x21eff2fccc83a6c5ec789a0a44a73b7b7884eb50c418abb41796ac14a1fe4683::pass::begin_swap",
        "0x21eff2fccc83a6c5ec789a0a44a73b7b7884eb50c418abb41796ac14a1fe4683::pass::cetus_a_to_b",
        "0x21eff2fccc83a6c5ec789a0a44a73b7b7884eb50c418abb41796ac14a1fe4683::pass::finish_swap"
      ]
    },
    "simulation": {
      "checkpoint": 341691197,
      "effects": {
        "status": "success",
        "error": null,
        "balance_changes": [
          {
            "owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
            "coin_type": "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI",
            "amount": "217059922"
          }
        ],
        "objects": {
          "created": [],
          "mutated": [
            {
              "id": "0x03c7bd6a3d4910f56fea05dedb632efd9824c82f22ef274180b7b8756ce47bac",
              "type": "0x389b58171d057852dd4b071d47474a2a97a6e4489cc2094a527a57d57d58063f::pass::AgentPass",
              "owner": {
                "kind": "shared"
              }
            }
          ],
          "transferred": [],
          "deleted": []
        },
        "events": [
          {
            "type": "0x1eabed72c53feb3805120a081dc15963c204dc8d091542592abaf7a35689b2fb::pool::SwapEvent",
            "sender": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
            "json": {
              "after_sqrt_price": "608468485378882613812",
              "amount_in": "200000",
              "amount_out": "217059922",
              "atob": true,
              "before_sqrt_price": "608468498068679819264",
              "fee_amount": "500",
              "partner": "0x0000000000000000000000000000000000000000000000000000000000000000",
              "pool": "0xb8d7d9e66a60c239e7a60110efcf8de6c705580ed924d0dde141f4a0e2c90105",
              "ref_amount": "0",
              "steps": "1",
              "vault_a_amount": "830540776238",
              "vault_b_amount": "1924923449748035"
            }
          }
        ],
        "gas": {
          "computation": "100000",
          "storage": "19311600",
          "rebate": "19309669",
          "non_refundable": "1931",
          "net": "101931"
        }
      },
      "coins": {
        "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI": {
          "symbol": "SUI",
          "decimals": 9
        },
        "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC": {
          "symbol": "USDC",
          "decimals": 6
        }
      }
    },
    "agent_pass": {
      "pass": "0x03c7bd6a3d4910f56fea05dedb632efd9824c82f22ef274180b7b8756ce47bac",
      "name": "Buy SUI daily",
      "owner": "0x1eb7c57e3f2bd0fc6cb9dcffd143ea957e4d98f805c358733f76dee0667fe0b1",
      "agent": "0xb569f5371380e339038c0cdce2729621d36bfc89e740c28e3976bf04357edab6",
      "status": "active",
      "checks": [
        {
          "rule": "pass",
          "ok": true,
          "text": "Active. The agent can act until 2026-11-06."
        },
        {
          "rule": "signer",
          "ok": true,
          "text": "Signed by the pass's agent key."
        },
        {
          "rule": "config",
          "ok": true,
          "text": "Agent Pass is not paused."
        }
      ]
    },
    "guards": [
      "It cannot return less than 0.215 SUI to the owner (the agent's own minimum).",
      "Sui runs this only if it is signed by the pass's agent 0xb569…dab6 and the pass is active.",
      "It cannot swap more than 0.5 USDC in one trade or 0.5 USDC more today (daily cap 0.5 USDC)."
    ],
    "checks": [
      {
        "name": "simulation",
        "ok": true,
        "text": "The dry run succeeds at checkpoint 341691197."
      },
      {
        "name": "max_spend:USDC",
        "ok": true,
        "text": "Spends 0.2 USDC of 0.2 USDC allowed."
      },
      {
        "name": "min_receive:SUI",
        "ok": true,
        "text": "Receives 0.217 SUI; at least 0.2 SUI wanted."
      }
    ],
    "presign": {
      "verdict": "safe",
      "headline": "No red flags found in the 1 address, 1 package this transaction touches.",
      "findings": [
        {
          "code": "SENT_BEFORE",
          "severity": "info",
          "text": "You have sent to adeniyi.sui 2 times before."
        }
      ]
    },
    "summary": "Agent under pass 0x03c7…7bac (Buy SUI daily) swapped 0.2 USDC for 0.217 SUI on Cetus. Wallet 0x1eb7…e0b1: +0.217 SUI, -0.2 USDC.",
    "verdict": "pass",
    "verdict_reason": "Every check passed."
  },
  "signature": {
    "key_id": "tide-attest-5cf187d1a3e427da",
    "algorithm": "ed25519",
    "signature_base64": "YHZ3976sC+Xb5x1rm5cnsFlUNZpYhrfIhASQO7q4H9h05grzrmcOHYZ9VudikXLxbhJaiVIXRE+6Ic4GYhSPAw==",
    "public_key_base64": "34allTzR6sPc9lRYRGHespn+vaLYZPPFMQr8ZDHtAEA="
  },
  "verify": "https://api.tide.ad/.well-known/tide-attest.json"
}

Long lists are cut to a few items here.