Query Money Movements

Retrieve payment transactions and settlements for your TPX orders.

Endpoint

query getMyTpxMoneyMovements($input: GetMyTpxMoneyMovementsInput!)

Example Queries

Query by ICO ID

query {
  getMyTpxMoneyMovements(input: {
    instantCashOfferId: "8801e2de-d04d-4198-ad9a-30f18364b1c3"
    pagination: { limit: 20, offset: 0 }
  }) {
    moneyMovements {
      id
      status
      movementType
      amountCents
      currency
      paymentPlatform
      feeAmountCents
      sourceType
      sourceId
      createdAt
    }
    pagination {
      totalCount
      hasNextPage
    }
  }
}

Filter by Status and Date Range

query {
  getMyTpxMoneyMovements(input: {
    statuses: ["COMPLETED"]
    createdAfter: "2025-11-01T00:00:00Z"
    createdBefore: "2025-11-30T23:59:59Z"
    pagination: { limit: 50, offset: 0 }
  }) {
    moneyMovements {
      id
      status
      movementType
      amountCents
      feeAmountCents
      createdAt
    }
    pagination {
      totalCount
    }
  }
}

Input Parameters

Field	Type	Description
conversationId	ID	TPX conversation ID from webhooks
instantCashOfferId	ID	ICO ID from webhooks
orderId	ID	Order ID
transferId	ID	Find movements associated with this transfer
externalReferenceId	String	Your tracking ID from conditional bid
createdAfter	DateTime	Filter by creation date (greater than or equal)
createdBefore	DateTime	Filter by creation date (less than or equal)
updatedAfter	DateTime	Filter by update date (greater than or equal)
updatedBefore	DateTime	Filter by update date (less than or equal)
statuses	[String!]	Filter by status (see Status Values)
pagination	SimplePaginationInput	Limit and offset

Movement Types

• PURCHASE - Your payments to Tradepost for winning bids
• SALE - Payments received from Tradepost (if you're also a seller)
• PAYOUT - Payments to seller
• REVERSAL - Reversal of a previous transaction
• ADJUSTMENT - Balance adjustments
• WITHDRAWAL - Account withdrawals

Status Values

• PENDING - Transaction initiated
• PROCESSING - Payment processing
• SCHEDULED - Payment scheduled for a specific time
• COMPLETED - Transaction completed
• ACCELERATED - Completed but was accelerated (payouts only)
• FAILED - Payment failed
• CANCELED - Transaction canceled
• ON_HOLD - Under review or investigation

Key Fields

• amountCents - Transaction amount in cents
• feeAmountCents - Platform or processor fees
• paymentPlatform - Payment processor used
• sourceType - What triggered this movement (e.g., ORDER)
• sourceId - ID of the source entity