HIhifi
Token Swap

List all swaps

Changed on

Returns a list of swaps associated with a user under your organization. The swaps are returned sorted by creation date, with the most recent swaps appearing first.

get/v2/wallets/swaps

Request

  • Base URL
    https://production.hifibridge.com
  • URL
    https://production.hifibridge.com/v2/wallets/swaps
  • Auth
    HTTP bearer

Query parameters

userIdstring

The user ID.

limitstring

default to 10, maximum to 100

createdBeforestring date

ISO format: YYYY-MM-DD

createdAfterstring date

ISO format: YYYY-MM-DD

Response

Success

countinteger
nextCursorstring date-time

Example response

{
  "count": 1,
  "data": [
    {
      "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,
          "userId": "05179f69-1988-4b46-a847-dd4eea0984d6"
        },
        "destination": {
          "currency": "usdt",
          "userId": "05179f69-1988-4b46-a847-dd4eea0984d6",
          "chain": "POLYGON",
          "walletAddress": "0xe5727a4B1d93A26D6A7Adfaae145EFa41ED7f204"
        },
        "cancellable": true,
        "autoCancelAt": "2026-07-13T02:00:00.000Z",
        "quoteInformation": {
          "sendGross": {
            "amount": "10",
            "currency": "usdc"
          },
          "sendNet": {
            "amount": "10",
            "currency": "usdc"
          },
          "receiveGross": {
            "amount": "10",
            "currency": "usdc"
          },
          "receiveNet": {
            "amount": "10",
            "currency": "usdc"
          },
          "rate": "1",
          "limitPrice": "0.9990",
          "expiresAt": "2025-08-20T03:55:59.539+00:00"
        }
      }
    }
  ],
  "nextCursor": "2025-08-20T04:08:10.837+00:00"
}

Changes

  • 319fa6bd5bc6Revision changes
    • warning

      added the new CANCELLED enum value to the /// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status