Practical overview
When it fits
Use it when a Python application needs to request and execute Solana token swaps through Jupiter Ultra API, without integrating RPC endpoint management as part of the documented flow.
Who it is for
- Python developers adding Jupiter Ultra swap execution to an application.
- Teams building backend trading integrations or command-line utilities for Solana token swaps.
Documented uses
- Create a Jupiter Ultra order request from token mints and an amount.
- Submit a swap order for execution and inspect its status and transaction signature.
- Configure the client to use the default lite API endpoint or an API-key-backed api.jup.ag endpoint.
Requirements & limits
The SDK is distributed as a pip package and its public repository lists an MIT license. The README documents a default lite-api.jup.ag endpoint and an optional API-key configuration for api.jup.ag.
- The documented primary workflow requires a Solana private key, read from PRIVATE_KEY by default or a specified custom environment variable.
- The quick start uses UltraApiClient and order_and_execute to submit an order.
- The README says the Ultra API flow does not require the integrator to manage or connect RPC endpoints.
- The project is actively worked on; the README recommends keeping up with releases.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up the SDK and configure client credentials
Install the Python package and prepare the documented private-key or API-key client configuration.
Before you start
- A Python project with pip.
- A Solana private key, supplied as a base58 string or uint8 array through PRIVATE_KEY, or a custom environment-variable name.
- An optional Jupiter API key from the Jupiter Portal.
Steps
Install the package with the command below.
pip install jup-python-sdkSet PRIVATE_KEY in the environment, or configure the client with
private_key_env_varif using a different variable name.For API-key-backed access, pass the key as
api_keywhen creating UltraApiClient.
Expected outcome
The package is installed and the client can be configured to read the key from the selected environment variable; providing an API key selects api.jup.ag rather than lite-api.jup.ag.
Guide limitations
- This guide covers installation and client configuration, not a completed swap.
- The README recommends staying current with releases because the project is actively worked on.
Request and execute a sample Ultra swap order
Use the README quick-start pattern to create an order request and submit it through the SDK.
Before you start
- The installed jup-python-sdk package.
- A configured Solana private key available to UltraApiClient.
- Input and output token mint addresses, an amount and the taker public key.
Steps
Create an UltraApiClient and an UltraOrderRequest with the input mint, output mint, amount and taker public key.
Call
client.order_and_execute(order_request).Read the response status and transaction signature; the example also prints code and error fields when status is Failed.
Close the client after processing the response.
Expected outcome
The example obtains and submits an Ultra order and reports the returned status and transaction signature.
Guide limitations
- The README’s sample uses WSOL and USDC mint addresses and an amount of 10000000; it does not establish outcomes for other order parameters.
- The example describes a swap workflow but does not guarantee successful execution.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- Jupiter-DevRel/jup-python-sdk · Official homepage title · retained in its source language

