Get transfer

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>'

import requests

url = "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}"

headers = {
    "CB-ACCESS-KEY": "<api-key>",
    "CB-ACCESS-PASSPHRASE": "<api-key>",
    "CB-ACCESS-SIGN": "<api-key>",
    "CB-ACCESS-TIMESTAMP": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'CB-ACCESS-KEY': '<api-key>',
    'CB-ACCESS-PASSPHRASE': '<api-key>',
    'CB-ACCESS-SIGN': '<api-key>',
    'CB-ACCESS-TIMESTAMP': '<api-key>'
  }
};

fetch('https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "CB-ACCESS-KEY: <api-key>",
    "CB-ACCESS-PASSPHRASE: <api-key>",
    "CB-ACCESS-SIGN: <api-key>",
    "CB-ACCESS-TIMESTAMP: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("CB-ACCESS-KEY", "<api-key>")
	req.Header.Add("CB-ACCESS-PASSPHRASE", "<api-key>")
	req.Header.Add("CB-ACCESS-SIGN", "<api-key>")
	req.Header.Add("CB-ACCESS-TIMESTAMP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("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>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["CB-ACCESS-KEY"] = '<api-key>'
request["CB-ACCESS-PASSPHRASE"] = '<api-key>'
request["CB-ACCESS-SIGN"] = '<api-key>'
request["CB-ACCESS-TIMESTAMP"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
  "position_id": "14thr7ft-1-0",
  "txn_hash": "Z3dQkmcWeuQxHKFPfsQs8QA8Jq9PFWr5yCwUjhQKcX5o99q3BmnyFfqZGNqRg9CWY9xV6QDBdDA9pH3AM6Ajpaq",
  "position_transfer_reference_id": "12thr7ft-1-0",
  "position_from_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "position_to_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "position_size": 2000.5,
  "position_side": "BUY",
  "position_price": 10000.5
}

GET

api

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>'

import requests

url = "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}"

headers = {
    "CB-ACCESS-KEY": "<api-key>",
    "CB-ACCESS-PASSPHRASE": "<api-key>",
    "CB-ACCESS-SIGN": "<api-key>",
    "CB-ACCESS-TIMESTAMP": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'CB-ACCESS-KEY': '<api-key>',
    'CB-ACCESS-PASSPHRASE': '<api-key>',
    'CB-ACCESS-SIGN': '<api-key>',
    'CB-ACCESS-TIMESTAMP': '<api-key>'
  }
};

fetch('https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "CB-ACCESS-KEY: <api-key>",
    "CB-ACCESS-PASSPHRASE: <api-key>",
    "CB-ACCESS-SIGN: <api-key>",
    "CB-ACCESS-TIMESTAMP: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("CB-ACCESS-KEY", "<api-key>")
	req.Header.Add("CB-ACCESS-PASSPHRASE", "<api-key>")
	req.Header.Add("CB-ACCESS-SIGN", "<api-key>")
	req.Header.Add("CB-ACCESS-TIMESTAMP", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("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>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.international.coinbase.com/api/v1/transfers/{transfer_uuid}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["CB-ACCESS-KEY"] = '<api-key>'
request["CB-ACCESS-PASSPHRASE"] = '<api-key>'
request["CB-ACCESS-SIGN"] = '<api-key>'
request["CB-ACCESS-TIMESTAMP"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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",
  "position_id": "14thr7ft-1-0",
  "txn_hash": "Z3dQkmcWeuQxHKFPfsQs8QA8Jq9PFWr5yCwUjhQKcX5o99q3BmnyFfqZGNqRg9CWY9xV6QDBdDA9pH3AM6Ajpaq",
  "position_transfer_reference_id": "12thr7ft-1-0",
  "position_from_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "position_to_portfolio": {
    "id": "14thr7ft-1-0",
    "uuid": "7975e6ab-57ed-4751-b359-13f63f4da793",
    "name": "portfolio1"
  },
  "position_size": 2000.5,
  "position_side": "BUY",
  "position_price": 10000.5
}

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.

var transfersService = new TransfersService(client);
var request = new GetTransferRequest(
    TransferUuid: "transfer_uuid"
);
var response = transfersService.GetTransfer(request);

For more information, please visit the INTX .NET SDK.

transfersSvc := transfers.NewTransfersService(client)
request := &transfers.GetTransferRequest{
    TransferUuid: "transfer_uuid",
}
response, err := transfersSvc.GetTransfer(context.Background(), request)

For more information, please visit the INTX Go SDK.

client = IntxClient()
request = GetTransferRequest(
    transfer_uuid="transfer_uuid"
)
response = client.get_transfer(request)

For more information, please visit the INTX Python SDK.

const transfersService = new TransfersService(client);

transfersService.getTransfer({
    transferUuid: 'TRANSFER_UUID_HERE',
}).then(async (response) => {
    console.log('Transfer: ', response);
})

For more information, please visit the INTX TS SDK.

intxctl get-transfer --help

For more information, please visit the INTX CLI.

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,

REV_SHARE,

USDC_REWARD

Example:

"DEPOSIT"

amount

string

The amount of the asset being transferred. For position transfers, this represents the realized USDC PnL resulting from the transfer.

Example:

5100.5

asset

string

The asset being transferred. For position transfers, this is always USDC.

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. For position transfers, this represents the source of the realized USDC PnL movement.

Show child attributes

to_portfolio

object

Portfolio identifiers of the transfer target. For position transfers, this represents the target of the realized USDC PnL movement.

Show child attributes

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 or the position transfer event.

Example:

2562519737567269

instrument_symbol

string

The name of the instrument associated with the funding event or the position transfer event.

Example:

"BTC-PERP"

position_id

string

The ID of the position used to calculate the funding payment. Note: This field is not used by position transfer.

Example:

"14thr7ft-1-0"

txn_hash

string

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

Example:

"Z3dQkmcWeuQxHKFPfsQs8QA8Jq9PFWr5yCwUjhQKcX5o99q3BmnyFfqZGNqRg9CWY9xV6QDBdDA9pH3AM6Ajpaq"

position_transfer_reference_id

string

The ID that links two position transfer events. A position transfer action generates two transfer events: one for the position_from_portfolio and one for the position_to_portfolio. Both events share the same position_transfer_reference_id.

Example:

"12thr7ft-1-0"

position_from_portfolio

object

portfolio identifiers of the position transfer source

Show child attributes

position_to_portfolio

object

portfolio identifiers of the position transfer target

Show child attributes

position_size

string

The size of the position being transferred.

Example:

2000.5

position_side

enum<string>

The side of the position being transferred.

Available options:

BUY,

SELL

Example:

"BUY"

position_price

string

The price of the position instrument being transferred.

Example:

10000.5

Get counterparty withdrawal limit

List matching transfers

⌘I

REST API

FIX API

WEBSOCKET FEED

Authorizations

Path Parameters

Response