List Activities

List all activities associated with a given portfolio.

GET /v1/portfolios/{portfolio_id}/activities

List Activities

cURL

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

200

{
  "activities": [
    {
      "id": "<string>",
      "reference_id": "<string>",
      "category": "OTHER_ACTIVITY_CATEGORY",
      "type": "OTHER_ACTIVITY_TYPE",
      "secondary_type": "NO_SECONDARY_TYPE",
      "status": "OTHER_ACTIVITY_STATUS",
      "created_by": "<string>",
      "title": "<string>",
      "description": "<string>",
      "user_actions": [
        {
          "action": "OTHER_ACTION",
          "user_id": "<string>",
          "timestamp": "<string>"
        }
      ],
      "transactions_metadata": {
        "consensus": {
          "approval_deadline": "<string>",
          "has_passed_consensus": true
        }
      },
      "account_metadata": {
        "consensus": {
          "approval_deadline": "<string>",
          "has_passed_consensus": true
        }
      },
      "orders_metadata": {},
      "symbols": [
        "<string>"
      ],
      "created_at": "<string>",
      "updated_at": "<string>",
      "hierarchy_type": "HIERARCHY_TYPE_UNSPECIFIED"
    }
  ],
  "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

Java

ActivitiesService activitiesService = PrimeServiceFactory.createActivitiesService(client);
ListActivitiesRequest request = new ListActivitiesRequest.Builder("portfolio_id").build();
ListActivitiesResponse listActivitiesResponse = activitiesService.listActivities(request);ctivityByActivityIdResponse response = activitiesService.getActivityByActivityId(request);

For more information, please visit the Prime Java SDK.

.NET

var activitiesService = new ActivitiesService(client);
var list = new ListActivitiesRequest("portfolio_id");
var response = activitiesService.ListActivities(list);

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

Go

activitiesService := activities.NewActivitiesService(client)

request := &activities.ListActivitiesRequest{
    PortfolioId: credentials.PortfolioId,
}

response, err := activitiesService.ListActivities(context.Background(), request)

For more information, please visit the Prime Go SDK.

Python

prime_client = PrimeClient(credentials)

request = ListActivitiesRequest(
    portfolio_id="portfolio_id"
)
response = prime_client.list_activities(request)

For more information, please visit the Prime Python SDK.

CLI

primectl list-activities --help

For more information, please visit the Prime CLI.

TS/JS

const activitiesService = new ActivitiesService(client);

activitiesService.listPortfolioActivities({
    portfolioId: 'PORTFOLIO_ID_HERE'
}).then(async (response) => {
    console.log('Activities: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id · string · required

Portfolio to retrieve activities for.

Query Parameters

symbols · string[]

Filter by list of currencies

categories · enum<string>[]

Filter by list of activity categories [order, transaction, account, allocation, lending]

Available options: OTHER_ACTIVITY_CATEGORY, ACTIVITY_CATEGORY_ORDER, ACTIVITY_CATEGORY_TRANSACTION, ACTIVITY_CATEGORY_ACCOUNT, ACTIVITY_CATEGORY_ALLOCATION, ACTIVITY_CATEGORY_LENDING

statuses · enum<string>[]

Filter by list of statuses

Available options: OTHER_ACTIVITY_STATUS, ACTIVITY_STATUS_CANCELLED, ACTIVITY_STATUS_PROCESSING, ACTIVITY_STATUS_COMPLETED, ACTIVITY_STATUS_EXPIRED, ACTIVITY_STATUS_REJECTED, ACTIVITY_STATUS_FAILED

start_time · string

Filter created time by start date (RFC3339 format)

end_time · string

Filter created time by end date (RFC3339 format)

cursor · string

Id to retrieve additional results strictly after

limit · integer<int32>

Number of items to retrieve

sort_direction · enum<string> · default: DESC

Sorting order

Available options: DESC, ASC

get_network_unified_activities · boolean

Flag to request retrieval of all activities across all networks for a given symbol

Response

200 - application/json

A successful response.

activities · object[] · required

Show child attributes

pagination · object · required

Show child attributes