List Instruments - Darknyx

List all tradable instruments.

curl --request GET \
  --url https://api.darknyx.example.com/instruments

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/instruments",
  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.darknyx.example.com/instruments"

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

	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://api.darknyx.example.com/instruments")

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

[
  {
    "symbol": "SOL-USDC",
    "base_mint": "<string>",
    "quote_mint": "<string>",
    "tick_size": "<string>",
    "min_order_size": "<string>",
    "trading_enabled": true,
    "oracle": {
      "type": "pyth_pull_v2",
      "pubkey": "<string>",
      "source": "pyth-router-quorum-v1",
      "publish_time_ms": 123,
      "age_ms": 123,
      "max_age_ms": 123,
      "account": "<string>"
    }
  }
]

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}

Returns every market this engine is configured to trade. Use it at startup to discover symbols and their integer scaling before submitting any order.

See also

Response

All markets.

symbol

string

required

Canonical symbol signed into an order and used for book routing.

Example:

"SOL-USDC"

base_mint

string

required

Base SPL mint pubkey (base58).

quote_mint

string

required

Quote SPL mint pubkey (base58).

tick_size

string

required

Raw integer price increment in protocol price units.

min_order_size

string

required

Raw integer minimum amount in the base mint's smallest units.

trading_enabled

boolean

required

Current fail-closed readiness for new placement, modification, and matching on this market. A false value does not block cancellation, reads, or settlement reconciliation. Clients must still handle a racing 503 from an order write.

oracle

object

required

Show child attributes

⌘I

List all tradable instruments.

curl --request GET \
  --url https://api.darknyx.example.com/instruments

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.darknyx.example.com/instruments",
  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.darknyx.example.com/instruments"

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

	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://api.darknyx.example.com/instruments")

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

[
  {
    "symbol": "SOL-USDC",
    "base_mint": "<string>",
    "quote_mint": "<string>",
    "tick_size": "<string>",
    "min_order_size": "<string>",
    "trading_enabled": true,
    "oracle": {
      "type": "pyth_pull_v2",
      "pubkey": "<string>",
      "source": "pyth-router-quorum-v1",
      "publish_time_ms": 123,
      "age_ms": 123,
      "max_age_ms": 123,
      "account": "<string>"
    }
  }
]

{
  "code": 1102,
  "message": "trading_key_signature does not verify against the canonical body"
}