---
title: "Get CoinGecko orderbook"
method: GET
path: "/coingecko/orderbook"
tags: ["CoinGecko"]
---

# Get CoinGecko orderbook

`GET /coingecko/orderbook`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/coingecko/orderbook`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/coingecko/orderbook/get.ts> (a function with typed inputs; its response is checked against the schema)

Orderbook depth for one market as [price, quantity] pairs, in the field layout required by CoinGecko's derivatives integration spec (Section B, /orderbook).

## Query parameters

- `ticker_id` string, required
- `depth` integer

## Response `200`

A successful response.

- ApiGetCoingeckoOrderbookResponse: Response for GetCoingeckoOrderbook - bids/asks as [price, quantity] pairs.
  - `ticker_id` string: Market identifier echoed from the request.
  - `timestamp` string: Time the book was read (Unix milliseconds, as a string).
  - `bids` array[]: Bid levels as [price, quantity] pairs, highest price first.
    - object[]
  - `asks` array[]: Ask levels as [price, quantity] pairs, lowest price first.
    - object[]

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/coingecko/orderbook/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)