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

# Orderbook Level 2

> Returns the level 2 orderbook.

---

**Authorization**

- No API key required — this endpoint is public.



## OpenAPI

````yaml get /trade/public/orders/level-2
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:
  /trade/public/orders/level-2:
    get:
      tags:
        - Ripio Trade
      summary: Public - Orderbook Level 2
      description: |-
        Returns the level 2 orderbook.

        ---

        **Authorization**

        - No API key required — this endpoint is public.
      parameters:
        - in: query
          name: pair
          required: true
          description: Currency pair code
          schema:
            example: BTC_BRL
            type: string
        - in: query
          name: limit
          required: false
          description: >-
            Maximum number of records to return per request. Can specify 'max'
            to use the service maximum.
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Ok
                properties:
                  data:
                    properties:
                      timestamp:
                        description: Current timestamp
                        type: number
                        example: 1675708481219
                      asks:
                        description: Sell orders
                        items:
                          properties:
                            amount:
                              description: Amount
                              type: number
                            price:
                              description: Price
                              type: number
                          required:
                            - amount
                            - price
                          type: object
                        type: array
                        example:
                          - amount: 0.01187517
                            price: 14704.45
                          - amount: 1
                            price: 1873.48
                      bids:
                        description: Buy orders
                        items:
                          properties:
                            amount:
                              description: Amount
                              type: number
                            price:
                              description: Price
                              type: number
                          required:
                            - amount
                            - price
                          type: object
                        type: array
                        example:
                          - amount: 0.46097295
                            price: 14650.25
                          - amount: 1
                            price: 1610.15
                      hash:
                        description: Hash of asks and bids
                        type: string
                        example: '16757084812196786445'
                    required:
                      - timestamp
                      - asks
                      - bids
                      - hash
                    type: object
                  error_code:
                    type: number
                    example: null
                  message:
                    type: string
                    example: null
                required:
                  - data
                  - error_code
                  - message
                type: object

````