Jupiter Developers

Create price order

curl --request POST \
  --url https://api.jup.ag/trigger/v2/orders/price \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "orderType": "single",
  "depositRequestId": "01234567-89ab-cdef-0123-456789abcdef",
  "depositSignedTx": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...",
  "userPubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
  "inputMint": "So11111111111111111111111111111111111111112",
  "inputAmount": "1000000000",
  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "triggerMint": "So11111111111111111111111111111111111111112",
  "triggerCondition": "above",
  "triggerPriceUsd": 200,
  "slippageBps": 100,
  "expiresAt": 1735689600000
}
'

import requests

url = "https://api.jup.ag/trigger/v2/orders/price"

payload = {
    "orderType": "single",
    "depositRequestId": "01234567-89ab-cdef-0123-456789abcdef",
    "depositSignedTx": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...",
    "userPubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
    "inputMint": "So11111111111111111111111111111111111111112",
    "inputAmount": "1000000000",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "triggerMint": "So11111111111111111111111111111111111111112",
    "triggerCondition": "above",
    "triggerPriceUsd": 200,
    "slippageBps": 100,
    "expiresAt": 1735689600000
}
headers = {
    "x-api-key": "<api-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    orderType: 'single',
    depositRequestId: '01234567-89ab-cdef-0123-456789abcdef',
    depositSignedTx: 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...',
    userPubkey: 'BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV',
    inputMint: 'So11111111111111111111111111111111111111112',
    inputAmount: '1000000000',
    outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    triggerMint: 'So11111111111111111111111111111111111111112',
    triggerCondition: 'above',
    triggerPriceUsd: 200,
    slippageBps: 100,
    expiresAt: 1735689600000
  })
};

fetch('https://api.jup.ag/trigger/v2/orders/price', 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.jup.ag/trigger/v2/orders/price",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderType' => 'single',
    'depositRequestId' => '01234567-89ab-cdef-0123-456789abcdef',
    'depositSignedTx' => 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...',
    'userPubkey' => 'BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV',
    'inputMint' => 'So11111111111111111111111111111111111111112',
    'inputAmount' => '1000000000',
    'outputMint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'triggerMint' => 'So11111111111111111111111111111111111111112',
    'triggerCondition' => 'above',
    'triggerPriceUsd' => 200,
    'slippageBps' => 100,
    'expiresAt' => 1735689600000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jup.ag/trigger/v2/orders/price"

	payload := strings.NewReader("{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jup.ag/trigger/v2/orders/price")
  .header("x-api-key", "<api-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jup.ag/trigger/v2/orders/price")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}"

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

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "txSignature": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d...",
  "depositConfirmed": true
}

{
  "error": "<string>",
  "details": {}
}

POST

orders

price

Create price order

curl --request POST \
  --url https://api.jup.ag/trigger/v2/orders/price \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "orderType": "single",
  "depositRequestId": "01234567-89ab-cdef-0123-456789abcdef",
  "depositSignedTx": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...",
  "userPubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
  "inputMint": "So11111111111111111111111111111111111111112",
  "inputAmount": "1000000000",
  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "triggerMint": "So11111111111111111111111111111111111111112",
  "triggerCondition": "above",
  "triggerPriceUsd": 200,
  "slippageBps": 100,
  "expiresAt": 1735689600000
}
'

import requests

url = "https://api.jup.ag/trigger/v2/orders/price"

payload = {
    "orderType": "single",
    "depositRequestId": "01234567-89ab-cdef-0123-456789abcdef",
    "depositSignedTx": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...",
    "userPubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
    "inputMint": "So11111111111111111111111111111111111111112",
    "inputAmount": "1000000000",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "triggerMint": "So11111111111111111111111111111111111111112",
    "triggerCondition": "above",
    "triggerPriceUsd": 200,
    "slippageBps": 100,
    "expiresAt": 1735689600000
}
headers = {
    "x-api-key": "<api-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    orderType: 'single',
    depositRequestId: '01234567-89ab-cdef-0123-456789abcdef',
    depositSignedTx: 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...',
    userPubkey: 'BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV',
    inputMint: 'So11111111111111111111111111111111111111112',
    inputAmount: '1000000000',
    outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    triggerMint: 'So11111111111111111111111111111111111111112',
    triggerCondition: 'above',
    triggerPriceUsd: 200,
    slippageBps: 100,
    expiresAt: 1735689600000
  })
};

fetch('https://api.jup.ag/trigger/v2/orders/price', 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.jup.ag/trigger/v2/orders/price",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'orderType' => 'single',
    'depositRequestId' => '01234567-89ab-cdef-0123-456789abcdef',
    'depositSignedTx' => 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...',
    'userPubkey' => 'BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV',
    'inputMint' => 'So11111111111111111111111111111111111111112',
    'inputAmount' => '1000000000',
    'outputMint' => 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
    'triggerMint' => 'So11111111111111111111111111111111111111112',
    'triggerCondition' => 'above',
    'triggerPriceUsd' => 200,
    'slippageBps' => 100,
    'expiresAt' => 1735689600000
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jup.ag/trigger/v2/orders/price"

	payload := strings.NewReader("{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.jup.ag/trigger/v2/orders/price")
  .header("x-api-key", "<api-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.jup.ag/trigger/v2/orders/price")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"orderType\": \"single\",\n  \"depositRequestId\": \"01234567-89ab-cdef-0123-456789abcdef\",\n  \"depositSignedTx\": \"AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgAAEN...\",\n  \"userPubkey\": \"BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV\",\n  \"inputMint\": \"So11111111111111111111111111111111111111112\",\n  \"inputAmount\": \"1000000000\",\n  \"outputMint\": \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\",\n  \"triggerMint\": \"So11111111111111111111111111111111111111112\",\n  \"triggerCondition\": \"above\",\n  \"triggerPriceUsd\": 200,\n  \"slippageBps\": 100,\n  \"expiresAt\": 1735689600000\n}"

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

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "txSignature": "5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d...",
  "depositConfirmed": true
}

{
  "error": "<string>",
  "details": {}
}

Authorizations

x-api-key

string

header

required

Get API key via https://developers.jup.ag/portal

Authorization

string

header

required

JWT token from the challenge-response auth flow

Body

application/json

orderType

enum<string>

required

Available options:

single,

oco,

otoco

depositRequestId

string

required

From /deposit/craft response

depositSignedTx

string

required

Base64-encoded signed deposit transaction

userPubkey

string

required

inputMint

string

required

inputAmount

string

required

Amount in smallest unit

outputMint

string

required

triggerMint

string

required

Token mint to monitor for price

expiresAt

number

required

Expiration timestamp (milliseconds)

triggerCondition

enum<string>

Single/OTOCO only

Available options:

above,

below

triggerPriceUsd

number

Single/OTOCO trigger price. For single orders, required unless trailingBps is set.

trailingBps

number

Trailing stop loss trail distance in basis points (50-9000). Single orders only; set instead of triggerPriceUsd. Direction from triggerCondition: below = sell-below (triggerMint === inputMint), above = buy-above (triggerMint === outputMint).

Required range: 50 <= x <= 9000

slippageBps

number

Slippage tolerance (0-10000 bps)

tpPriceUsd

number

Take-profit price (OCO/OTOCO)

slPriceUsd

number

Stop-loss price (OCO/OTOCO)

tpSlippageBps

number

Take-profit slippage (OCO/OTOCO)

slSlippageBps

number

Stop-loss slippage (OCO/OTOCO)

Response

Order created

string

required

Order UUID

txSignature

string

required

On-chain transaction signature

depositConfirmed

boolean

Whether the deposit has landed and the order is active

Craft Deposit Update Order

⌘I

Get Started

Limit Orders

DCA

Resources

API Reference

Create Order

Authorizations

Body

Response