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

# Wallets

> Read wallet balances and available deposit addresses.

Returns all wallets belonging to your organization's account. Balances are decimal strings. This endpoint does not use pagination.

## Read one wallet

Use `GET /v3/wallets/{currency}` to read a wallet and its available deposit addresses. Replace `{currency}` with a currency code, such as `USD`, `USDC`, or `USDT`.

```bash theme={null}
curl "https://api.sarafa.site/v3/wallets/USD" \
  -H "Authorization: Bearer $SARAFA_API_KEY"
```

Example response for a USD wallet:

```json theme={null}
{
  "status": "success",
  "wallet": {
    "currency": "USD",
    "kind": "fiat",
    "available_balance": "250",
    "status": "active",
    "deposit_addresses": []
  }
}
```

For supported stablecoin wallets, each deposit address entry contains `network`, `status`, and `address`. The address is `null` when its assignment is unverified or monitoring is not active. Reading a wallet does not provision an address. A wallet absent from your account returns HTTP `404`.

See [transaction history](https://docs.sarafa.ss/api-reference/endpoint/getTransactions.md) to read activity for one wallet.


## OpenAPI

````yaml api-reference/openapi.json GET /wallets
openapi: 3.0.3
info:
  title: Sarafa Business API
  version: 3.0.0
  description: >-
    Server-side access to your verified organization's account. Use Bearer API
    keys, decimal-string amounts, and unique merchant references. Charge,
    transfer, and swap default to quotes. Only transaction.status = completed
    confirms payment.
servers:
  - url: https://api.sarafa.site/v3
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Transactions
  - name: Payments
  - name: Checkout
paths:
  /wallets:
    get:
      tags:
        - Accounts
      summary: List wallets
      description: All wallets for your organization. No pagination.
      operationId: listWallets
      responses:
        '200':
          description: Wallet balances.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - wallets
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  wallets:
                    type: array
                    items:
                      $ref: '#/components/schemas/Wallet'
              example:
                status: success
                wallets:
                  - currency: USD
                    kind: fiat
                    available_balance: '250'
                    status: active
        '401':
          $ref: '#/components/responses/Error401'
        '403':
          $ref: '#/components/responses/Error403'
        '404':
          $ref: '#/components/responses/Error404'
        '500':
          $ref: '#/components/responses/Error500'
        '503':
          $ref: '#/components/responses/Error503'
components:
  headers:
    RequestId:
      description: Include this request identifier when contacting support.
      schema:
        type: string
  schemas:
    Wallet:
      type: object
      required:
        - currency
        - kind
        - available_balance
        - status
      properties:
        currency:
          type: string
        kind:
          type: string
          enum:
            - fiat
            - stablecoins
        available_balance:
          type: string
          description: Decimal string.
        status:
          type: string
          enum:
            - active
            - inactive
            - suspended
    Error:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - failed
        error:
          type: string
        request_id:
          type: string
          description: >-
            Present on processing errors. Every response also includes
            X-Request-Id.
        issues:
          type: array
          items:
            type: object
            required:
              - path
              - message
            properties:
              path:
                type: array
                items:
                  oneOf:
                    - type: string
                    - type: integer
              message:
                type: string
  responses:
    Error401:
      description: Missing, invalid, inactive, or revoked API key.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error403:
      description: Required verification or authorization missing.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error404:
      description: Resource not found within your organization.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error500:
      description: >-
        Processing failure. Retry uncertain executions with the same reference
        and unchanged payload.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Error503:
      description: >-
        Service failure. Retry uncertain executions with the same reference and
        unchanged payload.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sfb_live_<public_identifier>.<secret>
      description: >-
        Use the full key from the merchant dashboard API section. Keep it on
        your server.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.