Create a swap intent

Creates a new intent with the swap data. A resolver makes an intent offchain and executes it onchain later.

HTTP request

POST /v1/intents/

Request

Header parameters

Requires authentication.

Body parameters

Name	Type	Required	Description
quote_id	String	Required	You must resecive quote before swap intent creation.
from	Object	Required	Base token information for swap intent creation.
from.address	String	Required	Part of the from object. Sender address.
from.refund_address	String	Required	Part of the from object. Address for potential refund.
from.public_key	String	Optional	Part of the from object. Required only if source chain is Bitcoin or Solana.
to	Object	Required	Quote token information for swap intent creation.
to.address	String	Required	Part of the to object. Receiver address.

Sample request

application/json

{
  "quote_id": "e63243b6-c489-42c6-a8a2-739c23bc36a1",
  "from": {
    "address": "0xbe7A42Af09C2.....C064f5Bd98a88c8EE",
    "refund_address": "0xbe7A42Af09C25.....064f5Bd98a88c8EE"
  },
  "to": {
    "address": "B69793d1.....ChkQEr5DZo"
  }
}

Response

Successful response

Name	Type	Required	Description
id	String	Required	Swap intent UUID.
expires_at	Timestamp (milliseconds)	Optional	Swap intent expiration time.
secret_hash	String	Optional	Value based on public_key in request.
approval_type	String	Required	Approval mechanism, depends on network. Possible values: permit2, cosign or htlc.
approve_to	String / Nullable	Required	Approval address.
params_to_sign	Object	Required	Object with data to sign by user's wallet.
quote	Object	Required	Applied quote for the current swap intent.

Sample response (EVM and Tron)

application/json

{
  "id": "bf53a856-46aa-4865-8d66-a649a9d5b169",
  "expires_at": 1780078455,
  "secret_hash": "0x3f2bb70a115e0a.....187d9351c565682b8",
  "approve_to": null,
  "approval_type": "permit2",
  "params_to_sign": {
    "nonce": 81,
    "additional_data": {
      "types": {
          "DepositWitness": [
            {
                "name": "resolverDepositAddress",
                "type": "address"
            },
            {
                "name": "secretHash",
                "type": "bytes32"
            },
            {
                "name": "deadline",
                "type": "uint256"
            }
          ],
          "TokenPermissions": [
            {
                "name": "token",
                "type": "address"
            },
            {
                "name": "amount",
                "type": "uint256"
            }
          ],
          "PermitWitnessTransferFrom": [
            {
                "name": "permitted",
                "type": "TokenPermissions"
            },
            {
                "name": "spender",
                "type": "address"
            },
            {
                "name": "nonce",
                "type": "uint256"
            },
            {
                "name": "deadline",
                "type": "uint256"
            },
            {
                "name": "witness",
                "type": "DepositWitness"
            }
          ]
        },
        "domain": {
            "name": "Permit2",
            "chainId": 1,
            "version": "1",
            "verifyingContract": "0x000000000022D.....DEE9F6B43aC78BA3"
        },
        "witness": {
            "deadline": "0x6a19d777",
            "secretHash": "0x3f2bb70a115e0a.....187d9351c565682b8",
            "resolverDepositAddress": "0x745f221ca.....a6649a0c5fc5"
        },
        "witness_hash": "0xa6b608c2503bb6e6d9.....2a054786dbaf41beed9",
        "witness_type_string": "DepositWitness witness)DepositWitness(address resolverDepositAddress,bytes32 secretHash,uint256 deadline)TokenPermissions(address token,uint256 amount)"
    },
    "escrow_contract_address": "0x8DcbE1aCf3.....e318F8e8836",
    "permit2_contract_address": "0x0000000000.....6B43aC78BA3",
    "resolver_deposit_address": "0x745F221caec.....A6649a0c5Fc5"
  },
  "quote": {
    "id": "f5a68149-e20c-4774-9494-16d3cee0f84d",
    "from": {
      "network_id": 3,
      "token_id": 278,
      "contract_address": "0xdac17f958d2.....97c13d831ec7",
      "amount": "1000000",
      "decimals": 6
  },
    "to": {
      "network_id": 177,
      "token_id": 678,
      "contract_address": null,
      "amount": "7277684",
      "decimals": 9,
      "min_amount": "7241295"
    },
    "slippage_bps": "50",
    "expires_at": 1780071289460000,
    "fees": {
      "changelly": {
        "network_id": 3,
        "contract_address": "0xc02aaa39b2.....d9083c756cc2",
        "token_id": 4669,
        "decimals": 18,
        "amount": "4909698369185",
        "bps": "100"
      },
      "affiliate": {
        "network_id": 3,
        "contract_address": "0xc02aaa39b2.....d9083c756cc2",
        "token_id": 4669,
        "decimals": 18,
        "amount": "2454849184592",
        "bps": "50"
      }
    }
  }
}

Error response

Check the error response schema.

Error codes

Error code	Error type	Error description
400	bad_request_error	Invalid body parameters.
400	unprocessable_entity_error	Slippage value cannot be processed.
401	authentication_error	Authentication error.
404	http_error	Incorrect HTTP request.
422	unprocessable_entity_error	Configuration error.
422	unprocessable_entity_error	Intent already exists for quote.
422	unprocessable_entity_error	Invalid address.
422	unprocessable_entity_error	Invalid amount.
422	unprocessable_entity_error	Invalid swap status.
422	unprocessable_entity_error	Network or token couldn’t be processed.
422	unprocessable_entity_error	Only wrapped tokens can be used as source.
422	unprocessable_entity_error	Swap type cannot be processed.
422	unprocessable_entity_error	Swap type could not be processed.
422	unprocessable_entity_error	Quote expired.
422	unprocessable_entity_error	Quotes not available.
422	unprocessable_entity_error	Requested pair could not be processed.
422	unprocessable_entity_error	Swap amount is too large.
422	unprocessable_entity_error	Swap amount is too small.
500	internal_error	Internal configuration error.
500	internal_error	Internal processing error.

400

Sample error response with the unprocessable_entity_error type

{
  "code": 400,
  "type": "creation_error",
  "message": "Slippage value cannot be processed"
}

Sample error response with the bad_request_error type

{
  "code": 400,
  "type": "bad_request_error",
  "message": "body.from.QuoteDirectionByTokenId.token_id must be an integer"
}

401

{
  "code": 401,
  "type": "authentication_error",
  "message": "Authentication error"
}

404

{
  "code": 404,
  "type": "http_error",
  "message": "HTTP error"
}

422

{
  "code": 422,
  "type": "unprocessable_entity_error",
  "message": "Configuration error"
}

500

{
  "code": 500,
  "type": "internal_error",
  "message": "Internal configuration error"
}

---