> ## Documentation Index > Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Transaction Summary > Get a summary of transactions with fee tiers, total volume, and fees. ## OpenAPI ````yaml GET /api/v3/brokerage/transaction_summary openapi: 3.1.0 info: title: Coinbase Advanced Trade API version: '0.1' servers: - url: https://api.coinbase.com security: - ApiKey: [] - OAuth2: [] paths: /api/v3/brokerage/transaction_summary: get: tags: - Fees summary: Get Transaction Summary description: Get a summary of transactions with fee tiers, total volume, and fees. operationId: RetailBrokerageApi_GetTransactionSummary parameters: - name: product_type description: >- Only returns the orders matching this product type. By default, returns all product types. in: query required: false schema: type: string enum: - UNKNOWN_PRODUCT_TYPE - SPOT - FUTURE - EQUITY - OPTION_GROUP - FUTURE_GROUP default: UNKNOWN_PRODUCT_TYPE - name: contract_expiry_type description: >- Only returns the orders matching this contract expiry type. Only applicable if product_type is set to FUTURE. in: query required: false schema: type: string enum: - UNKNOWN_CONTRACT_EXPIRY_TYPE - EXPIRING - PERPETUAL default: UNKNOWN_CONTRACT_EXPIRY_TYPE - name: product_venue description: Venue for product in: query required: false schema: type: string enum: - UNKNOWN_VENUE_TYPE - CBE - FCM - INTX default: UNKNOWN_VENUE_TYPE responses: '200': description: A successful response. content: application/json: schema: $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.GetTransactionSummaryResponse text/event-stream: schema: $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.GetTransactionSummaryResponse default: description: An unexpected error response. content: application/json: schema: $ref: '#/components/schemas/grpc.gateway.runtime.Error' text/event-stream: schema: $ref: '#/components/schemas/grpc.gateway.runtime.Error' security: - ApiKey: - view - OAuth2: - wallet:transactions:read components: schemas: coinbase.public_api.authed.retail_brokerage_api.GetTransactionSummaryResponse: type: object properties: total_fees: type: number format: double example: 25 description: Total fees across assets, denoted in USD. required: - total_fees fee_tier: description: >- Description of maker and taker rates across all applicable fee tiers. required: - fee_tier allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTier margin_rate: example: 0.5 description: Margin rate, only applicable to product_type `FUTURE`. allOf: - $ref: '#/components/schemas/coinbase.brokerage.types.Decimal' goods_and_services_tax: allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.GoodsAndServicesTax advanced_trade_only_volume: type: number format: double example: 1000 description: >- Advanced Trade volume (non-inclusive of Pro) across assets, denoted in USD. advanced_trade_only_fees: type: number format: double example: 25 description: >- Advanced Trade fees (non-inclusive of Pro) across assets, denoted in USD. coinbase_pro_volume: type: number format: double example: 1000 description: Coinbase Pro volume across assets, denoted in USD. coinbase_pro_fees: type: number format: double example: 25 description: Coinbase Pro fees across assets, denoted in USD. total_balance: type: string example: '1000' description: >- Total balance across assets and products, which is comprised of the sum of spot, intx, and fcm, and denoted in USD. volume_breakdown: type: array example: - volume_type: VOLUME_TYPE_SPOT volume: 1000 items: $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.Volume description: Breakdown of volumes that contributed to the fee tier calculation. has_cost_plus_commission: type: boolean example: false description: Indicates whether the user uses cost plus commission pricing model. fee_tier_without_promotion: description: >- The fee tier the user qualifies for based purely on their volume or AOP, ignoring any promotional fees or incentives. Includes current and next `FeeTier` rows, which dimension qualifies them, their current value for that dimension, and the threshold needed to reach the next tier. allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTierWithoutPromotion deribit_venue_data: description: >- Transaction summary for each INTX derivatives product type (perps, dated futures, options), resolved together by the shared fee data pipeline. Only populated for INTX derivatives requests. allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.DeribitVenueData required: - total_volume - total_fees - fee_tier grpc.gateway.runtime.Error: type: object properties: error: type: string code: type: integer format: int32 message: type: string details: type: array items: type: object additionalProperties: true coinbase.public_api.authed.retail_brokerage_api.FeeTier: type: object properties: pricing_tier: type: string example: <$10k description: Pricing tier for user, determined by notional (USD) volume. taker_fee_rate: type: string example: '0.0010' description: Taker fee rate, applied if the order takes liquidity. maker_fee_rate: type: string example: '0.0020' description: Maker fee rate, applied if the order creates liquidity. aop_from: type: string example: '0' description: >- Lower bound (inclusive) of pricing tier in usd of total assets on platform. aop_to: type: string example: '10000' description: >- Upper bound (exclusive) of pricing tier in usd of total assets on platform. volume_types_and_range: type: array example: - volume_types: - VOLUME_TYPE_SPOT - VOLUME_TYPE_US_DERIVATIVES vol_from: '0' vol_to: '50000' items: $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.VolumeTypesAndRange description: >- List of rules that define how a tier evaluates 30-day volume by combining specific volume types. coinbase.brokerage.types.Decimal: type: object properties: value: type: string description: String representation allows for unlimited precision. description: Represents a decimal number with precision. coinbase.public_api.authed.retail_brokerage_api.GoodsAndServicesTax: type: object properties: rate: type: string type: allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.GstType coinbase.public_api.authed.retail_brokerage_api.Volume: type: object properties: volume_type: example: VOLUME_TYPE_SPOT description: Type of volume contributing to fee tier calculation. allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.VolumeType volume: type: number format: double example: 1000 description: Volume amount. coinbase.public_api.authed.retail_brokerage_api.FeeTierWithoutPromotion: type: object properties: pricing_tier: type: string example: Advanced 3 description: >- **(Deprecated)** Pricing tier name; prefer `current_tier.pricing_tier`. qualification_type: description: >- Dimension that qualifies the user for this tier (spot volume, AOP, etc.). allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTierQualificationType current_value: type: string example: '25000' description: >- The user's current value for the qualifying dimension (volume in USD, or AOP in USD). next_tier_threshold: type: string example: '50000' description: >- The value of the qualifying dimension needed to reach the next tier. Empty if the user is already in the top tier. current_tier: description: >- Full fee schedule definition for the user's current non-promotional tier (maker/taker rates and tier bounds). allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTier next_tier: description: >- Full fee schedule definition for the next non-promotional tier. Omitted when the user is already in the top tier. allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTier current_tier_threshold: type: string example: '10000' description: >- The lower bound of the qualifying dimension for the user's current tier (volume in USD, or AOP in USD). Empty if undetermined. description: >- FeeTierWithoutPromotion describes the fee tier a user is in based purely on volume or AOP, excluding any promotional fee schedules or fee incentives. coinbase.public_api.authed.retail_brokerage_api.DeribitVenueData: type: object properties: perps: allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.DerivativesProductTransactionSummary dated_futures: allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.DerivativesProductTransactionSummary options: allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.DerivativesProductTransactionSummary description: >- DeribitVenueData groups the transaction summary for each INTX derivatives product type, resolved together by the shared fee_data_fetcher pipeline. coinbase.public_api.authed.retail_brokerage_api.VolumeTypesAndRange: type: object properties: volume_types: type: array example: - VOLUME_TYPE_SPOT - VOLUME_TYPE_US_DERIVATIVES items: $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.VolumeType description: Volume types to combine to contribute to this fee tier calculation. vol_from: type: string example: '0' description: Lower bound (inclusive) for the combined volume. vol_to: type: string example: '50000' description: Upper bound (exclusive) for the combined volume . title: >- VolumeTypesAndRange defines volume-based fee tier configurations that combine multiple volume types coinbase.public_api.authed.retail_brokerage_api.GstType: type: string enum: - INCLUSIVE - EXCLUSIVE default: INCLUSIVE title: >- - INCLUSIVE: inclusive means the `feeTier`` is inclusive of the GST (e.g SG) - EXCLUSIVE: exclusive means the `feeTier`` is exclusive of the GST (e.g AU) coinbase.public_api.authed.retail_brokerage_api.VolumeType: type: string enum: - VOLUME_TYPE_UNKNOWN - VOLUME_TYPE_SPOT - VOLUME_TYPE_INTX_PERPS - VOLUME_TYPE_US_DERIVATIVES - VOLUME_TYPE_SIMPLE_SPOT - VOLUME_TYPE_SIMPLE_FCM - VOLUME_TYPE_SIMPLE_INTX_PERPS - VOLUME_TYPE_EQUITY - VOLUME_TYPE_OPTIONS - VOLUME_TYPE_DATED_FUTURES default: VOLUME_TYPE_UNKNOWN title: |- - VOLUME_TYPE_UNKNOWN: Unknown or unspecified volume type - VOLUME_TYPE_SPOT: Spot trading volume - VOLUME_TYPE_INTX_PERPS: International exchange perpetual contracts volume - VOLUME_TYPE_US_DERIVATIVES: US derivatives (futures) trading volume - VOLUME_TYPE_SIMPLE_SPOT: Simple (RETAIL_SIMPLE) spot trading volume - VOLUME_TYPE_SIMPLE_FCM: Simple (RETAIL_SIMPLE) FCM expiring futures trading volume - VOLUME_TYPE_SIMPLE_INTX_PERPS: Simple (RETAIL_SIMPLE) INTX perpetual futures trading volume - VOLUME_TYPE_EQUITY: Equity trading volume (stocks/ETFs tracked independently from crypto spot) - VOLUME_TYPE_OPTIONS: Derivatives options trading volume - VOLUME_TYPE_DATED_FUTURES: Dated futures trading volume coinbase.public_api.authed.retail_brokerage_api.FeeTierQualificationType: type: string enum: - FEE_TIER_QUALIFICATION_TYPE_UNKNOWN - FEE_TIER_QUALIFICATION_TYPE_SPOT_VOLUME - FEE_TIER_QUALIFICATION_TYPE_US_DERIVATIVES_VOLUME - FEE_TIER_QUALIFICATION_TYPE_INTX_PERPS_VOLUME - FEE_TIER_QUALIFICATION_TYPE_AOP - FEE_TIER_QUALIFICATION_TYPE_COMBINED_VOLUME default: FEE_TIER_QUALIFICATION_TYPE_UNKNOWN description: >- FeeTierQualificationType identifies which dimension placed the user in their fee tier when promotional fees/incentives are excluded. - FEE_TIER_QUALIFICATION_TYPE_COMBINED_VOLUME: COMBINED_VOLUME indicates the tier is qualified by a sum of multiple volume types (see volume_types on the corresponding fee tier for details). coinbase.public_api.authed.retail_brokerage_api.DerivativesProductTransactionSummary: type: object properties: total_volume: type: number format: double example: 1000 description: Total volume for this product, denoted in USD. total_fees: type: number format: double example: 25 description: Total fees for this product, denoted in USD. fee_tier: description: >- Description of maker and taker rates across all applicable fee tiers. allOf: - $ref: >- #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FeeTier description: >- DerivativesProductTransactionSummary is the transaction summary for a single INTX derivatives product type (perps, dated futures, or options). There is no per-product total_balance: the pipeline only resolves an account-level balance, which doesn't have a per-product meaning. securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: JWT description: >- A bearer token signed using your API Key Secret, see [Creating API Keys](/coinbase-app/authentication-authorization/api-key-authentication) section of our docs for more information. See [Scope & Permissions](/coinbase-app/advanced-trade-apis/rest-scopes) for the permission each endpoint requires. OAuth2: type: oauth2 description: >- An OAuth 2.0 access token from the Coinbase App OAuth2 flow. See [Scope & Permissions](/coinbase-app/advanced-trade-apis/rest-scopes) for the scope each endpoint requires. flows: authorizationCode: authorizationUrl: https://login.coinbase.com/oauth2/auth tokenUrl: https://login.coinbase.com/oauth2/token scopes: wallet:user:read: View your account information. wallet:user:update: Update your account information. wallet:accounts:read: View your accounts. wallet:buys:create: Place, edit, and cancel orders. wallet:trades:read: View your cryptocurrency conversions. wallet:trades:create: Convert cryptocurrencies. wallet:transactions:read: View your transactions. wallet:transactions:transfer: Transfer funds between accounts. wallet:payment-methods:read: View your payment methods. ````