Get a market

Get market by ID

curl --request GET \
  --url https://perps.yield.xyz/v1/markets/{marketId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://perps.yield.xyz/v1/markets/{marketId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://perps.yield.xyz/v1/markets/{marketId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://perps.yield.xyz/v1/markets/{marketId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://perps.yield.xyz/v1/markets/{marketId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "hyperliquid-eth-usdc",
  "providerId": "hyperliquid",
  "baseAsset": {
    "symbol": "ETH",
    "network": "hyperliquid",
    "name": "Ethereum",
    "decimals": 6,
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logoURI": "<string>"
  },
  "quoteAsset": {
    "symbol": "ETH",
    "network": "hyperliquid",
    "name": "Ethereum",
    "decimals": 6,
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logoURI": "<string>"
  },
  "leverageRange": [
    1,
    50
  ],
  "supportedMarginModes": [
    "isolated"
  ],
  "markPrice": 123,
  "oraclePrice": 123,
  "priceChange24h": -1.233,
  "priceChangePercent24h": -5.01,
  "volume24h": 123,
  "openInterest": 123,
  "fundingRate": "0.00012",
  "fundingRateIntervalHours": 8,
  "minSize": 10.22,
  "metadata": {
    "name": "ETH-USDC Perpetual",
    "logoURI": "<string>",
    "url": "<string>"
  },
  "chartConfig": {
    "pricescale": 100,
    "minmov": 1,
    "supportedResolutions": [
      "1",
      "5",
      "15",
      "60",
      "240",
      "1D"
    ],
    "hasIntraday": true,
    "hasDaily": true
  },
  "makerFee": "0.0002",
  "takerFee": "0.0004"
}

{
  "statusCode": 401,
  "timestamp": "2026-05-04T12:00:00.000Z",
  "path": "/v1/actions",
  "message": "Invalid API key",
  "details": {
    "message": "Invalid API key",
    "code": "AUTH_INVALID_API_KEY"
  }
}

{
  "statusCode": 429,
  "timestamp": "2026-05-04T12:00:00.000Z",
  "path": "/v1/actions",
  "message": "Rate limit exceeded",
  "details": {
    "message": "Rate limit exceeded",
    "code": "RATE_LIMIT_EXCEEDED",
    "error": "Too Many Requests",
    "retryAfter": 30
  }
}

GET

markets

{marketId}

Get market by ID

curl --request GET \
  --url https://perps.yield.xyz/v1/markets/{marketId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://perps.yield.xyz/v1/markets/{marketId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://perps.yield.xyz/v1/markets/{marketId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://perps.yield.xyz/v1/markets/{marketId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://perps.yield.xyz/v1/markets/{marketId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "hyperliquid-eth-usdc",
  "providerId": "hyperliquid",
  "baseAsset": {
    "symbol": "ETH",
    "network": "hyperliquid",
    "name": "Ethereum",
    "decimals": 6,
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logoURI": "<string>"
  },
  "quoteAsset": {
    "symbol": "ETH",
    "network": "hyperliquid",
    "name": "Ethereum",
    "decimals": 6,
    "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "logoURI": "<string>"
  },
  "leverageRange": [
    1,
    50
  ],
  "supportedMarginModes": [
    "isolated"
  ],
  "markPrice": 123,
  "oraclePrice": 123,
  "priceChange24h": -1.233,
  "priceChangePercent24h": -5.01,
  "volume24h": 123,
  "openInterest": 123,
  "fundingRate": "0.00012",
  "fundingRateIntervalHours": 8,
  "minSize": 10.22,
  "metadata": {
    "name": "ETH-USDC Perpetual",
    "logoURI": "<string>",
    "url": "<string>"
  },
  "chartConfig": {
    "pricescale": 100,
    "minmov": 1,
    "supportedResolutions": [
      "1",
      "5",
      "15",
      "60",
      "240",
      "1D"
    ],
    "hasIntraday": true,
    "hasDaily": true
  },
  "makerFee": "0.0002",
  "takerFee": "0.0004"
}

{
  "statusCode": 401,
  "timestamp": "2026-05-04T12:00:00.000Z",
  "path": "/v1/actions",
  "message": "Invalid API key",
  "details": {
    "message": "Invalid API key",
    "code": "AUTH_INVALID_API_KEY"
  }
}

{
  "statusCode": 429,
  "timestamp": "2026-05-04T12:00:00.000Z",
  "path": "/v1/actions",
  "message": "Rate limit exceeded",
  "details": {
    "message": "Rate limit exceeded",
    "code": "RATE_LIMIT_EXCEEDED",
    "error": "Too Many Requests",
    "retryAfter": 30
  }
}

Returns the same fields as one entry of List markets, plus chartConfig (price scale, supported resolutions, intraday and daily flags). An unknown marketId returns 404.

Authorizations

x-api-key

string

header

required

Path Parameters

marketId

string

required

The market identifier

Example:

"hyperliquid-btc-usdc"

Response

Market details with chart config

string

required

Market ID

Example:

"hyperliquid-eth-usdc"

providerId

string

required

Provider ID

Example:

"hyperliquid"

baseAsset

object

required

Base asset information

Show child attributes

quoteAsset

object

required

Quote asset information

Show child attributes

leverageRange

number[]

required

Leverage range [min, max]

Example:

[1, 50]

supportedMarginModes

enum<string>[]

required

Supported margin modes

Available options:

isolated,

cross

markPrice

number

required

Current mark price

oraclePrice

number

required

Oracle/index price

priceChange24h

number

required

Absolute price change in 24h

Example:

-1.233

priceChangePercent24h

number

required

Percentage price change in 24h

Example:

-5.01

volume24h

number

required

24h trading volume in quote asset (e.g., USDC)

openInterest

number

required

Open interest in base asset units (e.g., number of ETH coins, not USD notional)

fundingRate

string

required

Current funding rate

Example:

"0.00012"

fundingRateIntervalHours

number

required

Funding rate interval in hours

Example:

8

minSize

number

required

Minimum position size in USD (notional) computed at the current mark price. Typically prevents rejection for being below the $10 minimum, but actual executed notional may differ due to limit/market slippage or price quantization.

Example:

10.22

metadata

object

required

Market metadata

Show child attributes

chartConfig

object

required

Chart display configuration

Show child attributes

makerFee

string

Maker fee rate

Example:

"0.0002"

takerFee

string

Taker fee rate

Example:

"0.0004"

⌘I

Getting started

Earn

Trade

Borrow

Authorizations

Path Parameters

Response