Transfers

List transfers with pending USDT trades

Changed on

Returns transfers that have a stuck USDT-to-USD trade awaiting execution. Results are sorted by creation time (newest first) and paginated.

Use POST /transfers/{transferID}/execute to force-execute a pending trade at the current market rate.

get/transfers/pending

Request

  • Base URL
    https://api.bridge.xyz/v0
  • URL
    https://api.bridge.xyz/v0/transfers/pending
  • Auth
    API key in header Api-Key

Query parameters

limitinteger

The number of items to return (min 1, default 10, max 100)

starting_afterstring

This is a transfer id. If this is specified, the next page that starts with a transfer right AFTER the specified transfer id on the transfer timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that transfers older than the specified transfer id will be returned (shouldn't be set if ending_before is set)

ending_beforestring

This is a transfer id. If this is specified, the previous page that ends with a transfer right BEFORE the specified transfer id on the transfer timeline, which is always ordered from the newest to the oldest by creation time, will be returned. This also implies that transfers newer than the specified transfer id will be returned (shouldn't be set if starting_after is set)

Response

List of transfers with pending trades (the returned list is empty if none found)

countinteger required

The number of transfers returned

Example response

{
  "data": [
    {
      "source_deposit_instructions": {
        "payment_rail": "wire",
        "amount": "75.0",
        "currency": "usd",
        "deposit_message": "BVI7depositmessage",
        "bank_name": "Bank name",
        "bank_address": "Bank address",
        "bank_routing_number": "123456789",
        "bank_account_number": "1234567890",
        "bank_beneficiary_name": "Bank beneficiary",
        "bank_beneficiary_address": "Bank beneficiary address"
      },
      "return_details": {
        "risk_rejection_reason": "Exceeds Transaction Limits"
      }
    }
  ]
}

Changes

    • breaking

      the response property // became optional for the status

    • breaking

      added to the // response property oneOf list for the response status

    • warning

      removed the optional property /////// from the response with the status

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

      added the new xdc 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

    • 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

    • 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

    • 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

    • info

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

    • info

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

    • info

      the response optional property /// became read-only for the status

    • info

      removed subschema #2 from the // response property allOf list for the response status

    • info

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

    • info

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

    • info

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

    • info

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