/limit-orders/create | Swap API on Solana

Please note that this method is only available for paid subscribers of Swap API. This endpoint is currently in BETA. If you have any feedback or run into any issues, please reach out to support.

Solana Kit includes the ability to customize RPC methods and transports, allowing you to seamlessly integrate Quicknode add-ons into your applications. For more information on how to use Quicknode 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)

Query Parameters

inputMint string REQUIRED: The mint address of the input token

outputMint string REQUIRED: The mint address of the output token

maker string REQUIRED: The wallet address of the user who wants to create an order

payer string REQUIRED: The wallet address of who is paying to open an order (usually 'maker')

params object REQUIRED: Order parameters containing amounts, expiration, and fee settings

makingAmount string REQUIRED: Amount of input mint to sell

takingAmount string REQUIRED: Amount of output mint to buy

expiredAt string: Unix time in seconds that determines when an order should automatically close. i.e Date.now() / 1_000

feeBps string: Amount of fee that the 'referral' collects. This field is required if 'referral' is provided

computeUnitPrice string: Used to determine a transaction's prioritization fee (i.e 500000). Defaults to 'auto'

referral string: The public key where fees get sent to. This field is required if 'feeBps' is provided

inputTokenProgram string: Specifies the program ID for the input token. Defaults to 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'

outputTokenProgram string: Specifies the program ID for the output token. Defaults to 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA'

wrapAndUnwrapSol boolean: Defaults to 'true' if either input or output mints are raw SOL

Returns

order string: The public key of the Jupiter Limit Order for the unsigned transaction

tx string: The unsigned transaction to create the Jupiter Limit Order

instructions array

The instructions to create the Jupiter Limit Order

instruction object

The instruction for the order

programId string: The program ID of the instruction

keys array

Array of objects containing the keys of the instruction

pubkey string: The public key of the instruction

isSigner boolean: Whether the public key is a signer

isWritable boolean: Whether the address is writable

data string: The data of the instruction

Request

1
curl --location --request POST 'https://docs-demo.solana-mainnet.quiknode.pro/limit-orders/create' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "maker": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
5
    "payer": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
6
    "inputMint": "So11111111111111111111111111111111111111112",
7
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
8
    "params": {
9
        "makingAmount": "50000000",
10
        "takingAmount": "1000000000"
11
    }
12
}'

1
curl --location --request POST 'https://docs-demo.solana-mainnet.quiknode.pro/limit-orders/create' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "maker": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
5
    "payer": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
6
    "inputMint": "So11111111111111111111111111111111111111112",
7
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
8
    "params": {
9
        "makingAmount": "50000000",
10
        "takingAmount": "1000000000"
11
    }
12
}'

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

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

9
    let data = r#"{
10
    "maker": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
11
    "payer": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
12
    "inputMint": "So11111111111111111111111111111111111111112",
13
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
14
    "params": {
15
        "makingAmount": "50000000",
16
        "takingAmount": "1000000000"
17
    }
18
}"#;
19

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

22
    let request = client.request(reqwest::Method::POST, "https://docs-demo.solana-mainnet.quiknode.pro/limit-orders/create")
23
        .headers(headers)
24
        .json(&json);
25

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

29
    println!("{}", body);
30

31
    Ok(())
32
}

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

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

9
    let data = r#"{
10
    "maker": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
11
    "payer": "J2RNWdFBRbiVzjYukgzyStfYhpTHFoBFRHQjvDAsnPY9",
12
    "inputMint": "So11111111111111111111111111111111111111112",
13
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
14
    "params": {
15
        "makingAmount": "50000000",
16
        "takingAmount": "1000000000"
17
    }
18
}"#;
19

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

22
    let request = client.request(reqwest::Method::POST, "https://docs-demo.solana-mainnet.quiknode.pro/limit-orders/create")
23
        .headers(headers)
24
        .json(&json);
25

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

29
    println!("{}", body);
30

31
    Ok(())
32
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free