Ctrl+K

Get transfer

get/api/v2/{coin}/wallet/{walletId}/transfer/{transferId}

A transfer is a wallet specific object. Each transfer will only output the respective wallet id which the transfer is associated with.

If there is a transaction between two BitGo wallets, then two transfers will be created, one for wallet A, and one for wallet B. Transfer A will only annotate the walletId on entries where the address belongs to wallet A. Transfer B will only annotate the walletId on entries where the address belongs to wallet B.

Path Parameters

  • coinstringRequired
    A cryptocurrency or token ticker symbol.
    Example: btc
  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$
  • transferIdstring or stringRequired
    a transfer or transaction id

Query Parameters

  • includeTxRequestCreatedDatebooleanDefault: false
    True, if returning the `txRequestCreatedDate`. This field is only present on transfers associated with a transaction request.

200 Response

coin string required
A cryptocurrency or token ticker symbol.
Example: btc
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
txid string required
The on-chain transaction id
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
txidType string
The type of the transaction id
Allowed values: transactionHash blockHash
height integer required
The height of the block this Transfer was confirmed in (999999999 if unconfirmed)
heightId string
The unique height id of the block
date string <date-time>required
The date this Transfer was last updated
confirmations integer required
The number of blocks that have been confirmed since this Transfer's block was confirmed
type string required
Defines whether or not this Transfer was sent or received by the user
Allowed values: send receive
value integer
The total value (in base units) sent by this Transfer (may be approximate for ETH and other coins where amounts in base units can exceed 2^53 - 1)
valueString string required
The total value (in base units) sent by this Transfer represented as a String
Example: 2000000
Match pattern: ^-?\d+$
intendedValueString string
A string representation (in base units) of the initial value for the transfer. This is present because when a transaction fails on chain, its value is mutated to be zero. This string is immutable and will always be the intended value of the initial transfer regardless of the final state of the transaction.
Example: 2000000
Match pattern: ^-?\d+$
baseValue integer
The value (in base units) sent by this transfer, excluding network fees. BitGo is deprecating this field in the future. Instead, use baseValueWithoutFees.
baseValueString string
The value (in base units) sent by this transfer, excluding network fees represented as a string. BitGo is deprecating this field in the future. Instead, use baseValueWithoutFees.
Example: 2000000
Match pattern: ^-?\d+$
baseValueWithoutFees integer
The value (in base units) sent by this transfer excluding network fees.
baseValueWithoutFeesString string
The value (in base units) sent by this transfer, excluding network fees, represented as a string
Example: 2000000
Match pattern: ^-?\d+$
feeString string
The Transfer's fee (in base units) represented as a String
payGoFee integer
The Transfer's BitGo fee (in base units)
payGoFeeString string
The Transfer's BitGo fee (in base units) represented as a String
usd number required
The amount of USD of this Transfer (will be negative if it's a send)
usdRate number required
The USD price at the time this Transfer was created
state string required
The state of the transfer. Includes the following: - `confirmed`: The transfer is confirmed on chain. - `failed`: BitGo failed to confirm the transfer on chain. You must retry the transaction. - `initialized`: The initial state when creating a transfer. - `pendingApproval`: The transfer requires admin approval to proceed. - `rejected`: The transfer was rejected by an admin. - `removed`: A network re-org occurred, causing the confirmed transfer to be removed from the blockchain. - `replaced`: The transfer was stuck due to having a low fee and was replaced by a new transfer with a higher fee. - `signed`: The transfer was approved by an admin (if required) and then signed by BitGo. - `unconfirmed`: The signed transaction was sent to the network, and is pending on-chain validation.
Allowed values: confirmed failed initialized pendingApproval rejected removed replaced signed unconfirmed
Example: confirmed
tags array[string] required
The tags to be used on this Transfer (used in Policies)
Example: 59cd72485007a239fb00282ed480da1f
history array[object] required
An audit log of events that have happened to the Transfer during its lifecycle
date string <date-time>
The date of this history object
user string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
action string
Allowed values: created signed unconfirmed confirmed approved commented removed failed rejected
comment string
If this history object is of action `commented`, this is the comment from the user
comment string required
A comment from the user
vSize integer
The size of the transaction
nSegwitInputs integer
DEPRECATED. Number of segwit inputs on the transfer.
coinSpecific object required
Transfer fields specific to each coin type
sequenceId string
A `sequenceId` is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a `sequenceId` you can easily reference transfers and transactions&mdash;for example, to safely retry sending. Because the system only confirms one send request per `sequenceId` (and fails all subsequent attempts), you can retry sending without the risk of double spending. The `sequenceId` is only visible to users on the wallet and is not shared publicly.
consolidateId string
Consolidation ID if this transfer is part of a consolidation
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
txRequestId string
Associated transaction request ID
goStakingRequestId string
Associated GO staking request ID
subType string
Transfer subtype
Allowed values: ofc_withdrawal ofc_deposit ofc_unstake ofc_stake
feeCoin string
The coin used to pay the fee (for cross-chain transactions)
instant boolean
Whether this is an instant transaction
instantId string
The instant transaction ID if applicable
isFee boolean
Whether this transfer represents a fee
isReward boolean
Whether this transfer represents a staking reward
isUnlock boolean
Whether this transfer represents an unlock operation
metadata array[object]
Additional metadata associated with the transfer
key string
value string
sendAccounting array[object]
Accounting breakdown for send transactions
type string
amountString string
nOuts integer
amount integer
id string
createdTime string <date-time>
The time this transfer was created
approvedTime string <date-time>
The time this transfer was approved
rejectedTime string <date-time>
The time this transfer was rejected
signedTime string <date-time>
The time this transfer was signed
unconfirmedTime string <date-time>
The time this transfer became unconfirmed
confirmedTime string <date-time>
The time this transfer was confirmed
removedTime string <date-time>
The time this transfer was removed
commentedTime string <date-time>
The time this transfer was commented on
failedTime string <date-time>
The time this transfer failed
regeneratedTime string <date-time>
The time this transfer was regenerated
replacedTime string <date-time>
The time this transfer was replaced
replacingTime string <date-time>
The time this transfer started replacing another
abandonedTime string <date-time>
The time this transfer was abandoned
signedDate string <date-time>
The date this transfer was signed (legacy field)
customerApprovedTime string <date-time>
The time this transfer was approved by the customer (trust transfers)
idVerificationTime string <date-time>
The time identity verification was completed (trust transfers)
trustSignedTime string <date-time>
The time this transfer was signed by trust (trust transfers)
trustFinalApprovalTime string <date-time>
The time this transfer received final trust approval (trust transfers)
walletLabel string
Label of the wallet associated with this transfer
enterpriseName string
Name of the enterprise associated with this transfer
elliptic string
Elliptic risk score information (trust transfers)
senderInformationVerified boolean
Whether sender information has been verified (trust transfers)
buildParams object
Parameters used to build the transaction
entries array[object]
An array of objects describing the change in address balances made as a result of this Transfer
address string
An address affected by this Transfer
Example: 2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ
wallet string
Only visible when the user has access to the wallet
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
value integer
The change (in base units) in the address's balance
valueString string
The change (in base units) in the address's balance represented as a String
Example: 2000000
Match pattern: ^-?\d+$
isChange boolean
True if this address is a change address (only exists for UTXO coins) and if this is a `sent` Transfer
isPayGo boolean
True if this address is the BitGo PayGo wallet
token string
If this is a token entry, the token's symbol
Example: omg
label string
If this address was labeled by the user, this is the label
failed boolean
true if this entry is failed.
associatedNativeCoinAddress string
The native coin receive address associated with the solana ATA address. This is currently present only for BitGo addresses.
memo string
Memo associated with this entry. Only available for STX, EOS, SOL, NEAR, and POLYX. For other coins (XLM, XRP, Cosmos-based, TON), memo is stored at the transaction level or appended to the address.
type string
The type of this entry (e.g., transfer, fee, contract_call).
nftId string
NFT ID associated with this entry. Only present for NFT transfers.
nftSymbol string
NFT symbol associated with this entry. Only present for NFT transfers.
usersNotified boolean
Whether BitGo already sent notifications to the users of the transfer wallet
label string
Address labels (if any) from entries concatenated.
replaces array[string]
Transaction IDs that this transfer replaces.
replacedBy array[string]
Transaction IDs that replace this transfer.
inputs array[object]
If this is a Transfer on a UTXO coin, the array of inputs
id string
The id of the unspent in the form <txid>:<tx_index>
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2
address string
The address of this unspent
Example: 2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2
value integer
valueString string
Example: 2000000
Match pattern: ^-?\d+$
blockHeight integer
The block this Unspent was created in
date string <date-time>
The date this unspent was created
Example: 2017-03-25T23:01:40.248Z
coinbase boolean
True if this unspent came from the coinbase transaction
wallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
fromWallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
chain integer
The type of this unspent's address (P2SH, P2WSH, etc...)
Example: 0
index integer
A monotonic counter used when creating new addresses
redeemScript string
The Script program used to cryptographically verify spending this unspent
Example: 522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae
witnessScript string
The segwit Script program used to cryptographically verify spending this unspent
Example: 52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae
isSegwit boolean
outputs array[object]
If this is a Transfer on a UTXO coin, the array of outputs
id string
The id of the unspent in the form <txid>:<tx_index>
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2
address string
The address of this unspent
Example: 2MsKxhhkDo5WaLaYRGA9Cr3iSQPyXsu6Fi2
value integer
valueString string
Example: 2000000
Match pattern: ^-?\d+$
blockHeight integer
The block this Unspent was created in
date string <date-time>
The date this unspent was created
Example: 2017-03-25T23:01:40.248Z
coinbase boolean
True if this unspent came from the coinbase transaction
wallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
fromWallet string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
chain integer
The type of this unspent's address (P2SH, P2WSH, etc...)
Example: 0
index integer
A monotonic counter used when creating new addresses
redeemScript string
The Script program used to cryptographically verify spending this unspent
Example: 522102f1e990044d2a8be43d5b500bbdcb36277b97a4b07e01c5101ae8ec1568bfd6532103dab7dc82f2fc8c28200c1bdeca9c4cf181e0ca257395829cbd599395048afb57210205422e711827d8356f2fb75334d863941dd7eb45bd5788fa231dc5fa755135b653ae
witnessScript string
The segwit Script program used to cryptographically verify spending this unspent
Example: 52210351311cd81144e6cbdba561d24dfc22644cb02d053339d4beace03231b3be4f372103a8d0c1a375b9ee1a2411f9f8e18373be7f228b18260f63bbfca48809170ed08b2103c3bd8bd074657bbe9ee6714b31a4a54b6fd5b5cda0e1030122f9bf46b5034f6b53ae
isSegwit boolean

206 Response

coin string required
A cryptocurrency or token ticker symbol.
Example: btc
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
wallet string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
enterprise string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
txid string required
The on-chain transaction id
Example: b8a828b98dbf32d9fd1875cbace9640ceb8c82626716b4a64203fdc79bb46d26
txidType string
The type of the transaction id
Allowed values: transactionHash blockHash
height integer required
The height of the block this Transfer was confirmed in (999999999 if unconfirmed)
heightId string
The unique height id of the block
date string <date-time>required
The date this Transfer was last updated
confirmations integer required
The number of blocks that have been confirmed since this Transfer's block was confirmed
type string required
Defines whether or not this Transfer was sent or received by the user
Allowed values: send receive
value integer
The total value (in base units) sent by this Transfer (may be approximate for ETH and other coins where amounts in base units can exceed 2^53 - 1)
valueString string required
The total value (in base units) sent by this Transfer represented as a String
Example: 2000000
Match pattern: ^-?\d+$
intendedValueString string
A string representation (in base units) of the initial value for the transfer. This is present because when a transaction fails on chain, its value is mutated to be zero. This string is immutable and will always be the intended value of the initial transfer regardless of the final state of the transaction.
Example: 2000000
Match pattern: ^-?\d+$
baseValue integer
The value (in base units) sent by this transfer, excluding network fees. BitGo is deprecating this field in the future. Instead, use baseValueWithoutFees.
baseValueString string
The value (in base units) sent by this transfer, excluding network fees represented as a string. BitGo is deprecating this field in the future. Instead, use baseValueWithoutFees.
Example: 2000000
Match pattern: ^-?\d+$
baseValueWithoutFees integer
The value (in base units) sent by this transfer excluding network fees.
baseValueWithoutFeesString string
The value (in base units) sent by this transfer, excluding network fees, represented as a string
Example: 2000000
Match pattern: ^-?\d+$
feeString string
The Transfer's fee (in base units) represented as a String
payGoFee integer
The Transfer's BitGo fee (in base units)
payGoFeeString string
The Transfer's BitGo fee (in base units) represented as a String
usd number required
The amount of USD of this Transfer (will be negative if it's a send)
usdRate number required
The USD price at the time this Transfer was created
state string required
The state of the transfer. Includes the following: - `confirmed`: The transfer is confirmed on chain. - `failed`: BitGo failed to confirm the transfer on chain. You must retry the transaction. - `initialized`: The initial state when creating a transfer. - `pendingApproval`: The transfer requires admin approval to proceed. - `rejected`: The transfer was rejected by an admin. - `removed`: A network re-org occurred, causing the confirmed transfer to be removed from the blockchain. - `replaced`: The transfer was stuck due to having a low fee and was replaced by a new transfer with a higher fee. - `signed`: The transfer was approved by an admin (if required) and then signed by BitGo. - `unconfirmed`: The signed transaction was sent to the network, and is pending on-chain validation.
Allowed values: confirmed failed initialized pendingApproval rejected removed replaced signed unconfirmed
Example: confirmed
tags array[string] required
The tags to be used on this Transfer (used in Policies)
Example: 59cd72485007a239fb00282ed480da1f
history array[object] required
An audit log of events that have happened to the Transfer during its lifecycle
date string <date-time>
The date of this history object
user string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
action string
Allowed values: created signed unconfirmed confirmed approved commented removed failed rejected
comment string
If this history object is of action `commented`, this is the comment from the user
comment string required
A comment from the user
vSize integer
The size of the transaction
nSegwitInputs integer
DEPRECATED. Number of segwit inputs on the transfer.
coinSpecific object required
Transfer fields specific to each coin type
sequenceId string
A `sequenceId` is a unique and arbitrary wallet identifier applied to transfers and transactions at creation. It is optional but highly recommended. With a `sequenceId` you can easily reference transfers and transactions&mdash;for example, to safely retry sending. Because the system only confirms one send request per `sequenceId` (and fails all subsequent attempts), you can retry sending without the risk of double spending. The `sequenceId` is only visible to users on the wallet and is not shared publicly.
consolidateId string
Consolidation ID if this transfer is part of a consolidation
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
txRequestId string
Associated transaction request ID
goStakingRequestId string
Associated GO staking request ID
subType string
Transfer subtype
Allowed values: ofc_withdrawal ofc_deposit ofc_unstake ofc_stake
feeCoin string
The coin used to pay the fee (for cross-chain transactions)
instant boolean
Whether this is an instant transaction
instantId string
The instant transaction ID if applicable
isFee boolean
Whether this transfer represents a fee
isReward boolean
Whether this transfer represents a staking reward
isUnlock boolean
Whether this transfer represents an unlock operation
metadata array[object]
Additional metadata associated with the transfer
key string
value string
sendAccounting array[object]
Accounting breakdown for send transactions
type string
amountString string
nOuts integer
amount integer
id string
createdTime string <date-time>
The time this transfer was created
approvedTime string <date-time>
The time this transfer was approved
rejectedTime string <date-time>
The time this transfer was rejected
signedTime string <date-time>
The time this transfer was signed
unconfirmedTime string <date-time>
The time this transfer became unconfirmed
confirmedTime string <date-time>
The time this transfer was confirmed
removedTime string <date-time>
The time this transfer was removed
commentedTime string <date-time>
The time this transfer was commented on
failedTime string <date-time>
The time this transfer failed
regeneratedTime string <date-time>
The time this transfer was regenerated
replacedTime string <date-time>
The time this transfer was replaced
replacingTime string <date-time>
The time this transfer started replacing another
abandonedTime string <date-time>
The time this transfer was abandoned
signedDate string <date-time>
The date this transfer was signed (legacy field)
customerApprovedTime string <date-time>
The time this transfer was approved by the customer (trust transfers)
idVerificationTime string <date-time>
The time identity verification was completed (trust transfers)
trustSignedTime string <date-time>
The time this transfer was signed by trust (trust transfers)
trustFinalApprovalTime string <date-time>
The time this transfer received final trust approval (trust transfers)
walletLabel string
Label of the wallet associated with this transfer
enterpriseName string
Name of the enterprise associated with this transfer
elliptic string
Elliptic risk score information (trust transfers)
senderInformationVerified boolean
Whether sender information has been verified (trust transfers)
buildParams object
Parameters used to build the transaction
entries array[object]
An array of objects describing the change in address balances made as a result of this Transfer
address string
An address affected by this Transfer
Example: 2NAUwNgXaoFj2VVnSEvNLGuez8CfdU2UCMZ
wallet string
Only visible when the user has access to the wallet
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
value integer
The change (in base units) in the address's balance
valueString string
The change (in base units) in the address's balance represented as a String
Example: 2000000
Match pattern: ^-?\d+$
isChange boolean
True if this address is a change address (only exists for UTXO coins) and if this is a `sent` Transfer
isPayGo boolean
True if this address is the BitGo PayGo wallet
token string
If this is a token entry, the token's symbol
Example: omg
label string
If this address was labeled by the user, this is the label
failed boolean
true if this entry is failed.
associatedNativeCoinAddress string
The native coin receive address associated with the solana ATA address. This is currently present only for BitGo addresses.
memo string
Memo associated with this entry. Only available for STX, EOS, SOL, NEAR, and POLYX. For other coins (XLM, XRP, Cosmos-based, TON), memo is stored at the transaction level or appended to the address.
type string
The type of this entry (e.g., transfer, fee, contract_call).
nftId string
NFT ID associated with this entry. Only present for NFT transfers.
nftSymbol string
NFT symbol associated with this entry. Only present for NFT transfers.
usersNotified boolean
Whether BitGo already sent notifications to the users of the transfer wallet
label string
Address labels (if any) from entries concatenated.
replaces array[string]
Transaction IDs that this transfer replaces.
replacedBy array[string]
Transaction IDs that replace this transfer.

400 Response

One of
error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code