> ## Documentation Index
> Fetch the complete documentation index at: https://docs.calmtreasury.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Quote a Cash App order

> Return a pricing preview for a Cash App order.

Prices a Cash App purchase before the buyer commits.


## OpenAPI

````yaml api/openapi.json POST /v1/cashapp/quote
openapi: 3.1.0
info:
  description: Fiat-to-USDC onramp API. The URL prefix (`/v1`) is the version contract.
  license:
    identifier: LicenseRef-Proprietary
    name: Proprietary
  title: Calm API
  version: v1
servers:
  - description: Production
    url: https://api.calmtreasury.xyz
  - description: Sandbox
    url: https://api.sandbox.calmtreasury.xyz
security: []
paths:
  /v1/cashapp/quote:
    post:
      summary: Quote a Cash App order
      description: >-
        Returns a pricing preview for a Cash App order — the destination amount,
        the fee, and the fee in basis points. Every chain is a valid
        `destination_chain`. Read the amount against `destination.token` and
        `destination.decimals` rather than the payout you configured.
      operationId: createCashAppQuote
      requestBody:
        content:
          application/json:
            schema:
              properties:
                amount_usd:
                  pattern: ^\d+(\.\d{1,2})?$
                  type: string
                destination_chain:
                  enum:
                    - 1
                    - 8453
                    - 999
                    - 1337
                    - 4326
                    - 143
                    - 137
                    - 42161
                  type: number
                destination_token:
                  enum:
                    - USDC
                    - USDm
                    - AUSD
                    - USDC.e
                  type: string
              required:
                - amount_usd
                - destination_chain
                - destination_token
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  bps:
                    type: number
                  destination:
                    description: >-
                      The leg Cash App settles. On a chain it cannot reach that
                      is the first hop — Base USDC — and not the buyer's payout,
                      so all four fields describe the same figure. Label the
                      amount with `token` and `chain` rather than the configured
                      payout, which is a different token at a different
                      precision.
                    properties:
                      amount:
                        type: string
                      chain:
                        description: >-
                          Chain id. Currently 1, 8453, 999, 1337, 4326, 143,
                          137, 42161 — additive; tolerate unknown values.
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                      decimals:
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                      token:
                        type: string
                    required:
                      - chain
                      - token
                      - amount
                      - decimals
                    type: object
                  fee:
                    properties:
                      amount:
                        type: string
                      decimals:
                        maximum: 9007199254740991
                        minimum: -9007199254740991
                        type: integer
                    required:
                      - amount
                      - decimals
                    type: object
                  source:
                    properties:
                      amount:
                        type: string
                      currency:
                        type: string
                    required:
                      - currency
                      - amount
                    type: object
                required:
                  - source
                  - destination
                  - fee
                  - bps
                type: object
          description: The Cash App pricing preview.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Bad Request — `error.code` includes: amount_too_large,
            amount_too_small, price_impact_too_high, publishable_key_missing,
            unsupported_chain, unsupported_route, validation_error.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Unauthorized — `error.code` includes: invalid_publishable_key.'
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Forbidden — `error.code` includes: origin_not_allowed.'
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Too Many Requests — `error.code` includes: rate_limited.'
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: 'Bad Gateway — `error.code` includes: coinbase_spot_unavailable.'
      security:
        - publishableKey: []
components:
  schemas:
    Error:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
  securitySchemes:
    publishableKey:
      description: Publishable key identifying the calling app.
      in: header
      name: x-calm-publishable-key
      type: apiKey

````