/markets REST API Endpoint - Metis

Please note that this method is only available for Paid subscribers of Metis - Jupiter V6 Swap API.

Solana Kit includes the ability to customize RPC methods and transports, allowing you to seamlessly integrate QuickNode Marketplace add-ons into your applications. For more information on how to use QuickNode Marketplace add-ons with Solana Kit, check out these guides: How to Use QuickNode Add-ons using Solana Kit (Part 1) and How to Use QuickNode Add-ons using Solana Kit (Part 2)

Important: Always use the parameter useQNMarketCache=true when working with new markets.

To use this method an example pool address can be found by using the /new-pools endpoint, or by going to Gecko Terminal → new pools (solana) → pool address.

When you add new markets that aren't available in the standard Jupiter market cache, you'll need to pass the useQNMarketCache=true parameter to the URL you're making subsequent /quote, /swap, or /swap-instructions requests with. If you are using websockets for /swap, you'll need to include the param "useQNMarketCache": true to use the market cache.

The steps below are an example for when adding new markets, receiving a quote, and swapping the newly added market.

Use the POST /markets API endpoint to add a new market.
Use the GET /quote API endpoint and include useQNMarketCache=true parameter. i.e /quote?useQNMarketCache=true
Use either POST /swap or POST /swap-instructions and include useQNMarketCache=true parameter when fetching a swap for the quote you just requested. i.e /swap?useQNMarketCache=true
- For websockets, you'll still use the swap method, but include the param "useQNMarketCache": true

Body Parameters

poolAddress

string

REQUIRED

Returns

data

string

executable

boolean

lamports

integer

owner

string

rentEpoch

integer

pubkey

string

params

object

serumBids

string

serumAsks

string

serumEventQueue

string

serumCoinVaultAccount

string

serumPcVaultAccount

string

serumVaultSigner

string

status

string

Request

curl --location 'https://docs-demo.solana-mainnet.quiknode.pro/markets' \
--header 'Content-Type: application/json' \
--data '{
    "poolAddress": "5y2QYKY8gQCcmG6jy4fc7wFg8L5SW7bkyvMH3jUTqBdy"
}'

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.solana-mainnet.quiknode.pro/markets")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "poolAddress": "5y2QYKY8gQCcmG6jy4fc7wFg8L5SW7bkyvMH3jUTqBdy"
})

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

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

const raw = JSON.stringify({
  "poolAddress": "5y2QYKY8gQCcmG6jy4fc7wFg8L5SW7bkyvMH3jUTqBdy"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://docs-demo.solana-mainnet.quiknode.pro/markets", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::builder()
        .build()?;

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("Content-Type", "application/json".parse()?);

    let data = r#"{
    "poolAddress": "5y2QYKY8gQCcmG6jy4fc7wFg8L5SW7bkyvMH3jUTqBdy"
}"#;

    let json: serde_json::Value = serde_json::from_str(&data)?;

    let request = client.request(reqwest::Method::POST, "https://docs-demo.solana-mainnet.quiknode.pro/markets")
        .headers(headers)
        .json(&json);

    let response = request.send().await?;
    let body = response.text().await?;

    println!("{}", body);

    Ok(())
}

Response

{
  "data": "AQAAAByn50UHsH7bOtxmON+/+KGKcMTF4zJJPV5GJnE+GUUCAAAAAwABAAAAAQAAAAEAAAAXAAAAAQAAAAAAAAAAAAAAAgAAAAEAAAAAAAAA/wAAAAAAAAACjjoP0Kkp15eiQw1hZ9UHV5dmx3pv5dSEPkOLYGbcAgAAABcAAAA/AAAAPwAAAAUAAAABAAAAAgAAAAMAAAAEAAAABQAAAAIAAABbAQAABAAAAF0CAABkAAAAAAAAANFGQu8S37KyJk2ThwAAAAA=",
  "executable": false,
  "lamports": 13755795180,
  "owner": "srmqPvymJeFKQ4zGQed1GFppgkRHL9kaELCERh8Sech",
  "rentEpoch": 361,
  "pubkey": "5y2QYKY8gQCcmG6jy4fc7wFg8L5SW7bkyvMH3jUTqBdy",
  "params": {
    "serumBids": "7tnT8FCsG7cGc5SQSh3bBK3yXbB2mZe5mGYZjKoMQjww",
    "serumAsks": "8nFWkVPrV6j8Lgz8G6YRXQbDY4KtUQnx5WxeVSKgXKGZ",
    "serumEventQueue": "DPfj2jYwPUQNHhFSrTiZ5BD8EvxwrYbXQqDJJPpeKinr",
    "serumCoinVaultAccount": "HtR9Um42aNQD5rkVKvxRGQEEBTxzxRqMQxJs1vNYCuJv",
    "serumPcVaultAccount": "Cw6raPVhLcDGvRQeFS4X3QaQaJLrooP4wEXZr7QTzSLh",
    "serumVaultSigner": "CuJBe4AxZfvNxuW5RtL3pmAsVZ3eNmb7JogeKD6K2fXj"
  },
  "status": "active"
}

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free

/markets REST API Endpoint - Metis

Loading...

Body Parameters

Returns