BRbridge
Liquidation Addresses

Create a Liquidation Address

Changed on
post/customers/{customerID}/liquidation_addresses

Request

  • Base URL
    https://api.bridge.xyz/v0
  • URL
    https://api.bridge.xyz/v0/customers/{customerID}/liquidation_addresses
  • Auth
    API key in header Api-Key

Path parameters

customerIDstring required

A UUID that uniquely identifies a resource

Headers

Idempotency-Keystring required

Request body

currency'usdb' | 'usdc' | 'usdt' | 'usdl_linea' | 'pyusd' | 'eurc' | 'all_supported' required
chain'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'linea' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron' | 'xdc' | 'evm' required
external_account_idstring

A UUID that uniquely identifies a resource

prefunded_account_idstring

A UUID that uniquely identifies a resource

bridge_wallet_idstring

A UUID that uniquely identifies a resource

destination_wire_messagestring

A message to be sent with a wire transfer. It can have up to 140 characters. This message will be validated against 4 lines, each with a max length of 35 characters according to the Fedwire standard.

destination_sepa_referencestring

A reference message to be sent with a SEPA transaction. We recommend you set a unique value to help you and your customers track payments end to end. It must be from 6 to 140 characters. The allowed characters are a-z, A-Z, 0-9, spaces, ampersand (&), hyphen (-), full stop (.), and solidus (/). If not populated, the default value is "Payment via Bridge {unique_token}".

destination_ach_referencestring

A reference message to be sent with an ACH transaction. It can be at most 10 characters, A-Z, a-z, 0-9, and spaces.

destination_spei_referencestring

A payment reference message or remittance information to be included in a SPEI transaction. The allowed characters are alphanumeric a-z, A-Z, 0-9, and space

destination_swift_referencestring

A payment reference message or remittance information to be included in a SWIFT transaction. It can have at most 4 lines (separated by "\n"), each line with a max length of 35 chars. The allowed characters are a-z, A-Z, 0-9, special characters (/ - ? : ( ) . , ' +), and space

destination_referencestring

A payment reference message for newer payment rails (e.g. Pix, Faster Payments, and FedNow).

destination_payment_rail'ach' | 'wire' | 'ach_push' | 'ach_same_day' | 'arbitrum' | 'avalanche_c_chain' | 'base' | 'bre_b' | 'co_bank_transfer' | 'celo' | 'ethereum' | 'faster_payments' | 'fiat_deposit_return' | 'linea' | 'optimism' | 'pix' | 'polygon' | 'sepa' | 'solana' | 'spei' | 'stellar' | 'swift' | 'tempo' | 'tron' | 'xdc'
destination_currency'brl' | 'cop' | 'eur' | 'eurc' | 'gbp' | 'mxn' | 'ousd' | 'path_usd' | 'pyusd' | 'usd' | 'usdb' | 'usdc' | 'usdt' | 'usdl_linea'
destination_addressstring

The crypto wallet address that Bridge will use to send funds to the customer.

destination_blockchain_memostring

The memo to include in the transaction, for blockchains that support memos only

return_addressstring nullable

Deprecated: use return_instructions instead.

The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. Must be on the same chain as the liquidation address. Cannot be used on Stellar — use return_instructions with a memo instead.

custom_developer_fee_percentstring number nullable

The developer fee percent that will be applied to this Liquidation Address or null to use the default fee. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API.

Example request

{
  "custom_developer_fee_percent": "0.1",
  "travel_rule_data": {
    "originator": {
      "name": "Jane Smith",
      "address": {
        "street_line_1": "123 Market St",
        "street_line_2": null,
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105",
        "country": "USA"
      },
      "identifying_information": {
        "type": "national_id",
        "number": "1234567890",
        "issuing_country": "USA"
      },
      "birth_date": "2000-01-31",
      "place_of_birth": {
        "city": "San Francisco",
        "country": "USA"
      },
      "wallet_type": "self_custodied",
      "wallet_attested_ownership_at": "2026-04-01T12:00:00Z"
    },
    "beneficiary": {
      "is_self": true,
      "wallet_type": "external"
    }
  }
}

Response

Liquidation Address object created

currency'usdb' | 'usdc' | 'usdt' | 'usdl_linea' | 'pyusd' | 'eurc' | 'all_supported' required
chain'arbitrum' | 'avalanche_c_chain' | 'base' | 'celo' | 'ethereum' | 'linea' | 'optimism' | 'polygon' | 'solana' | 'stellar' | 'tempo' | 'tron' | 'xdc' | 'evm' required
external_account_idstring

External bank account to which Bridge will send the funds.

prefunded_account_idstring

The developer's prefunded account to which Bridge will send the funds.

bridge_wallet_idstring

A UUID that uniquely identifies a resource

destination_wire_messagestring

A message to be sent with a wire transfer.

destination_sepa_referencestring

A reference message to be sent with a SEPA transaction.

destination_ach_referencestring

A reference message to be sent with an ACH transaction. It can be at most 10 characters, A-Z, a-z, 0-9, and spaces.

destination_spei_referencestring

A payment reference message or remittance information to be included in a SPEI transaction. The allowed characters are alphanumeric a-z, A-Z, 0-9, and space

destination_swift_referencestring

A payment reference message or remittance information to be included in a SWIFT transaction. It can have at most 4 lines (separated by "\n"), each line with a max length of 35 chars. The allowed characters are a-z, A-Z, 0-9, special characters (/ - ? : ( ) . , ' +), and space

destination_referencestring

A payment reference message for newer payment rails (e.g. Pix, Faster Payments, and FedNow).

destination_payment_rail'ach' | 'wire' | 'ach_push' | 'ach_same_day' | 'arbitrum' | 'avalanche_c_chain' | 'base' | 'bre_b' | 'co_bank_transfer' | 'celo' | 'ethereum' | 'faster_payments' | 'fiat_deposit_return' | 'linea' | 'optimism' | 'pix' | 'polygon' | 'sepa' | 'solana' | 'spei' | 'stellar' | 'swift' | 'tempo' | 'tron' | 'xdc' required

The payment rail that Bridge will use to send funds to the customer.

destination_currency'brl' | 'cop' | 'eur' | 'eurc' | 'gbp' | 'mxn' | 'ousd' | 'path_usd' | 'pyusd' | 'usd' | 'usdb' | 'usdc' | 'usdt' | 'usdl_linea' required

The currency that Bridge will use to send funds to the customer.

destination_addressstring

The crypto wallet address that Bridge will use to send funds to the customer.

destination_blockchain_memostring

The memo to include in the transaction, for blockchains that support memos only

return_addressstring nullable

Deprecated: use return_instructions instead.

The crypto wallet address that Bridge will use to return funds to the customer in case of a failed transaction. Must be on the same chain as the liquidation address. Cannot be used on Stellar — use return_instructions with a memo instead.

custom_developer_fee_percentstring number nullable

The developer fee percent that will be applied to this Liquidation Address or null to use the default fee. The value is a base 100 percentage, i.e. 10.2% is 10.2 in the API.

addressstring

The blockchain address the customer will send funds to.

memoless_addressstring

An alternative crypto wallet address that encodes the memo, allowing the customer to send funds without needing to include a separate memo. Currently only available for Stellar deposits.

statestring

The state of the liquidation address. It could be "active" or "deactivated"

return_memostring nullable

The memo included with return transactions. Present when return_instructions was set with a memo (e.g. required for Stellar to route funds to the correct end-customer).

supported_currenciesobject

The currencies this Liquidation Address accepts on each chain. Keys are LiquidationAddressSourceChain values (e.g. ethereum, polygon, base). For a single-chain, single-currency address this is just that one chain and currency; for a multi-chain (chain is evm) or multi-currency (currency is all_supported) address it lists every currency actually accepted on each chain.

Example response

{
  "custom_developer_fee_percent": "0.1",
  "travel_rule_data": {
    "originator": {
      "name": "Jane Smith",
      "address": {
        "street_line_1": "123 Market St",
        "street_line_2": null,
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94105",
        "country": "USA"
      },
      "identifying_information": {
        "type": "national_id",
        "number": "1234567890",
        "issuing_country": "USA"
      },
      "birth_date": "2000-01-31",
      "place_of_birth": {
        "city": "San Francisco",
        "country": "USA"
      },
      "wallet_type": "self_custodied",
      "wallet_attested_ownership_at": "2026-04-01T12:00:00Z"
    },
    "beneficiary": {
      "is_self": true,
      "wallet_type": "external"
    }
  },
  "supported_currencies": {
    "ethereum": [
      "usdc",
      "eurc"
    ],
    "polygon": [
      "usdc"
    ]
  }
}

Changes

  • a390532e9fc6Revision changes
    • warning

      added the new all_supported 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 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 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 new optional request property

    • info

      added the new all_supported enum value to the request property

    • info

      added the new linea enum value to the request property

    • info

      added the new linea enum value to the request property

    • info

      added the new ousd enum value to the request property

    • info

      added the new path_usd enum value to the request property

    • info

      added the new usdl_linea enum value to the request property

    • info

      added the new usdl_linea enum value to the request property

    • info

      added the new xdc enum value to the request property

    • info

      added the new xdc enum value to the request property

    • info

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

    • info

      added the optional property / to the response with the status