Skip to main content

Query Activity (Unified)

Retrieve all TPX activity (orders, money movements, transfers) in a single request.

Endpoint

query getMyTpxActivity($input: GetMyTpxActivityInput!)

Purpose

The unified activity endpoint is a convenience query that:

  • Executes all 3 queries in parallel (~0.5s total)
  • Returns complete activity context
  • Useful for dashboard views and reconciliation

Example Query

query {
getMyTpxActivity(input: {
conversationId: "abc-123"
pagination: { limit: 10, offset: 0 }
}) {
orders {
id
status
totalAmountCents
}
ordersTotalCount

moneyMovements {
id
status
movementType
amountCents
}
moneyMovementsTotalCount

transfers {
id
status
transferType
}
transfersTotalCount
}
}

Response Structure

Each entity type has:

  • Array of entities - Paginated results
  • Total count - Total matching records (ignoring pagination)

When to Use

Use getMyTpxActivity when:

  • Building dashboards showing complete auction context
  • Need to see all related entities at once
  • Want single API call for multiple entity types

Use individual queries when:

  • Only need one entity type (faster, less data)
  • Need status filtering per entity type
  • Want more control over pagination per type