Skip to main content
POST
/
v2
/
wallets
/
swaps
Create a swap
curl --request POST \
  --url https://production.hifibridge.com/v2/wallets/swaps \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "requestId": "1ab3e6e0-4839-4dbe-89c3-b06d9645ae86",
  "source": {
    "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
    "chain": "POLYGON",
    "currency": "usdt",
    "amount": "10000"
  },
  "destination": {
    "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
    "externalWalletId": "64fc4e9d-4839-4384-b4a0-0376af2c9b2e",
    "walletAddress": "0xE9cfBf1D690565579D823264170eE357f80e9A34",
    "chain": "POLYGON",
    "currency": "usdc",
    "amount": "10000"
  }
}'
{
  "transferType": "WALLET.SWAP",
  "transferDetails": {
    "id": "dc923cc1-d74b-58f6-9fe4-9e9c6eb8dc37",
    "requestId": "1ab3e6e0-4839-4dbe-89c3-b06d9645ae86",
    "status": "COMPLETED",
    "createdAt": "2025-08-20T03:55:29.437108+00:00",
    "updatedAt": "2025-08-20T04:08:10.837+00:00",
    "source": {
      "currency": "usdc",
      "amount": 10,
      "chain": "POLYGON",
      "userId": "05179f69-1988-4b46-a847-dd4eea0984d6"
    },
    "destination": {
      "currency": "usdt",
      "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
      "externalWalletId": null,
      "amount": null,
      "chain": "POLYGON",
      "walletAddress": "0xe5727a4B1d93A26D6A7Adfaae145EFa41ED7f204"
    },
    "error": null,
    "errorDetails": null,
    "quoteInformation": {
      "sendGross": {
        "amount": "10",
        "currency": "usdc"
      },
      "sendNet": {
        "amount": "10",
        "currency": "usdc"
      },
      "receiveGross": {
        "amount": "10",
        "currency": "usdc"
      },
      "receiveNet": {
        "amount": "10",
        "currency": "usdc"
      },
      "rate": "1",
      "expiresAt": "2025-08-20T03:55:59.539+00:00"
    },
    "billingInformation": {
      "fees": [
        {
          "id": "2ca381ec-9498-52f5-9a27-d0e392b2626b",
          "amount": 0.01,
          "currency": "USD",
          "type": "EXCHANGE_FEE",
          "timing": "ON_INVOICE"
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
requestId
string<uuid>
required

Unique identifier for the swap request (recommend using uuid v4)

Example:

"1ab3e6e0-4839-4dbe-89c3-b06d9645ae86"

source
object
required

Source wallet information for the swap

destination
object
required

Destination wallet information for the swap

Response

Success

transferType
string
Example:

"WALLET.SWAP"

transferDetails
object
I