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

# Withdraw Stablecoin

> Withdraw funds as a stablecoin to a specified address. All withdrawal requests require approved KYC.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/ramp/{subaccountId}/banking/withdrawals/stablecoin
openapi: 3.0.0
info:
  title: Bullring Finance API
  description: >-
    The Bullring Finance API allows you to build powerful cross-border payment
    solutions.
  version: 1.0.0
servers:
  - url: https://api.bullring.finance
    description: Production Server
  - url: https://staging-api.bullring.finance
    description: Sandbox Server
security:
  - x-api-key: []
tags:
  - name: Subaccounts
    description: Operations related to user subaccounts.
  - name: Verification
    description: Endpoints for subaccount verification, including KYC and KYB processes.
  - name: Balances
    description: Endpoints for retrieving account balances.
  - name: Deposits
    description: Endpoints for handling deposits into subaccounts.
  - name: Recipients
    description: Manage payment recipients for withdrawals.
  - name: Withdrawals
    description: Endpoints for handling withdrawals from subaccounts.
  - name: Conversions
    description: Endpoints for currency conversions.
  - name: Rates
    description: Endpoints for currency conversion rates.
  - name: Fees
    description: Endpoints for checking transaction fees.
  - name: Offramp
    description: Endpoints for handling offramp operations.
  - name: Onramp
    description: Endpoints for handling onramp operations.
paths:
  /v1/ramp/{subaccountId}/banking/withdrawals/stablecoin:
    post:
      tags:
        - Withdrawals
      summary: Withdraw Stablecoin
      description: >-
        Withdraw funds as a stablecoin to a specified address. All withdrawal
        requests require approved KYC.
      parameters:
        - name: subaccountId
          in: path
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                amount:
                  type: string
                stablecoin:
                  type: string
                  enum:
                    - usdt
                    - usdc
                  description: usdt or usdc
                chain:
                  type: string
                  enum:
                    - ethereum
                    - polygon
                    - solana
                    - stellar
                    - tron
                    - celo
                  description: ethereum, polygon, solana, stellar, tron, or celo
                address:
                  type: string
                balance_account:
                  type: string
                  description: >-
                    The balance account to withdraw from. Use USDCARD to
                    withdraw from the card collection balance. If omitted,
                    defaults to the standard USD balance.
                  enum:
                    - USDCARD
                client_reference:
                  type: string
                  format: uuid
                  description: >-
                    Optional unique identifier (UUID) for the withdrawal, used
                    for idempotency and reconciliation. If not provided, a
                    random UUID will be generated by the system.
              required:
                - amount
                - stablecoin
                - chain
                - address
            examples:
              Standard Withdrawal:
                summary: Standard stablecoin withdrawal
                value:
                  amount: '12'
                  stablecoin: usdt
                  chain: ethereum
                  address: '0x22ccb74a200d7b8094b72482edd46e23cbf3af37'
              Card Collection Balance:
                summary: Withdraw from card collection (USDCARD) balance
                value:
                  amount: '50'
                  stablecoin: usdc
                  chain: celo
                  address: '0x22ccb74a200d7b8094b72482edd46e23cbf3af37'
                  balance_account: USDCARD
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  amount:
                    type: string
                  currency:
                    type: string
                  status:
                    type: string
                  created_at:
                    type: string
                    format: date-time
                  protocol:
                    type: string
                  client_reference:
                    type: string
                    format: uuid
                  fee_amount:
                    type: number
                  fee_currency:
                    type: string
                  chain:
                    type: string
                  destination_address:
                    type: string
                  local_amount:
                    type: string
                  local_currency:
                    type: string
                  tx_hash:
                    type: string
                    nullable: true
                  gross_amount:
                    type: number
                  net_amount:
                    type: number
                    description: The net amount after fees
                  rate:
                    type: number
              example:
                id: 08936301-4656-493d-9394-0e2320cf75d1
                amount: '12'
                currency: USDT
                status: pending
                created_at: '2025-11-20T08:53:56.636Z'
                client_reference: 123e4567-e89b-12d3-a456-426614174000
                protocol: erc20
                fee_amount: 1.08
                fee_currency: USD
                chain: ETH
                destination_address: 0x***37
                local_amount: '12'
                local_currency: usdt
                tx_hash: null
                gross_amount: 13.08
                rate: 1
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                  timestamp:
                    type: string
                    format: date-time
                  path:
                    type: string
                  error:
                    type: string
                  message:
                    type: string
                  stack:
                    type: string
                required:
                  - statusCode
                  - timestamp
                  - path
                  - error
                  - message
              examples:
                InsufficientFunds:
                  summary: Insufficient Funds
                  value:
                    statusCode: 400
                    timestamp: '2025-11-20T20:37:49.137Z'
                    error: Error
                    message: 'Insufficient balance: have 0 USD, need 13.08 USD'
                InvalidAddress:
                  summary: Invalid Address
                  value:
                    statusCode: 400
                    timestamp: '2025-11-20T20:52:37.185Z'
                    error: Bad Request
                    message: Invalid blockchain address format
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Unauthorized
                message: Invalid or missing API key
        '403':
          description: Forbidden - Insufficient permissions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Forbidden
                message: You do not have permission to access this resource
        '404':
          description: Not Found - Subaccount not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  message:
                    type: string
              example:
                error: Not Found
                message: Subaccount not found
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````