List Portfolio Transactions

GET

portfolios

{portfolio_id}

transactions

curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/transactions

{
  "transactions": [
    {
      "id": "BTC-USD",
      "wallet_id": "cde8dd34-b6cf-4c2c-82bc-5f86adacc868",
      "portfolio_id": "0a66a8c0-24ea-4f18-b14f-8c9cf7c1ba40",
      "type": "TRANSACTION_TYPE_UNKNOWN",
      "status": "UNKNOWN_TRANSACTION_STATUS",
      "symbol": "BTC",
      "created_at": "2021-05-31T11:59:59.000Z",
      "completed_at": "2021-05-31T12:09:31.000Z",
      "amount": "100",
      "transfer_from": {
        "type": "TRANSFER_LOCATION_TYPE_UNKNOWN",
        "value": "0bf7bf1e-bafa-4d7e-9312-fa0bf3b63f27"
      },
      "transfer_to": {
        "type": "TRANSFER_LOCATION_TYPE_UNKNOWN",
        "value": "0bf7bf1e-bafa-4d7e-9312-fa0bf3b63f27"
      },
      "network_fees": "1.99",
      "fees": "4.53",
      "fee_symbol": "USD",
      "blockchain_ids": [
        7.004643996595406e+76
      ],
      "transaction_id": "A1B2C3D4",
      "destination_symbol": "USD",
      "estimated_network_fees": {
        "lower_bound": "1.99",
        "upper_bound": "2.99"
      },
      "network": "ethereum-mainnet",
      "estimated_asset_changes": [
        {
          "type": "ASSET_CHANGE_TYPE_UNKNOWN",
          "symbol": "ETH",
          "amount": "100",
          "collection": {
            "name": "<string>"
          },
          "item": {
            "name": "<string>"
          }
        }
      ],
      "metadata": {
        "match_metadata": {
          "reference_id": "<string>",
          "settlement_date": "<string>"
        },
        "web3_transaction_metadata": {
          "label": "<string>",
          "confirmed_asset_changes": [
            {
              "type": "ASSET_CHANGE_TYPE_UNKNOWN",
              "symbol": "ETH",
              "amount": "100",
              "collection": {
                "name": "<string>"
              },
              "item": {
                "name": "<string>"
              }
            }
          ]
        }
      },
      "idempotency_key": "<string>",
      "onchain_details": {
        "signed_transaction": "01ac1872bb2967df00124a7fd15e470a10aab04852e19fc6f...",
        "risk_assessment": {
          "compliance_risk_detected": false,
          "security_risk_detected": false
        },
        "chain_id": "1",
        "nonce": "42",
        "replaced_transaction_id": "123e4567-e89b-12d3-a456-426614174000",
        "destination_address": 6.6325114945411165e+47,
        "skip_broadcast": false,
        "failure_reason": "insufficient_funds",
        "signing_status": "SIGNING_STATUS_UNKNOWN"
      },
      "network_info": {
        "id": "<string>",
        "type": "<string>"
      }
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "sort_direction": "DESC",
    "has_next": true
  }
}

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

TransactionsService transactionsService = PrimeServiceFactory.createTransactionsService(client);

ListPortfolioTransactionsRequest request = new ListPortfolioTransactionsRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .build();

ListPortfolioTransactionsResponse response = transactionsService.listPortfolioTransactions(request);

For more information, please visit the Prime Java SDK.

TransactionsService transactionsService = PrimeServiceFactory.createTransactionsService(client);

ListPortfolioTransactionsRequest request = new ListPortfolioTransactionsRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .build();

ListPortfolioTransactionsResponse response = transactionsService.listPortfolioTransactions(request);

For more information, please visit the Prime Java SDK.

var transactionsService = new TransactionsService(client);

var request = new ListPortfolioTransactionsRequest("PORTFOLIO_ID_HERE");

var response = transactionsService.ListPortfolioTransactions(request);

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

transactionsService := transactions.NewTransactionsService(client)

request := &transactions.ListPortfolioTransactionsRequest{
    PortfolioId: "PORTFOLIO_ID_HERE",
}

response, err := transactionsService.ListPortfolioTransactions(context.Background(), request)

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = ListPortfolioTransactionsRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
)

response = prime_client.list_portfolio_transactions(request)

For more information, please visit the Prime Python SDK.

primectl list-portfolio-transactions --help

For more information, please visit the Prime CLI.

const transactionsService = new TransactionsService(client);

transactionsService.listPortfolioTransactions({
    portfolioId: 'PORTFOLIO_ID_HERE'
}).then(async (response) => {
    console.log('Transactions: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id

string

required

The portfolio ID

Query Parameters

symbols

string

A case insensitive list of symbols by which to filter the response

types

enum<string>[]

The transaction types by which to filter the response

TRANSACTION_TYPE_UNKNOWN: An unknown transaction type
DEPOSIT: A fiat or crypto deposit
WITHDRAWAL: A fiat or crypto withdrawal
INTERNAL_DEPOSIT: An internal fiat or crypto deposit
INTERNAL_WITHDRAWAL: An internal fiat or crypto withdrawal
SWEEP_DEPOSIT: Internal automated deposit to a cold address from a restored address
SWEEP_WITHDRAWAL: Internal automated withdrawal from a restored address to a cold address
PROXY_DEPOSIT: On-chain deposit of funds into proxy contract from cold address
PROXY_WITHDRAWAL: On-chain withdrawal of funds from proxy contract to cold address
BILLING_WITHDRAWAL: Coinbase Prime automated invoice settlement payment
REWARD: Reward payment to an associated address for a staked asset
COINBASE_REFUND: Coinbase Prime refund for the leftover amount for a CPFP (child pays for parent) transaction
TRANSACTION_TYPE_OTHER: An OTHER type of transaction
WITHDRAWAL_ADJUSTMENT: A manual adjustment withdrawal transaction
DEPOSIT_ADJUSTMENT: A manual adjustment deposit transaction
KEY_REGISTRATION: An on-chain registration for an address
DELEGATION: An on-chain delegation transaction
UNDELEGATION: An on-chain undelegation transaction
RESTAKE: On-chain restaking transaction
COMPLETE_UNBONDING: On-chain unbonding event transaction
WITHDRAW_UNBONDED: On-chain event indicating unbonding period is over
STAKE_ACCOUNT_CREATE: On-chain transaction to begin staking from an address
CHANGE_VALIDATOR: On-chain transaction alter validator
STAKE: On-chain transaction to begin staking in Cryptocurrency network
UNSTAKE: On-chain transaction to stop staking in Cryptocurrency network
REMOVE_AUTHORIZED_PARTY: On-chain transaction to remove a party from a multi-signature wallet
STAKE_AUTHORIZE_WITH_SEED: On-chain transaction to begin staking from a seed account
SLASH: On-chain transaction indicating a slash event has occurred
COINBASE_DEPOSIT: On-chain transaction deposit for the purpose of transaction operations
CONVERSION: Internal conversion between two assets
CLAIM_REWARDS: On-chain transaction to claim rewards from Vote Account
VOTE_AUTHORIZE: On-chain transaction to transfer the reward claiming permission to other pubkey
WEB3_TRANSACTION: On-chain transaction initiated with Prime Onchain Wallet Deprecated: Use ONCHAIN_TRANSACTION instead
ONCHAIN_TRANSACTION: On-chain transaction initiated with Prime Onchain Wallet

start_time

string

UTC timestamp from which to filter the response (inclusive, ISO-8601 format)

end_time

string

UTC timestamp until which to filter the response (exclusive, ISO-8601 format)

cursor

string

Id to retrieve additional results strictly after.

limit

integer

Number of items to retrieve

sort_direction

enum<string>

default:DESC

Page sorting direction

Available options:

DESC,

ASC

Response

200

application/json

A successful response.

The response is of type object.

Get Transaction by Transaction ID

List Wallet Transactions

curl --request GET \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/transactions

{
  "transactions": [
    {
      "id": "BTC-USD",
      "wallet_id": "cde8dd34-b6cf-4c2c-82bc-5f86adacc868",
      "portfolio_id": "0a66a8c0-24ea-4f18-b14f-8c9cf7c1ba40",
      "type": "TRANSACTION_TYPE_UNKNOWN",
      "status": "UNKNOWN_TRANSACTION_STATUS",
      "symbol": "BTC",
      "created_at": "2021-05-31T11:59:59.000Z",
      "completed_at": "2021-05-31T12:09:31.000Z",
      "amount": "100",
      "transfer_from": {
        "type": "TRANSFER_LOCATION_TYPE_UNKNOWN",
        "value": "0bf7bf1e-bafa-4d7e-9312-fa0bf3b63f27"
      },
      "transfer_to": {
        "type": "TRANSFER_LOCATION_TYPE_UNKNOWN",
        "value": "0bf7bf1e-bafa-4d7e-9312-fa0bf3b63f27"
      },
      "network_fees": "1.99",
      "fees": "4.53",
      "fee_symbol": "USD",
      "blockchain_ids": [
        7.004643996595406e+76
      ],
      "transaction_id": "A1B2C3D4",
      "destination_symbol": "USD",
      "estimated_network_fees": {
        "lower_bound": "1.99",
        "upper_bound": "2.99"
      },
      "network": "ethereum-mainnet",
      "estimated_asset_changes": [
        {
          "type": "ASSET_CHANGE_TYPE_UNKNOWN",
          "symbol": "ETH",
          "amount": "100",
          "collection": {
            "name": "<string>"
          },
          "item": {
            "name": "<string>"
          }
        }
      ],
      "metadata": {
        "match_metadata": {
          "reference_id": "<string>",
          "settlement_date": "<string>"
        },
        "web3_transaction_metadata": {
          "label": "<string>",
          "confirmed_asset_changes": [
            {
              "type": "ASSET_CHANGE_TYPE_UNKNOWN",
              "symbol": "ETH",
              "amount": "100",
              "collection": {
                "name": "<string>"
              },
              "item": {
                "name": "<string>"
              }
            }
          ]
        }
      },
      "idempotency_key": "<string>",
      "onchain_details": {
        "signed_transaction": "01ac1872bb2967df00124a7fd15e470a10aab04852e19fc6f...",
        "risk_assessment": {
          "compliance_risk_detected": false,
          "security_risk_detected": false
        },
        "chain_id": "1",
        "nonce": "42",
        "replaced_transaction_id": "123e4567-e89b-12d3-a456-426614174000",
        "destination_address": 6.6325114945411165e+47,
        "skip_broadcast": false,
        "failure_reason": "insufficient_funds",
        "signing_status": "SIGNING_STATUS_UNKNOWN"
      },
      "network_info": {
        "id": "<string>",
        "type": "<string>"
      }
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "sort_direction": "DESC",
    "has_next": true
  }
}

REST API

FIX API

Websocket Feed

List Portfolio Transactions

Path Parameters

Query Parameters

Response