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

> Returns the level 3 orderbook.

---

**Authorization**

- No API key required — this endpoint is public.



## OpenAPI

````yaml get /trade/public/orders/level-3
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-3:
    get:
      tags:
        - Ripio Trade
      summary: Public - Orderbook Level 3
      description: |-
        Returns the level 3 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
          schema:
            example: 25
            type: number
      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: Currency amount
                              type: number
                            id:
                              description: Order id
                              type: string
                            price:
                              description: Price
                              type: number
                          required:
                            - amount
                            - id
                            - price
                          type: object
                        type: array
                        example:
                          - amount: 0.01187517
                            id: 554F2D70-04B9-4E26-9548-9C35B025A018
                            price: 14704.45
                          - amount: 1
                            id: C1C5DA8E-A069-4E20-87D1-12B19426A013
                            price: 1873.48
                      bids:
                        description: Buy orders
                        items:
                          properties:
                            amount:
                              description: Currency amount
                              type: number
                            id:
                              description: Order id
                              type: string
                            price:
                              description: Price
                              type: number
                          required:
                            - amount
                            - id
                            - price
                          type: object
                        type: array
                        example:
                          - amount: 0.46097295
                            id: E6D05F51-D79B-47CF-84C5-B157120EBC25
                            price: 14650.25
                          - amount: 1
                            id: CE743407-66BE-4F4C-AD0E-AB376468C5F6
                            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

````