HIFI Developer Docs

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": {
    "chain": "POLYGON",
    "currency": "usdc",
    "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
    "externalWalletId": "64fc4e9d-4839-4384-b4a0-0376af2c9b2e",
    "walletAddress": "0xE9cfBf1D690565579D823264170eE357f80e9A34",
    "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"
        }
      ]
    }
  }
}

POST

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": {
    "chain": "POLYGON",
    "currency": "usdc",
    "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
    "externalWalletId": "64fc4e9d-4839-4384-b4a0-0376af2c9b2e",
    "walletAddress": "0xE9cfBf1D690565579D823264170eE357f80e9A34",
    "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

Show child attributes

source.userId

string<uuid>

required

User ID of the source wallet owner

Example:

"05179f69-1988-4b46-a847-dd4eea0984d6"

source.chain

enum<string>

required

Blockchain network for the source wallet

Available options:

POLYGON,

ETHEREUM,

SOLANA

Example:

"POLYGON"

source.currency

enum<string>

required

Source cryptocurrency to swap from

Available options:

usdc,

usdt

Example:

"usdt"

source.amount

string

Amount to swap (either source.amount or destination.amount must be provided)

Example:

"10000"

destination

object

required

Destination wallet information for the swap

Show child attributes

destination.chain

enum<string>

required

Blockchain network for the destination wallet

Available options:

POLYGON,

ETHEREUM,

SOLANA

Example:

"POLYGON"

destination.currency

enum<string>

required

Destination cryptocurrency to swap to

Available options:

usdc,

usdt,

usdg

Example:

"usdc"

destination.userId

string<uuid>

User ID of the destination wallet owner

Example:

"05179f69-1988-4b46-a847-dd4eea0984d6"

destination.externalWalletId

string<uuid>

External wallet ID (Exclude with userId)

Example:

"64fc4e9d-4839-4384-b4a0-0376af2c9b2e"

destination.walletAddress

string

Wallet address (Exclude with userId)

Example:

"0xE9cfBf1D690565579D823264170eE357f80e9A34"

destination.amount

string

Amount to receive (either source.amount or destination.amount must be provided)

Example:

"10000"

Response

Success

transferType

string

Example:

"WALLET.SWAP"

transferDetails

object

Show child attributes

transferDetails.id

string<uuid>

Example:

"dc923cc1-d74b-58f6-9fe4-9e9c6eb8dc37"

transferDetails.requestId

string<uuid>

Example:

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

transferDetails.status

enum<string>

Available options:

PENDING,

COMPLETED,

FAILED,

CANCELLED

Example:

"COMPLETED"

transferDetails.createdAt

string<date-time>

Example:

"2025-08-20T03:55:29.437108+00:00"

transferDetails.updatedAt

string<date-time>

Example:

"2025-08-20T04:08:10.837+00:00"

transferDetails.source

object

Show child attributes

transferDetails.source.currency

string

Example:

"usdc"

transferDetails.source.amount

number

Example:

10

transferDetails.source.chain

string

Example:

"POLYGON"

transferDetails.source.userId

string<uuid>

Example:

"05179f69-1988-4b46-a847-dd4eea0984d6"

transferDetails.destination

object

Show child attributes

transferDetails.destination.currency

string

Example:

"usdt"

transferDetails.destination.userId

string<uuid>

Example:

"05179f69-1988-4b46-a847-dd4eea0984d6"

transferDetails.destination.externalWalletId

string<uuid> | null

Example:

null

transferDetails.destination.amount

number | null

Example:

null

transferDetails.destination.chain

string

Example:

"POLYGON"

transferDetails.destination.walletAddress

string

Example:

"0xe5727a4B1d93A26D6A7Adfaae145EFa41ED7f204"

transferDetails.error

string | null

Example:

null

transferDetails.errorDetails

string | null

Example:

null

transferDetails.quoteInformation

object

Show child attributes

transferDetails.quoteInformation.sendGross

object

Show child attributes

transferDetails.quoteInformation.sendGross.amount

string

Example:

"10"

transferDetails.quoteInformation.sendGross.currency

string

Example:

"usdc"

transferDetails.quoteInformation.sendNet

object

Show child attributes

transferDetails.quoteInformation.sendNet.amount

string

Example:

"10"

transferDetails.quoteInformation.sendNet.currency

string

Example:

"usdc"

transferDetails.quoteInformation.receiveGross

object

Show child attributes

transferDetails.quoteInformation.receiveGross.amount

string

Example:

"10"

transferDetails.quoteInformation.receiveGross.currency

string

Example:

"usdc"

transferDetails.quoteInformation.receiveNet

object

Show child attributes

transferDetails.quoteInformation.receiveNet.amount

string

Example:

"10"

transferDetails.quoteInformation.receiveNet.currency

string

Example:

"usdc"

transferDetails.quoteInformation.rate

string

Example:

"1"

transferDetails.quoteInformation.expiresAt

string<date-time>

Example:

"2025-08-20T03:55:59.539+00:00"

transferDetails.billingInformation

object

Show child attributes

transferDetails.billingInformation.fees

object[]

Show child attributes

transferDetails.billingInformation.fees.id

string<uuid>

Example:

"2ca381ec-9498-52f5-9a27-d0e392b2626b"

transferDetails.billingInformation.fees.amount

number

Example:

0.01

transferDetails.billingInformation.fees.currency

string

Example:

"USD"

transferDetails.billingInformation.fees.type

enum<string>

Available options:

EXCHANGE_FEE,

GAS_FEE

Example:

"EXCHANGE_FEE"

transferDetails.billingInformation.fees.timing

enum<string>

Available options:

ON_INVOICE,

ON_TRANSACTION

Example:

"ON_INVOICE"

Retrieve a swap

Accept a swap

⌘I

Overview

Endpoints

Create a swap

Authorizations

Body

Response