Generate an intent for signing

POST/v0/generate-intent

Only for quotes with depositType: INTENTS (the deposit address is an intents account). The intent.payload is the exact string to sign; sign it with your wallet and send the result to /v0/submit-intent. The deadline in the payload is about 15 minutes ahead. Real request and response from a live quote.

Generates an unsigned intent payload that needs to be signed by the user. This endpoint takes a quote or limit-order deposit address, validates the target state and caller ownership when required, and returns an intent payload formatted according to the specified signing standard (e.g., NEP413, ERC191). The generated intent must be signed by the user's wallet and then submitted via the /submit-intent endpoint to complete the action (e.g. swap). Request Type Variants: - swap_transfer: Generate an intent for a swap operation (requires depositAddress, signerId, standard) Tidepool: only quotes with depositType INTENTS can be funded this way. Supports nep413, raw_ed25519, erc191, tip191 and sep53. webauthn and ton_connect are accepted by submit-intent but cannot be generated.

Operation id: generateIntent · Auth: optional (X-API-Key or Authorization: Bearer, any value)

Request

curl -X POST "https://www.usetidepool.tech/v0/generate-intent" \
  -H 'content-type: application/json' \
  -d '{
  "type": "swap_transfer",
  "standard": "raw_ed25519",
  "signerId": "9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb",
  "depositAddress": "54e8db801fab4ec416719b8b3044c21bacb4652c698ad4c5846086e5cf27b3a4"
}'

Body

Responses

200 Successfully generated intent payload

{
  "intent": {
    "standard": "raw_ed25519",
    "payload": "{\"signer_id\":\"9cf39ad040a13205c3ab109a8566fd779394a548f76b1aed5107efcdfe6c7ceb\",\"verifying_contract\":\"verifier.tidepool-sandbox.testnet\",\"deadline\":\"2026-10-30T16:46:46.836Z\",\"nonce\":\"zzaNW9Xepvi5ae6mv24WI+LwgljdXAm7/aV4EbWp738=\",\"intents\":[{\"intent\":\"transfer\",\"receiver_id\":\"54e8db801fab4ec416719b8b3044c21bacb4652c698ad4c5846086e5cf27b3a4\",\"tokens\":{\"nep141:usdc.tidepool-sandbox.testnet\":\"5000000\"}}]}"
  },
  "correlationId": "24361e73-4a77-4689-bbcd-031670808504"
}

Same call with standard nep413

Request: {"type":"swap_transfer","standard":"nep413","signerId":"user.testnet","depositAddress":"717a62ee78cf34325228b1767e0409b6f5671dc3e9c451a63e99e75d32f1c3e8"}. The payload is then an object (message, nonce, recipient) instead of a string. Real response:

{
  "intent": {
    "standard": "nep413",
    "payload": {
      "message": "{\"signer_id\":\"user.testnet\",\"verifying_contract\":\"verifier.tidepool-sandbox.testnet\",\"deadline\":\"2026-10-30T16:43:16.117Z\",\"nonce\":\"Nw2ySXC3vL00l2fcii6cV/3pjsbGtq1N1SS9ldF3m9E=\",\"intents\":[{\"intent\":\"transfer\",\"receiver_id\":\"717a62ee78cf34325228b1767e0409b6f5671dc3e9c451a63e99e75d32f1c3e8\",\"tokens\":{\"nep141:usdc.tidepool-sandbox.testnet\":\"5000000\"}}]}",
      "nonce": "Nw2ySXC3vL00l2fcii6cV/3pjsbGtq1N1SS9ldF3m9E=",
      "recipient": "verifier.tidepool-sandbox.testnet"
    }
  },
  "correlationId": "dcdfd266-8f91-427e-9a8f-f1c0fc24bcad"
}

400 Bad Request - Invalid input or quote state

{
  "message": "type must be swap_transfer"
}

401 Unauthorized - API key or JWT token is invalid

Tidepool does not return this: /v0/generate-intent takes no authentication.