Skip to main content
GET
/
api
/
v1
/
transfers
/
{transfer_uuid}
Get transfer
curl --request GET \
  --url https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid} \
  --header 'CB-ACCESS-KEY: <api-key>' \
  --header 'CB-ACCESS-PASSPHRASE: <api-key>' \
  --header 'CB-ACCESS-SIGN: <api-key>' \
  --header 'CB-ACCESS-TIMESTAMP: <api-key>'
{
  "transfer_uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
  "transfer_type": "DEPOSIT",
  "amount": 5100.5,
  "asset": "USDC",
  "status": "PROCESSED",
  "network_name": "ethereum",
  "created_at": "2023-01-29T14:32:28.000Z",
  "updated_at": "2023-01-29T14:32:28.000Z",
  "from_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "to_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "from_address": "0x29d2D586e222D0610b04e71974699589379F13b5",
  "to_address": "0x29d2D586e222D0610b04e71974699589379F13b5",
  "from_cb_account": "64ac90a106d1db7863f9ab7d",
  "to_cb_account": "64ac90a106d1db7863f9ab7d",
  "from_counterparty_id": "CBTQDGENHE",
  "to_counterparty_id": "CBA6POFJW7",
  "instrument_id": 2562519737567269,
  "instrument_symbol": "BTC-PERP",
  "txn_hash": "Z3dQkmcWeuQxHKFPfsQs8QA8Jq9PFWr5yCwUjhQKcX5o99q3BmnyFfqZGNqRg9CWY9xV6QDBdDA9pH3AM6Ajpaq",
  "position_id": "14thr7ft-1-0"
}
  • Java
  • .NET
  • Go
  • Python
  • TS/JS
  • CLI
TransfersService transfersService = IntxServiceFactory.createTransfersService(client);
GetTransferRequest request = new GetTransferRequest.Builder()
    .transferUuid("transfer_uuid")
    .build();
GetTransferResponse response = transfersService.getTransfer(request);
For more information, please visit the INTX Java SDK.

Authorizations

​
CB-ACCESS-KEY
string
header
required

The Client ID that owns the API Key for the request

​
CB-ACCESS-PASSPHRASE
string
header
required

The pass phrase affiliated with the API Key

​
CB-ACCESS-SIGN
string
header
required

A HMAC SHA-256 signature using the API Key secret on the string TIMESTAMP, METHOD, REQUEST_PATH, BODY

​
CB-ACCESS-TIMESTAMP
string
header
required

The timestamp of when the request is being made

Path Parameters

​
transfer_uuid
string<uuid>
required

The UUID of the transfer request

Response

Matching transfer

​
transfer_uuid
string<uuid>

A unique identifier for the transfer

Example:

"7975e6ab-57ed-4751-b359-13f63f4da793"

​
transfer_type
enum<string>

The type of transfer

Available options:
DEPOSIT,
WITHDRAW,
STIPEND,
INTERNAL,
FUNDING,
ALL,
LOAN_ACQUIRE,
LOAN_REPAY,
LOAN_INTEREST_CHARGE,
REAL_TIME_SETTLEMENT,
ALL_LOANS,
LIQUIDATION_EQUITY_CLAWBACK,
POSITION_TRANSFER
Example:

"DEPOSIT"

​
amount
string

The amount of the asset being transferred

Example:

5100.5

​
asset
string

The asset being transferred

Example:

"USDC"

​
status
enum<string>

The current status of the transfer

Available options:
PROCESSED,
NEW,
FAILED,
STARTED
Example:

"PROCESSED"

​
network_name
string

The common name of the network on which the transfer occurred

Example:

"ethereum"

​
created_at
string<date-time>

The time the transfer was created

Example:

"2023-01-29T14:32:28.000Z"

​
updated_at
string<date-time>

The time of the most recent status change of the transfer

Example:

"2023-01-29T14:32:28.000Z"

​
from_portfolio
object

portfolio identifiers of the transfer source

​
to_portfolio
object

portfolio identifiers of the transfer target

​
from_address
string

blockchain address of transfer source

Example:

"0x29d2D586e222D0610b04e71974699589379F13b5"

​
to_address
string

blockchain address of transfer target

Example:

"0x29d2D586e222D0610b04e71974699589379F13b5"

​
from_cb_account
string

Coinbase account Id of transfer source

Example:

"64ac90a106d1db7863f9ab7d"

​
to_cb_account
string

Coinbase account Id of transfer target

Example:

"64ac90a106d1db7863f9ab7d"

​
from_counterparty_id
string

Coinbase counterparty Id of transfer source if it is a counterparty transfer

Example:

"CBTQDGENHE"

​
to_counterparty_id
string

Coinbase counterparty Id of transfer target if it is a counterparty transfer

Example:

"CBA6POFJW7"

​
instrument_id
string

The unique identifier of the instrument associated with the funding event

Example:

2562519737567269

​
instrument_symbol
string

The name of the instrument associated with the funding event

Example:

"BTC-PERP"

​
txn_hash
string

transaction hash associated with an on-chain deposit or on-chain withdrawal

Example:

"Z3dQkmcWeuQxHKFPfsQs8QA8Jq9PFWr5yCwUjhQKcX5o99q3BmnyFfqZGNqRg9CWY9xV6QDBdDA9pH3AM6Ajpaq"

​
position_id
string

id of the position used to calculate the funding payment

Example:

"14thr7ft-1-0"

⌘I