Skip to main content
GET
/
api
/
v1
/
transfers
List matching transfers
curl --request GET \
  --url https://api.international.coinbase.com/api/v1/transfers \
  --header 'CB-ACCESS-KEY: <api-key>' \
  --header 'CB-ACCESS-PASSPHRASE: <api-key>' \
  --header 'CB-ACCESS-SIGN: <api-key>' \
  --header 'CB-ACCESS-TIMESTAMP: <api-key>'
{
  "pagination": {
    "result_limit": 30,
    "result_offset": 50,
    "search_after_time": "2023-03-16T23:59:53Z",
    "search_after_idem": "7975e6ab-57ed-4751-b359-13f63f4da793"
  },
  "results": [
    {
      "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"
    }
  ]
}
TransfersService transfersService = IntxServiceFactory.createTransfersService(client);
ListTransfersRequest request = new ListTransfersRequest.Builder().build();
ListTransfersResponse response = transfersService.listTransfers(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

Query Parameters

​
portfolio [DEPRECATED]
string

Identifies a portfolio by UUID (e.g., 892e8c7c-e979-4cad-b61b-55a197932cf1) or portfolio ID (e.g., 5189861793641175). If a portfolio identifier is provided under this param, it will be added to the list of values under portfolios

​
portfolios
string

Identifies the portfolios by UUID (e.g., 892e8c7c-e979-4cad-b61b-55a197932cf1) or portfolio ID (e.g., 5189861793641175). Can provide single or multiple portfolios to filter by or fetches transfers for all portfolios if none are provided.

​
time_from
string<date-time>

Only find transfers updated after this time. Uses ISO-8601 format (e.g., 2023-03-16T23:59:53Z)

Example:

"2023-03-16T23:59:53.000Z"

​
time_to
string<date-time>

Only find transfers updated before this time. Uses ISO-8601 format (e.g., 2023-03-16T23:59:53Z)

Example:

"2023-03-16T23:59:53.000Z"

​
result_limit
integer

The number of results to return (defaults to 25 with a max supported value of 100)

Example:

30

​
result_offset
integer

The number of results from the beginning to skip past

Example:

50

​
status
enum<string>

The current status of transfer The current status of the transfer

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

"PROCESSED"

​
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"

​
pagination_type
enum<string>

Specifies the pagination method to use.

  • OFFSET: Traditional offset-based pagination using result_offset (default behavior). Faster but may return duplicate results when new transfers are created between paginated requests.
  • CURSOR: Cursor-based pagination using search_after_time and search_after_idem for stable, consistent results. Recommended to avoid duplicate results when new transfers are created between paginated requests, though slightly slower than offset pagination.

If not specified, the pagination type is inferred from the parameters provided.

Available options:
OFFSET,
CURSOR
​
search_after_time
string<date-time>

The updated_at timestamp of the last transfer from the previous page, used for cursor-based pagination. Must be provided together with search_after_idem. Uses ISO-8601 format (e.g., 2023-03-16T23:59:53Z). Cannot be used with result_offset or pagination_type=OFFSET.

Example:

"2023-03-16T23:59:53Z"

​
search_after_idem
string

The transfer_uuid of the last transfer from the previous page, used for cursor-based pagination. Must be provided together with search_after_time. Cannot be used with result_offset or pagination_type=OFFSET.

Response

Matching transfers

​
pagination
object

Pagination information for transfers, supporting both offset and cursor-based pagination.

​
results
object[]