curl
curl https://api.arcus.xyz/v1/markets
curl "https://api.arcus.xyz/v1/markets?market=BTC-USD"import requests
r = requests.get(
"https://api.arcus.xyz/v1/markets",
params={"market": "BTC-USD"},
)
print(r.json())
const url = new URL("https://api.arcus.xyz/v1/markets");
url.searchParams.set("market", "BTC-USD");
const res = await fetch(url);
console.log(await res.json());
const options = {method: 'GET'};
fetch('https://api.arcus.xyz/v1/markets', 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://api.arcus.xyz/v1/markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.arcus.xyz/v1/markets"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.arcus.xyz/v1/markets")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arcus.xyz/v1/markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"markets": [
{
"marketDisplayName": "BTC-USD",
"marketId": 32767,
"status": "ONLINE",
"baseAsset": "BTC",
"quoteAsset": "USD",
"tickSize": "<string>",
"stepSize": "<string>",
"tickTiers": [
{
"tick": "<string>",
"upToPrice": "<string>"
}
],
"minOrderNotional": "5",
"minOrderSize": "0.0001",
"maxOrderSize": "10000",
"regularTradingHours": {
"startSecondsOfDay": 123,
"endSecondsOfDay": 123,
"timezone": "America/New_York",
"isOvernight": true
},
"isOutsideRth": true,
"currentSettlementPrice": "<string>",
"upperTradingBound": "<string>",
"lowerTradingBound": "<string>",
"nextUpperTradingBound": "<string>",
"nextLowerTradingBound": "<string>",
"isUpperInExpansionZone": true,
"isLowerInExpansionZone": true,
"upperZoneEnteredAt": 123,
"upperExpectedExpansionAt": 123,
"lowerZoneEnteredAt": 123,
"lowerExpectedExpansionAt": 123,
"markTier": "STANDARD",
"type": "PERPETUAL",
"category": "CRYPTO",
"addedTimestamp": 123,
"baseMakerFeePpm": 123,
"baseTakerFeePpm": 123,
"hasCustomFeeSchedule": true,
"effectiveMakerFeePpm": 123,
"effectiveTakerFeePpm": 123,
"feeTiers": [
{
"level": 123,
"makerFeePpm": 123,
"takerFeePpm": 123
}
],
"fullAssetName": "Bitcoin",
"oraclePrice": "<string>",
"markPrice": "<string>",
"lastTradePrice": "83146.8",
"fundingRate": "<string>",
"nextFundingRate": "<string>",
"nextFundingAt": 123,
"priceChange24h": "<string>",
"volume24h": "<string>",
"volume24hNotional": "<string>",
"high24h": "<string>",
"low24h": "<string>",
"trades24h": 123,
"openInterest": "<string>",
"openInterestCapNotional": "50000000",
"liquidationFeePpm": 10000,
"initialMarginFraction": "<string>",
"maintenanceMarginFraction": "<string>",
"offHoursInitialMarginFraction": "<string>",
"assetResolution": "<string>",
"pythId": "<string>",
"upcomingCorporateActions": [
{
"id": "CA-PMGAFX71TX2HJM3Y",
"sourceId": "ca-01m14cxqtkenq8n0qvdc3rxx2m",
"marketId": 32767,
"marketDisplayName": "BTC-USD",
"type": "SPLIT",
"status": "ANNOUNCED",
"version": 2,
"updatedAt": "2026-11-06T14:00:00Z",
"statusUpdatedAt": "2026-11-06T14:00:00Z",
"exDate": "2026-11-20",
"effectiveTime": "2026-11-20T01:05:00Z",
"ratioNumerator": 8,
"ratioDenominator": 1,
"grossAmount": "0.27",
"netAmount": "0.2295",
"recordDate": "2026-11-13",
"payDate": "2026-11-30"
}
]
}
]
}{
"error": "Invalid request body",
"code": "GEO_RESTRICTED"
}{
"error": "rate limited",
"reason": "account_empty",
"retryAfterMs": 850,
"clientId": "my-order-42"
}Public
Get markets
Returns all markets with details, sorted by ascending marketId. Optionally filter to a single market.
GET
/
v1
/
markets
curl
curl https://api.arcus.xyz/v1/markets
curl "https://api.arcus.xyz/v1/markets?market=BTC-USD"import requests
r = requests.get(
"https://api.arcus.xyz/v1/markets",
params={"market": "BTC-USD"},
)
print(r.json())
const url = new URL("https://api.arcus.xyz/v1/markets");
url.searchParams.set("market", "BTC-USD");
const res = await fetch(url);
console.log(await res.json());
const options = {method: 'GET'};
fetch('https://api.arcus.xyz/v1/markets', 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://api.arcus.xyz/v1/markets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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://api.arcus.xyz/v1/markets"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.arcus.xyz/v1/markets")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arcus.xyz/v1/markets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"markets": [
{
"marketDisplayName": "BTC-USD",
"marketId": 32767,
"status": "ONLINE",
"baseAsset": "BTC",
"quoteAsset": "USD",
"tickSize": "<string>",
"stepSize": "<string>",
"tickTiers": [
{
"tick": "<string>",
"upToPrice": "<string>"
}
],
"minOrderNotional": "5",
"minOrderSize": "0.0001",
"maxOrderSize": "10000",
"regularTradingHours": {
"startSecondsOfDay": 123,
"endSecondsOfDay": 123,
"timezone": "America/New_York",
"isOvernight": true
},
"isOutsideRth": true,
"currentSettlementPrice": "<string>",
"upperTradingBound": "<string>",
"lowerTradingBound": "<string>",
"nextUpperTradingBound": "<string>",
"nextLowerTradingBound": "<string>",
"isUpperInExpansionZone": true,
"isLowerInExpansionZone": true,
"upperZoneEnteredAt": 123,
"upperExpectedExpansionAt": 123,
"lowerZoneEnteredAt": 123,
"lowerExpectedExpansionAt": 123,
"markTier": "STANDARD",
"type": "PERPETUAL",
"category": "CRYPTO",
"addedTimestamp": 123,
"baseMakerFeePpm": 123,
"baseTakerFeePpm": 123,
"hasCustomFeeSchedule": true,
"effectiveMakerFeePpm": 123,
"effectiveTakerFeePpm": 123,
"feeTiers": [
{
"level": 123,
"makerFeePpm": 123,
"takerFeePpm": 123
}
],
"fullAssetName": "Bitcoin",
"oraclePrice": "<string>",
"markPrice": "<string>",
"lastTradePrice": "83146.8",
"fundingRate": "<string>",
"nextFundingRate": "<string>",
"nextFundingAt": 123,
"priceChange24h": "<string>",
"volume24h": "<string>",
"volume24hNotional": "<string>",
"high24h": "<string>",
"low24h": "<string>",
"trades24h": 123,
"openInterest": "<string>",
"openInterestCapNotional": "50000000",
"liquidationFeePpm": 10000,
"initialMarginFraction": "<string>",
"maintenanceMarginFraction": "<string>",
"offHoursInitialMarginFraction": "<string>",
"assetResolution": "<string>",
"pythId": "<string>",
"upcomingCorporateActions": [
{
"id": "CA-PMGAFX71TX2HJM3Y",
"sourceId": "ca-01m14cxqtkenq8n0qvdc3rxx2m",
"marketId": 32767,
"marketDisplayName": "BTC-USD",
"type": "SPLIT",
"status": "ANNOUNCED",
"version": 2,
"updatedAt": "2026-11-06T14:00:00Z",
"statusUpdatedAt": "2026-11-06T14:00:00Z",
"exDate": "2026-11-20",
"effectiveTime": "2026-11-20T01:05:00Z",
"ratioNumerator": 8,
"ratioDenominator": 1,
"grossAmount": "0.27",
"netAmount": "0.2295",
"recordDate": "2026-11-13",
"payDate": "2026-11-30"
}
]
}
]
}{
"error": "Invalid request body",
"code": "GEO_RESTRICTED"
}{
"error": "rate limited",
"reason": "account_empty",
"retryAfterMs": 850,
"clientId": "my-order-42"
}The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
marketId. Optionally filter to a single market.Query Parameters
Was this page helpful?