> ## 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 Product

> Get information on a single product by product ID.

**Equities:** Use the canonical `product_id` returned by the Products API, not the display ticker. Equity responses include `equity_product_details`, which describes the security, current trading session, order-size permissions, and halt or liquidate-only state.



## OpenAPI

````yaml GET /api/v3/brokerage/products/{product_id}
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/products/{product_id}:
    get:
      tags:
        - Products
      summary: Get Product
      description: >-
        Get information on a single product by product ID.


        **Equities:** Use the canonical `product_id` returned by the Products
        API, not the display ticker. Equity responses include
        `equity_product_details`, which describes the security, current trading
        session, order-size permissions, and halt or liquidate-only state.
      operationId: RetailBrokerageApi_GetProduct
      parameters:
        - name: product_id
          description: The trading pair (e.g. 'BTC-USD').
          in: path
          required: true
          schema:
            type: string
        - name: get_tradability_status
          description: >-
            Whether or not to populate view_only with the tradability status of
            the product. This is only enabled for SPOT products.
          in: query
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.Product
            text/event-stream:
              schema:
                $ref: >-
                  #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.Product
        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:user:read
components:
  schemas:
    coinbase.public_api.authed.retail_brokerage_api.Product:
      type: object
      properties:
        product_id:
          type: string
          example: BTC-USD
          description: The trading pair (e.g. 'BTC-USD').
          required:
            - product_id
        price:
          type: string
          example: '140.21'
          description: The current price for the product, in quote currency.
          required:
            - price
        price_percentage_change_24h:
          type: string
          example: 9.43%
          description: >-
            The amount the price of the product has changed, in percent, in the
            last 24 hours.
          required:
            - price_percentage_change_24h
        volume_24h:
          type: string
          example: '1908432'
          description: The trading volume for the product in the last 24 hours.
          required:
            - volume_24h
        volume_percentage_change_24h:
          type: string
          example: 9.43%
          description: >-
            The amount the volume of the product has changed, in percent, in the
            last 24 hours.
          required:
            - volume_percentage_change_24h
        base_increment:
          type: string
          example: '0.00000001'
          description: Minimum amount base value can be increased or decreased at once.
          required:
            - base_increment
        quote_increment:
          type: string
          example: '0.00000001'
          description: Minimum amount quote value can be increased or decreased at once.
          required:
            - quote_increment
        quote_min_size:
          type: string
          example: '0.00000001'
          description: Minimum size that can be represented of quote currency.
          required:
            - quote_min_size
        quote_max_size:
          type: string
          example: '1000'
          description: Maximum size that can be represented of quote currency.
          required:
            - quote_max_size
        base_min_size:
          type: string
          example: '0.00000001'
          description: Minimum size that can be represented of base currency.
          required:
            - base_min_size
        base_max_size:
          type: string
          example: '1000'
          description: Maximum size that can be represented of base currency.
          required:
            - base_max_size
        base_name:
          type: string
          example: Bitcoin
          description: Name of the base currency.
          required:
            - base_name
        quote_name:
          type: string
          example: US Dollar
          description: Name of the quote currency.
          required:
            - quote_name
        watched:
          type: boolean
          example: true
          description: Whether or not the product is on the user's watchlist.
          required:
            - watched
        is_disabled:
          type: boolean
          example: false
          description: Whether or not the product is disabled for trading.
          required:
            - is_disabled
        new:
          type: boolean
          example: true
          description: Whether or not the product is 'new'.
          required:
            - new
        status:
          type: string
          description: Status of the product.
          required:
            - status
        cancel_only:
          type: boolean
          example: true
          description: >-
            Whether or not orders of the product can only be cancelled, not
            placed or edited.
          required:
            - cancel_only
        limit_only:
          type: boolean
          example: true
          description: >-
            Whether or not orders of the product can only be limit orders, not
            market orders.
          required:
            - limit_only
        post_only:
          type: boolean
          example: true
          description: >-
            Whether or not orders of the product can only be posted, not
            cancelled.
          required:
            - post_only
        trading_disabled:
          type: boolean
          example: false
          description: >-
            Whether or not the product is disabled for trading for all market
            participants.
          required:
            - trading_disabled
        auction_mode:
          type: boolean
          example: true
          description: Whether or not the product is in auction mode.
          required:
            - auction_mode
        product_type:
          description: Type of the product.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.ProductType
        quote_currency_id:
          type: string
          example: USD
          description: Symbol of the quote currency.
        base_currency_id:
          type: string
          example: BTC
          description: Symbol of the base currency.
        fcm_trading_session_details:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionDetails
        mid_market_price:
          type: string
          example: '140.22'
          description: The current midpoint of the bid-ask spread, in quote currency.
        alias:
          type: string
          example: BTC-USD
          description: Product id for the corresponding unified book.
        alias_to:
          type: array
          example:
            - BTC-USDC
          items:
            type: string
          description: Product ids that this product serves as an alias for.
        base_display_symbol:
          type: string
          example: BTC
          description: Symbol of the base display currency.
          required:
            - base_display_symbol
        quote_display_symbol:
          type: string
          example: USD
          description: Symbol of the quote display currency.
          required:
            - quote_display_symbol
        view_only:
          type: boolean
          example: true
          description: >-
            Reflects whether an FCM product has expired. For SPOT, set
            get_tradability_status to get a return value here. Defaulted to
            false for all other product types.
        price_increment:
          type: string
          example: '0.00000001'
          description: Minimum amount price can be increased or decreased at once.
        display_name:
          type: string
          example: BTC PERP
          description: Display name for the product e.g. BTC-PERP-INTX => BTC PERP
        product_venue:
          example: neptune
          description: >-
            The sole venue id for the product. Defaults to CBE if the product is
            not specific to a single venue
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.ProductVenue
        approximate_quote_24h_volume:
          type: string
          example: '1908432'
          description: >-
            The approximate trading volume for the product in the last 24 hours
            based on the current quote.
        new_at:
          type: string
          format: RFC3339 Timestamp
          example: '2021-07-01T00:00:00Z'
          description: >-
            The timestamp when the product was listed. This is only populated if
            product has new tag.
        market_cap:
          type: string
          example: '1500000000000'
          description: The market capitalization of the product's base asset.
        icon_color:
          type: string
          example: red
          description: color for icon display
        icon_url:
          type: string
          example: https://example.com
          description: A URL to the icon image.
        display_name_overwrite:
          type: string
          example: Bitcoin Perpetual
          description: An alternative name to display for the product.
        about_description:
          type: string
          example: >-
            nano Crude Oil Futures is a monthly cash-settled contract that
            allows participants to manage risk, trade on margin, or speculate on
            the price of oil.
          description: description used in about section for an asset
        best_bid_price:
          type: string
        best_ask_price:
          type: string
        high_24h:
          type: string
        low_24h:
          type: string
        future_product_details:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FutureProductDetails
        equity_product_details:
          description: >-
            Equity-specific identity, trading availability, session, and sizing
            details. Populated when product_type is EQUITY.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityProductDetails
      title: Get Products
      required:
        - product_id
        - price
        - volume_24h
        - price_percentage_change_24h
        - volume_percentage_change_24h
        - base_increment
        - quote_increment
        - quote_min_size
        - quote_max_size
        - base_min_size
        - base_max_size
        - base_name
        - quote_name
        - watched
        - is_disabled
        - new
        - status
        - cancel_only
        - limit_only
        - post_only
        - trading_disabled
        - auction_mode
        - base_display_symbol
        - quote_display_symbol
    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.ProductType:
      type: string
      enum:
        - UNKNOWN_PRODUCT_TYPE
        - SPOT
        - FUTURE
        - EQUITY
        - OPTION_GROUP
        - FUTURE_GROUP
      default: UNKNOWN_PRODUCT_TYPE
      description: Defines the type of a product.
    coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionDetails:
      type: object
      properties:
        is_session_open:
          type: boolean
        open_time:
          type: string
          format: RFC3339 Timestamp
        close_time:
          type: string
          format: RFC3339 Timestamp
        session_state:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionState
        after_hours_order_entry_disabled:
          type: boolean
        closed_reason:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionClosedReason
        maintenance:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FcmScheduledMaintenance
    coinbase.public_api.authed.retail_brokerage_api.ProductVenue:
      type: string
      enum:
        - UNKNOWN_VENUE_TYPE
        - CBE
        - FCM
        - INTX
      default: UNKNOWN_VENUE_TYPE
      description: Defines the venue of a product.
    coinbase.public_api.authed.retail_brokerage_api.FutureProductDetails:
      type: object
      properties:
        venue:
          type: string
        contract_code:
          type: string
        contract_expiry:
          type: string
          format: RFC3339 Timestamp
        contract_size:
          type: string
        contract_root_unit:
          type: string
        group_description:
          type: string
        contract_expiry_timezone:
          type: string
        group_short_description:
          type: string
        risk_managed_by:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.RiskManagementType
        contract_expiry_type:
          description: The contract expiry type (e.g. 'EXPIRING').
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.ContractExpiryType
        perpetual_details:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.PerpetualProductDetails
        contract_display_name:
          type: string
        time_to_expiry_ms:
          type: string
          format: int64
        non_crypto:
          type: boolean
        contract_expiry_name:
          type: string
        twenty_four_by_seven:
          type: boolean
        funding_interval:
          type: string
        open_interest:
          type: string
        funding_rate:
          type: string
        funding_time:
          type: string
          format: RFC3339 Timestamp
        display_name:
          type: string
        region_enabled:
          type: object
          additionalProperties:
            type: boolean
        intraday_margin_rate:
          description: Margin rates during intraday trading hours
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.MarginRate
        overnight_margin_rate:
          description: Margin rates during overnight trading hours
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.MarginRate
        settlement_price:
          type: string
          description: The most recent official settlement price for the futures contract
        futures_asset_type:
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FuturesAssetType
        index_price:
          type: string
          description: >-
            The index price for the futures contract, used for mark-to-market
            and PnL calculations
        contract_code_display_name:
          type: string
        product_group_cbrn:
          type: string
          description: The CBRN of the product group this future belongs to
        futures_asset_types:
          type: array
          items:
            $ref: >-
              #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.FuturesAssetType
        trading_hours_type:
          description: Trading hours schedule this futures product follows.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.TradingHoursType
        deribit_product_details:
          description: >-
            Deribit-specific instrument metadata. Only populated for Deribit
            products.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.DeribitProductDetails
    coinbase.public_api.authed.retail_brokerage_api.EquityProductDetails:
      type: object
      properties:
        equity_subtype:
          description: Security classification, such as common stock, ADR, or ETF.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityProductSubtype
        fractionable:
          type: boolean
          description: >-
            Whether the product supports fractional-share trading. Check
            equity_trading_flags for side- and size-specific permissions.
        liquidate_only:
          type: boolean
          description: >-
            Whether the product may only be sold to reduce an existing position.
            New buy orders are not accepted when true.
        ticker:
          type: string
          description: >-
            Display ticker for the equity, such as COIN. Use Product.product_id,
            not this ticker, in order requests.
        description:
          type: string
          description: Display name of the equity, such as Coinbase Global Inc.
        trading_halted:
          type: boolean
          description: >-
            Whether trading is currently halted. New orders are not accepted
            while true.
        trading_halted_start_time:
          type: string
          format: RFC3339 Timestamp
          description: Time at which the current trading halt began.
        trading_halted_end_time:
          type: string
          format: RFC3339 Timestamp
          description: Expected end time of the current trading halt, when available.
        fractional_notional_min_size:
          type: string
          description: Minimum quote-currency amount for a fractional or notional order.
        cik:
          type: string
          description: SEC Central Index Key for the issuer.
        short_name:
          type: string
          description: Short display name for the issuer or fund.
        company_description:
          type: string
          description: Description of the issuer or fund.
        company_website:
          type: string
          description: Public website for the issuer or fund.
        trading_day_info:
          description: >-
            Schedule and status for the current equity trading day, including
            session windows and holiday information.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingDayInfo
        current_session:
          description: Trading session active at the time of the response.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingSession
        opol:
          type: string
          description: >-
            ISO 10383 Market Identifier Code (MIC) for the official place of
            listing.
        recent_trading_days:
          description: >-
            Recent trading-day schedules used to account for weekends, holidays,
            and early closes.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.TradingDayData
        equity_trading_flags:
          description: >-
            Granular permissions that indicate which buy/sell and
            whole-share/fractional/notional order combinations are currently
            supported.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingFlags
    coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionState:
      type: string
      enum:
        - FCM_TRADING_SESSION_STATE_UNDEFINED
        - FCM_TRADING_SESSION_STATE_PRE_OPEN
        - FCM_TRADING_SESSION_STATE_PRE_OPEN_NO_CANCEL
        - FCM_TRADING_SESSION_STATE_OPEN
        - FCM_TRADING_SESSION_STATE_CLOSE
        - FCM_TRADING_SESSION_STATE_HALTED
      default: FCM_TRADING_SESSION_STATE_UNDEFINED
      description: Defines the state of a trading session.
    coinbase.public_api.authed.retail_brokerage_api.FcmTradingSessionClosedReason:
      type: string
      enum:
        - FCM_TRADING_SESSION_CLOSED_REASON_UNDEFINED
        - FCM_TRADING_SESSION_CLOSED_REASON_REGULAR_MARKET_CLOSE
        - FCM_TRADING_SESSION_CLOSED_REASON_EXCHANGE_MAINTENANCE
        - FCM_TRADING_SESSION_CLOSED_REASON_VENDOR_MAINTENANCE
      default: FCM_TRADING_SESSION_CLOSED_REASON_UNDEFINED
      description: >-
        This helps distinguish between regular market close and downtimes due to
        maintenance.
    coinbase.public_api.authed.retail_brokerage_api.FcmScheduledMaintenance:
      type: object
      properties:
        start_time:
          type: string
          format: RFC3339 Timestamp
        end_time:
          type: string
          format: RFC3339 Timestamp
      description: Fcm specific scheduled maintenance details.
    coinbase.public_api.authed.retail_brokerage_api.RiskManagementType:
      type: string
      enum:
        - UNKNOWN_RISK_MANAGEMENT_TYPE
        - MANAGED_BY_FCM
        - MANAGED_BY_VENUE
      default: UNKNOWN_RISK_MANAGEMENT_TYPE
      description: Defines Risk management type.
    coinbase.public_api.authed.retail_brokerage_api.ContractExpiryType:
      type: string
      enum:
        - UNKNOWN_CONTRACT_EXPIRY_TYPE
        - EXPIRING
        - PERPETUAL
      default: UNKNOWN_CONTRACT_EXPIRY_TYPE
      description: Represents the types of contract expiry.
    coinbase.public_api.authed.retail_brokerage_api.PerpetualProductDetails:
      type: object
      properties:
        open_interest:
          type: string
        funding_rate:
          type: string
        funding_time:
          type: string
          format: RFC3339 Timestamp
        max_leverage:
          type: string
        base_asset_uuid:
          type: string
        underlying_type:
          type: string
    coinbase.public_api.authed.retail_brokerage_api.MarginRate:
      type: object
      properties:
        long_margin_rate:
          type: string
          example: '0.5'
          description: Long margin rate
        short_margin_rate:
          type: string
          example: '0.5'
          description: Short margin rate
      title: Margin rate information for futures products
    coinbase.public_api.authed.retail_brokerage_api.FuturesAssetType:
      type: string
      enum:
        - UNKNOWN_FUTURES_ASSET_TYPE
        - FUTURES_ASSET_TYPE_CRYPTO
        - FUTURES_ASSET_TYPE_METALS
        - FUTURES_ASSET_TYPE_ENERGY
        - FUTURES_ASSET_TYPE_STOCKS
        - FUTURES_ASSET_TYPE_COMMODITIES
        - FUTURES_ASSET_TYPE_INDICES
      default: UNKNOWN_FUTURES_ASSET_TYPE
      description: >-
        Asset type for futures/derivatives products.

        Other product types (Equity, Prediction Market) will have their own
        enums.
    coinbase.public_api.authed.retail_brokerage_api.TradingHoursType:
      type: string
      enum:
        - TRADING_HOURS_TYPE_UNSPECIFIED
        - TRADING_HOURS_TYPE_EQUITY_INDEX
      default: TRADING_HOURS_TYPE_UNSPECIFIED
      description: Trading hours schedule a futures product follows.
    coinbase.public_api.authed.retail_brokerage_api.DeribitProductDetails:
      type: object
      properties:
        instrument_id:
          type: string
          description: The venue's numeric instrument identifier.
        settlement_currency:
          type: string
          description: The currency the instrument settles in.
        counter_currency:
          type: string
          description: The counter currency for the instrument.
        settlement_period:
          type: string
          description: The settlement period (e.g. 'day', 'week', 'month', 'perpetual').
        price_index:
          type: string
          description: The name of the price index used for this instrument.
        instrument_type:
          type: string
          description: Whether the instrument is 'linear' or 'reversed' (inverse).
        maker_commission:
          type: string
          description: The maker commission rate.
        taker_commission:
          type: string
          description: The taker commission rate.
        block_trade_commission:
          type: string
          description: The block trade commission rate.
        block_trade_tick_size:
          type: string
          description: The minimal price change for block trading.
        block_trade_min_trade_amount:
          type: string
          description: The minimum amount for block trading.
        creation_time:
          type: string
          format: RFC3339 Timestamp
          description: The time when the instrument was first created.
        max_leverage:
          type: string
          description: Maximal leverage for the instrument (futures only).
        max_liquidation_commission:
          type: string
          description: >-
            Maximal liquidation trade commission for the instrument (futures
            only).
        tick_size_steps:
          type: array
          items:
            $ref: >-
              #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.TickSizeStep
          description: >-
            Piecewise tick-size overrides that apply above given price
            thresholds.
        qty_tick_size:
          type: string
          description: >-
            Minimum quantity change (step size) for order amounts on this
            instrument.
        index_id:
          type: string
          description: >-
            Numeric identifier for the price index associated with this
            instrument.
        product_group:
          type: string
          description: >-
            Product group classification for the instrument's base currency
            (e.g. BTC, ETH, TIER_2).
        base_currency_uuid:
          type: string
          description: Identifier for the base currency.
        quote_currency_uuid:
          type: string
          description: Identifier for the quote currency.
        state:
          type: string
          description: >-
            The raw Deribit order-book state (e.g. 'open', 'locked',
            'settlement', 'delivered', 'inactive', 'halted', 'archivized').
            Product.status is normalised to online/offline; this preserves the
            exact venue state.
        delivery_price:
          type: string
          description: >-
            The settlement (delivery) price the instrument resolved at when it
            expired. Only populated for expired Deribit instruments.
      description: >-
        DeribitProductDetails carries the venue-specific instrument metadata
        returned

        by Deribit's get_instruments that is common to futures and options. It
        hangs

        off FutureProductDetails / OptionProductDetails and is only populated
        for

        Deribit products.
    coinbase.public_api.authed.retail_brokerage_api.EquityProductSubtype:
      type: string
      enum:
        - EQUITY_PRODUCT_SUBTYPE_UNSPECIFIED
        - EQUITY_PRODUCT_SUBTYPE_COMMON_STOCK
        - EQUITY_PRODUCT_SUBTYPE_PREFERRED_STOCK
        - EQUITY_PRODUCT_SUBTYPE_PREFERRED_ADR
        - EQUITY_PRODUCT_SUBTYPE_SPECIAL_STOCK
        - EQUITY_PRODUCT_SUBTYPE_INDEX
        - EQUITY_PRODUCT_SUBTYPE_WARRANT
        - EQUITY_PRODUCT_SUBTYPE_ADR
        - EQUITY_PRODUCT_SUBTYPE_RIGHTS
        - EQUITY_PRODUCT_SUBTYPE_SHARES_OF_BENEFICIAL_INTEREST
        - EQUITY_PRODUCT_SUBTYPE_CERTIFICATES
        - EQUITY_PRODUCT_SUBTYPE_UNITS
        - EQUITY_PRODUCT_SUBTYPE_DEBT_ISSUE
        - EQUITY_PRODUCT_SUBTYPE_OPTION
        - EQUITY_PRODUCT_SUBTYPE_ETF
      default: EQUITY_PRODUCT_SUBTYPE_UNSPECIFIED
      description: Defines the subtype of an equity product.
    coinbase.public_api.authed.retail_brokerage_api.EquityTradingDayInfo:
      type: object
      properties:
        venue_id:
          type: string
          description: Identifier for the equity trading venue.
        date:
          type: string
          description: Trading date in YYYY-MM-DD format.
        trade_date_type:
          description: >-
            Whether the date follows a regular, early-close, or fully closed
            schedule.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradeDateType
        holiday_name:
          type: string
          description: Holiday name when the schedule is affected by a market holiday.
        version_id:
          type: string
          description: Version identifier for this trading-day schedule.
        trading_sessions:
          type: array
          items:
            $ref: >-
              #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingSessionWindow
          description: >-
            Trading sessions available on this date. Use these windows instead
            of hard-coded market hours.
      title: >-
        EquityTradingDayInfo contains trading day and session information for an
        equity venue
    coinbase.public_api.authed.retail_brokerage_api.EquityTradingSession:
      type: string
      enum:
        - UNKNOWN_EQUITY_TRADING_SESSION
        - EQUITY_TRADING_SESSION_NORMAL
        - EQUITY_TRADING_SESSION_AFTER_HOURS
        - EQUITY_TRADING_SESSION_MULTI_SESSION
        - EQUITY_TRADING_SESSION_OVERNIGHT
        - EQUITY_TRADING_SESSION_PRE_MARKET
      default: UNKNOWN_EQUITY_TRADING_SESSION
      description: >-
        Equity execution session. NORMAL is regular market hours and is the only
        session that supports market orders. PRE_MARKET, AFTER_HOURS, OVERNIGHT,
        and MULTI_SESSION accept only whole-share limit orders. MULTI_SESSION
        spans multiple eligible sessions.
      title: Trading session in which an equity order may execute.
    coinbase.public_api.authed.retail_brokerage_api.TradingDayData:
      type: object
      properties:
        trading_days:
          type: array
          items:
            $ref: >-
              #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingDayInfo
      title: >-
        TradingDayData provides recent historical trading day information for
        downstream services to calculate timezone-aware price changes
    coinbase.public_api.authed.retail_brokerage_api.EquityTradingFlags:
      type: object
      properties:
        tradable:
          type: boolean
          description: Whether at least one buy or sell flow is enabled for this product.
        searchable:
          type: boolean
          description: Whether the product is searchable and discoverable.
        buy_enabled:
          type: boolean
          description: Whether any buy order flow is enabled.
        buy_whole_shares:
          type: boolean
          description: Whether buying a whole number of shares is enabled.
        buy_fractional_shares:
          type: boolean
          description: Whether buying a fractional number of shares is enabled.
        buy_notional:
          type: boolean
          description: Whether buying by quote-currency amount is enabled.
        sell_enabled:
          type: boolean
          description: Whether any sell order flow is enabled.
        sell_whole_shares:
          type: boolean
          description: Whether selling a whole number of shares is enabled.
        sell_fractional_shares:
          type: boolean
          description: Whether selling a fractional number of shares is enabled.
        sell_notional:
          type: boolean
          description: Whether selling by quote-currency amount is enabled.
      title: >-
        EquityTradingFlags contains granular trading permissions for equity
        products
    coinbase.public_api.authed.retail_brokerage_api.TickSizeStep:
      type: object
      properties:
        above_price:
          type: string
          description: The price from which the increased tick size applies.
        tick_size:
          type: string
          description: The tick size to use above above_price.
      description: >-
        A piecewise tick-size override that applies above a given price
        threshold,

        for instruments whose tick size grows with price (Deribit
        tick_size_steps).
    coinbase.public_api.authed.retail_brokerage_api.EquityTradeDateType:
      type: string
      enum:
        - TRADE_DATE_TYPE_UNSPECIFIED
        - TRADE_DATE_TYPE_REGULAR
        - TRADE_DATE_TYPE_EARLY_CLOSE
        - TRADE_DATE_TYPE_FULL_CLOSE
      default: TRADE_DATE_TYPE_UNSPECIFIED
      description: Describes whether and how an equity market trades on a calendar date.
    coinbase.public_api.authed.retail_brokerage_api.EquityTradingSessionWindow:
      type: object
      properties:
        session_type:
          description: Trading session represented by this window.
          allOf:
            - $ref: >-
                #/components/schemas/coinbase.public_api.authed.retail_brokerage_api.EquityTradingSession
        session_start_time:
          type: string
          format: RFC3339 Timestamp
          description: Start of the session window.
        session_end_time:
          type: string
          format: RFC3339 Timestamp
          description: End of the session window.
        support_fractional:
          type: boolean
          description: Whether fractional-share orders are supported during this session.
        limit_only:
          type: boolean
          description: Whether only limit orders are supported during this session.
      title: TradingWindow represents a trading session window within a trading day
  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.

````