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

# Get Transaction Limits

> Returns the transaction limits for the authenticated user, grouped by rail.

Each entry represents a rail (`bank`, `pix`, `crypto`, `ripio`, or `null` for the account-wide global limit) with its allowed transaction types (`deposit`, `withdrawal`, `swap`) and the corresponding per-currency limits and remaining amounts for the current period. `swap` lives under `rail: "ripio"` (RN-003); `rail: null` is exclusively the account-wide global limit (RN-009). An unlimited period is returned as `null` (never the internal `-1`); `currency` is never `null` (fiat of the user, or USDT for swap).

---

**Authorization**

- Requires a valid API key.



## OpenAPI

````yaml get /wallet/transactions/limits/
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /wallet/transactions/limits/:
    get:
      tags:
        - Ripio Wallet
      summary: transactions - Get transaction limits
      description: >-
        Returns the transaction limits for the authenticated user, grouped by
        rail.


        Each entry represents a rail (`bank`, `pix`, `crypto`, `ripio`, or
        `null` for the account-wide global limit) with its allowed transaction
        types (`deposit`, `withdrawal`, `swap`) and the corresponding
        per-currency limits and remaining amounts for the current period. `swap`
        lives under `rail: "ripio"` (RN-003); `rail: null` is exclusively the
        account-wide global limit (RN-009). An unlimited period is returned as
        `null` (never the internal `-1`); `currency` is never `null` (fiat of
        the user, or USDT for swap).


        ---


        **Authorization**


        - Requires a valid API key.
      parameters:
        - in: query
          name: rail
          required: false
          description: >-
            Filter limits by rail. `ripio` includes `swap` (RN-003). The
            account-wide global limit has `rail=null` and is excluded when this
            filter is set. If omitted, limits for all rails are returned
            (including the `rail=null` global entry).
          schema:
            example: bank
            type: string
        - in: query
          name: transaction_type
          required: false
          description: >-
            Filter limits by transaction type. Unlike `rail`, this also matches
            the `rail=null` global limit when its underlying action corresponds
            to the requested type. If omitted, limits for all types are
            returned.
          schema:
            example: deposit
            type: string
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Transaction limits retrieved successfully.
                properties:
                  error_code:
                    type: string
                    example: null
                  message:
                    type: string
                    example: null
                  data:
                    items:
                      description: >-
                        Transaction limits grouped by rail. `swap` lives under
                        `rail: "ripio"` (RN-003). `rail` is `null` exclusively
                        for the account-wide global limit (RN-009).
                      properties:
                        rail:
                          description: >-
                            Canonical rail identifier. `swap` is under `ripio`.
                            `null` means the account-wide global limit (RN-009).
                          type: string
                          example: bank
                        transaction_types:
                          items:
                            description: >-
                              Limit definition for a specific transaction type
                              and currency within a rail.
                            properties:
                              transaction_type:
                                description: Public transaction type this limit applies to.
                                type: string
                                example: deposit
                              currency:
                                description: >-
                                  Currency code (ISO 4217 or crypto ticker).
                                  Never `null`: for non-swap limits it is
                                  backfilled with the user's fiat currency; for
                                  `swap` it is the display currency (USDT in
                                  AR/BR), since swap amounts are stored in USD
                                  (RN-NEW-2).
                                type: string
                                example: ARS
                              currency_balance_id:
                                description: Internal Ripio currency balance ID.
                                type: integer
                                example: 2
                              limits:
                                description: >-
                                  Absolute limit amounts for a given period. Any
                                  field is `null` when unlimited or absent (the
                                  internal sentinel `-1` is never surfaced).
                                properties:
                                  min_amount:
                                    description: >-
                                      Minimum transaction amount, or `null` if
                                      there is no minimum.
                                    type: number
                                    example: 100
                                  max_amount:
                                    description: >-
                                      Maximum single transaction amount, or
                                      `null` if unlimited.
                                    type: number
                                    example: 500000
                                  daily_amount:
                                    description: >-
                                      Maximum total amount per day, or `null` if
                                      unlimited.
                                    type: number
                                    example: 500000
                                  daily_qty:
                                    description: >-
                                      Maximum number of transactions per day, or
                                      `null` if unlimited.
                                    type: number
                                    example: 5
                                  monthly_amount:
                                    description: >-
                                      Maximum total amount per month, or `null`
                                      if unlimited.
                                    type: number
                                    example: 2000000
                                  monthly_qty:
                                    description: >-
                                      Maximum number of transactions per month,
                                      or `null` if unlimited.
                                    type: number
                                    example: 30
                                  annual_amount:
                                    description: >-
                                      Maximum total amount per year, or `null`
                                      if unlimited.
                                    type: number
                                    example: 10000000
                                  annual_qty:
                                    description: >-
                                      Maximum number of transactions per year,
                                      or `null` if unlimited.
                                    type: number
                                    example: 365
                                type: object
                              remaining:
                                description: >-
                                  Remaining allowance for the current period
                                  (daily, monthly, annual). A field is `null`
                                  when the corresponding period limit is
                                  unlimited. A negative value is legitimate (the
                                  user consumed more than the limit) and is NOT
                                  nulled — null tracks an unlimited limit, not a
                                  negative remaining.
                                properties:
                                  daily_amount:
                                    description: >-
                                      Remaining amount for today, or `null` if
                                      the daily limit is unlimited.
                                    type: number
                                    example: 450000
                                  daily_qty:
                                    description: >-
                                      Remaining transaction count for today, or
                                      `null` if the daily qty limit is
                                      unlimited.
                                    type: number
                                    example: 4
                                  monthly_amount:
                                    description: >-
                                      Remaining amount this month, or `null` if
                                      the monthly limit is unlimited.
                                    type: number
                                    example: 1500000
                                  monthly_qty:
                                    description: >-
                                      Remaining transaction count this month, or
                                      `null` if the monthly qty limit is
                                      unlimited.
                                    type: number
                                    example: 28
                                  annual_amount:
                                    description: >-
                                      Remaining amount this year, or `null` if
                                      the annual limit is unlimited.
                                    type: number
                                    example: 9000000
                                  annual_qty:
                                    description: >-
                                      Remaining transaction count this year, or
                                      `null` if the annual qty limit is
                                      unlimited.
                                    type: number
                                    example: 362
                                type: object
                            required:
                              - transaction_type
                              - currency
                              - currency_balance_id
                              - limits
                              - remaining
                            type: object
                          type: array
                      required:
                        - rail
                        - transaction_types
                      type: object
                    type: array
                required:
                  - error_code
                  - message
                  - data
                type: object
                example:
                  error_code: null
                  message: null
                  data:
                    - rail: bank
                      transaction_types:
                        - transaction_type: deposit
                          currency: ARS
                          currency_balance_id: 2
                          limits:
                            min_amount: 100
                            max_amount: 500000
                            daily_amount: 500000
                            daily_qty: 5
                            monthly_amount: 2000000
                            monthly_qty: 30
                            annual_amount: 10000000
                            annual_qty: 365
                          remaining:
                            daily_amount: 450000
                            daily_qty: 4
                            monthly_amount: 1500000
                            monthly_qty: 28
                            annual_amount: 9000000
                            annual_qty: 362
                    - rail: ripio
                      transaction_types:
                        - transaction_type: swap
                          currency: USDT
                          currency_balance_id: 12
                          limits:
                            min_amount: 10
                            max_amount: 50000
                            daily_amount: 50000
                            daily_qty: 5
                            monthly_amount: 200000
                            monthly_qty: 30
                            annual_amount: 1000000
                            annual_qty: 365
                          remaining:
                            daily_amount: 45000
                            daily_qty: 4
                            monthly_amount: 150000
                            monthly_qty: 28
                            annual_amount: 900000
                            annual_qty: 362
                    - rail: null
                      transaction_types:
                        - transaction_type: withdrawal
                          currency: ARS
                          currency_balance_id: 2
                          limits:
                            min_amount: 100
                            max_amount: 500000
                            daily_amount: 500000
                            daily_qty: 5
                            monthly_amount: 2000000
                            monthly_qty: 30
                            annual_amount: 10000000
                            annual_qty: 365
                          remaining:
                            daily_amount: 450000
                            daily_qty: 4
                            monthly_amount: 1500000
                            monthly_qty: 28
                            annual_amount: 9000000
                            annual_qty: 362
        '401':
          description: Error response 401
        '403':
          description: Error response 403

````