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

# Get CoinGecko contracts

`GET /coingecko/contracts`

## Request

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

Contract summaries for all tradeable perpetual markets, in the field layout required by CoinGecko's derivatives integration spec (Section B, /contracts combined with /contract_specs).

## Response `200`

A successful response.

- ApiGetCoingeckoContractsResponse: Response for GetCoingeckoContracts - contract summaries in CoinGecko's field layout. Field names and units follow CoinGecko's derivatives spec; all numeric values are decimal strings. Optional spec fields (start_timestamp, end_timestamp, contract_price) are omitted: the first two are not applicable to perpetuals and contract_price only applies when it differs from last_price, which it does not for vanilla contracts.
  - `contracts` GetCoingeckoContractsResponseCoingeckoContract[]
    - `ticker_id` string: Market identifier, e.g. "BTC/USDC".
    - `base_currency` string: Base asset symbol only, e.g. "BTC".
    - `target_currency` string: Quote asset symbol, e.g. "USDC".
    - `last_price` string: Last traded price.
    - `base_volume` string: 24h traded volume in base units.
    - `target_volume` string: 24h traded volume in quote units.
    - `bid` string: Highest bid price.
    - `ask` string: Lowest ask price.
    - `high` string: Rolling 24h high.
    - `low` string: Rolling 24h low.
    - `product_type` string: Product type, always "perpetual".
    - `open_interest` string: Open interest in base units, double-sided (longs + shorts).
    - `open_interest_usd` string: Open interest in USD (open_interest x mark price).
    - `index_price` string: Underlying index price.
    - `index_name` string: Underlying index name, e.g. "BTC Index".
    - `index_currency` string: Currency the index is quoted in.
    - `funding_rate` string: Current funding rate.
    - `next_funding_rate` string: Predicted next funding rate.
    - `next_funding_rate_timestamp` integer: Next funding settlement time (Unix seconds). uint32, not int64, so protojson renders it as a JSON number — 64-bit integers are emitted as strings, which the CoinGecko spec does not allow for this field.
    - `contract_type` string: Contract type, always "vanilla".
    - `contract_price_currency` string: Currency the contract is priced in.

## 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/contracts/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)