---
title: "Get Contracts"
method: GET
path: "/v1/perps/contracts"
tags: ["Market Data"]
---

# Get Contracts

`GET /v1/perps/contracts`

Gets a list of perpetual futures contracts and their current market data. For the list of supported markets, see [Markets](/markets).

## Query parameters

- `sparkline` boolean

## Response `200`

List of perpetual futures contracts

- object
  - `success` boolean, required — Whether the request was successful
  - `error` string — Error message, present only on failure
  - `error_code` string — Semantic error code. See each endpoint's error responses for the specific codes it can return.
  - `deprecated` string — Deprecation notice, if applicable
  - `result` Contract[]
    - `market` string, required — Perps market identifier
    - `displayName` string — Human-readable display name for the contract
    - `productType` string, required — Type of product
    - `contractType` string, required — Type of contract
    - `baseCurrency` string, required — The base currency of the contract
    - `quoteCurrency` string, required — The quote currency of the contract
    - `disabled` boolean, required — If true, the market is currently unavailable for trading
    - `lastPrice` string — Price of the last trade
    - `baseVolume` string — 24-hour trading volume in base currency
    - `quoteVolume` string — 24-hour trading volume in quote currency
    - `usdVolume` string — 24-hour trading volume in USD
    - `bid` string — Current best bid price
    - `ask` string — Current best ask price
    - `high` string — Highest traded price in the last 24 hours
    - `low` string — Lowest traded price in the last 24 hours
    - `openInterest` string — Open interest in base currency
    - `openInterestUsd` string — Open interest in USD
    - `indexPrice` string — Current price of the underlying market
    - `indexCurrency` string — Currency of the underlying market
    - `fundingRate` string — Funding rate at the last completed funding interval
    - `nextFundingRate` string — Estimated funding rate at the end of the current funding interval
    - `nextFundingRateTimestamp` string, date-time — Timestamp when the next funding payments will occur
    - `makerFee` string — Fee on a filled resting (maker) order
    - `takerFee` string — Fee on a filled aggressive (taker) order
    - `priceChangePercent` string — Price change as a percentage in the last 24 hours
    - `isClosed` boolean — If true, the underlying market is currently closed (e.g. outside trading hours for equities)
    - `sparkline` Sparkline
      - `price` string[] — Array of price values for the sparkline
    - `tags` string[] — Optional tags describing the contract (e.g. category labels)

## Other responses

- `400` — Bad request. The request was malformed or failed validation.
- `429` — Rate limit exceeded. Slow down request frequency.
- `500` — Internal server error.

---

[API](https://skmtc.net/ondoperps/apis/ondo-perps-rest-api.md) · [All operations](https://skmtc.net/ondoperps/apis/ondo-perps-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ondoperps/ondo-perps-rest-api/revisions/39df6b2fa672/schema)
