Requiring PSBT for Cold Wallets

BitGo now requires using the Partially Signed Bitcoin (PSBT) transaction format for withdrawals of UTXO assets from cold wallets in production. This requirement applies to custody wallets and self-custody cold wallets. This change already took effect in testnet on September 2, 2025.

Breaking Change

  1. You must update to a newer version of the OVC. You must also update to a newer version of either BitGo Express or the SDK (depending on your integration).

    Ensure you're using the follow versions or higher:

  2. Ensure that when you initiate transactions, the value for the txFormat parameter is psbt or psbt-lite (if you don't pass this parameter, the value defaults to psbt-lite). If txFormat is legacy, BitGo returns an error.

See Also

Know Your Business Integration

BitGo expands functionality for Crypto-as-a-Service (CaaS) by offering a Know Your Business (KYB) API integration. You can onboard your clients' businesses to your platform, completing regulatory compliance screening programmatically. This update also delivers new webhook functionality to for KYB status monitoring.

View the integration guide at Know Your Business (KYB).

PSBT for Cold Wallets

Requiring PSBT for Cold Wallets

BitGo now requires using the Partially Signed Bitcoin (PSBT) transaction format for withdrawals of UTXO assets from cold wallets in testnet. This requirement applies to custody wallets and self-custody cold wallets.

Note: Beginning September 30, 2025 BitGo will require PSBT in production. Avoid service disruptions by updating your integration before this date.

Breaking Change

  1. You must update to a newer version of the OVC. You must also update to a newer version of either BitGo Express or the SDK (depending on your integration).

    Ensure you're using the follow versions or higher:

  2. Ensure that when you initiate transactions, the value for the txFormat parameter is psbt or psbt-lite (if you don't pass this parameter, the value defaults to psbt-lite). If txFormat is legacy, BitGo returns an error.

See Also

Fiat & Bank Accounts

New Bank Accounts Endpoints

BitGo expands fiat and bank account functionality by delivering the following new endpoints:

Deprecation Notice

BitGo deprecates the following:

The endpoint, fields, and object remain fully functional while deprecated, but won't receive future updates.

Content Reorganization

For clarity, BitGo renames the Bank account section of the API reference to Fiat.

Update Your Integration

Update your integration to enable new functionality, including the ability for Crypto-as-a-Service (CaaS) integrations to make ACH transfers.

  1. Instead of the deprecated Get deposit information endpoint, use the new Get deposit info endpoint.

  2. In the /bankaccounts API, BitGo replaces the deprecated fields and object with the following new fields:

    • bankAddressCityLocality
    • bankAddressLine1
    • bankAddressLine2
    • bankAddressPostalCode
    • bankAddressStateProvince
    • ownerAddressCityLocality
    • ownerAddressCountryCode
    • ownerAddressLine1
    • ownerAddressLine2
    • ownerAddressPostalCode
    • ownerAddressStateProvince

See Also

Deposit Assets

Ethereum Hoodi Testnet

In support of the Ethereum Pectra upgrade, BitGo migrates from using the Ethereum Holesky testnet to the Hoodi testnet. The testnet ticker symbol on the BitGo platform continues to be hteth.

Breaking Changes

BitGo disables support for the Ethereum Holesky testnet. All your existing Ethereum wallets on the Holesky testnet no longer function. BitGo did the following:

  • Disabled use of Holesky wallets on the BitGo platform.
  • Reset the nonce of the fee address. Fee addresses now have 0 transactions.
  • Cleared the send queue for 'hteth'.
  • Rejected all the unresolved pending approvals.

To migrate to Hoodi and resume your testnet activities:

  1. Create Hoodi wallets (see Wallets Overview).
  2. Obtain new hteth from an Ethereum Hoodi Faucet. Your Holesky hteth isn't transferable to Hoodi wallets.
  3. Update all instances of Holesky wallets in your integration to use newly created Hoodi wallets.

See Also

Ethereum Foundation Blog

Breaking Changes Policy

BitGo updates the Developer Portal with a new page that documents Breaking Changes. This page clarifies:

  • What BitGo considers a breaking change.
  • What BitGo doesn't consider a breaking change.
  • How BitGo communicates breaking changes.
  • Best practices for handling breaking changes.

Off Exchange Settlement

Off Exchange Settlements Disputes

BitGo expands Off Exchange Settlements with new dispute functionality. Clients can now dispute settlements with a partner exchange before settlement completes with BitGo.

View the integration guide at Disputes.

Webhooks

Webhook Enhancements

BitGo expands wallet webhook functionality by delivering the following:

  • The lowFeeAddressBalance webhook type for the Add wallet webhook endpoint that enables you to receive notifications when a gas tank balance is running low.
  • The customHttpHeaders parameter for the Add wallet webhook endpoint that enables you to pass custom fields and values.
  • The usePlaceholderData boolean for the Simulate wallet webhook endpoint that you can use to simulate wallet webhooks with dummy data.

In addition, BitGo expands functionality for the Create enterprise webhook endpoint by delivering the accessToken webhook type, enabling you to receive notifications when a new access token is created for an enterprise.

Integration Guides

BitGo also updates the webhook integration guide with the following new pages:

See Also