jupiter-swap-python 0.1.0__tar.gz

jupiter_swap_python-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,21 @@
+---
+name: Bug report
+about: Report a bug
+labels: bug
+---
+
+**Describe the bug**
+A clear description of the issue.
+
+**To reproduce**
+```python
+# Minimal code to reproduce
+```
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- Python version:
+- jupiter-swap-python version:
+- OS:

jupiter_swap_python-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,11 @@
+---
+name: Feature request
+about: Suggest a feature
+labels: enhancement
+---
+
+**What problem does this solve?**
+
+**Proposed solution**
+
+**Alternatives considered**

jupiter_swap_python-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,7 @@
+## What does this PR do?
+
+## Checklist
+- [ ] Tests pass (`pytest -v`)
+- [ ] Linting passes (`ruff check`)
+- [ ] Types check (`mypy jupiter_swap/`)
+- [ ] CHANGELOG updated (if user-facing)

jupiter_swap_python-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check jupiter_swap/ tests/
+
+      - name: Type check
+        run: mypy jupiter_swap/
+
+      - name: Test
+        run: pytest -v --tb=short

jupiter_swap_python-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.so
+.env
+.DS_Store

jupiter_swap_python-0.1.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release
+- Jupiter V6 quote and swap API
+- Jupiter Ultra API (combined quote + swap with MEV protection)
+- Jupiter Token API (metadata, verification, banned detection)
+- Async/await with `httpx`
+- Built-in rate limiting and 429 retry
+- Fully typed with `py.typed` marker

jupiter_swap_python-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,31 @@
+# Contributing to jupiter-swap-python
+
+## Setup
+
+```bash
+git clone https://github.com/JinUltimate1995/jupiter-swap-python.git
+cd jupiter-swap-python
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Development
+
+```bash
+# Run tests
+pytest -v
+
+# Lint
+ruff check jupiter_swap/ tests/
+
+# Type check
+mypy jupiter_swap/
+```
+
+## Pull Requests
+
+1. Fork the repo
+2. Create a feature branch
+3. Add tests for new functionality
+4. Ensure all checks pass
+5. Submit a PR

jupiter_swap_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 JinUltimate1995
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jupiter_swap_python-0.1.0/PKG-INFO

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: jupiter-swap-python
+Version: 0.1.0
+Summary: Async Python client for the Jupiter DEX aggregator on Solana — V6 quote/swap and Ultra API.
+Project-URL: Homepage, https://github.com/JinUltimate1995/jupiter-swap-python
+Project-URL: Repository, https://github.com/JinUltimate1995/jupiter-swap-python
+Project-URL: Issues, https://github.com/JinUltimate1995/jupiter-swap-python/issues
+Project-URL: Changelog, https://github.com/JinUltimate1995/jupiter-swap-python/blob/main/CHANGELOG.md
+Author: JinUltimate1995
+License-Expression: MIT
+License-File: LICENSE
+Keywords: aggregator,async,crypto,defi,dex,jupiter,python,solana,swap,trading
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# jupiter-swap-python
+
+**The missing Jupiter swap client for Python. Async. Typed. Production-tested.**
+
+[![PyPI version](https://img.shields.io/pypi/v/jupiter-swap-python?color=blue)](https://pypi.org/project/jupiter-swap-python/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/JinUltimate1995/jupiter-swap-python/actions/workflows/ci.yml/badge.svg)](https://github.com/JinUltimate1995/jupiter-swap-python/actions)
+
+Jupiter's own Python SDK was abandoned (returns 404). This library fills the gap — a clean, typed, async client for [Jupiter](https://jup.ag), the #1 DEX aggregator on Solana.
+
+---
+
+## ⚡ Quickstart
+
+```bash
+pip install jupiter-swap-python
+```
+
+### Get a quote
+
+```python
+import asyncio
+from jupiter_swap import JupiterClient
+
+SOL = "So11111111111111111111111111111111111111112"
+USDC = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+
+async def main():
+    async with JupiterClient() as jup:
+        quote = await jup.get_quote(SOL, USDC, 1_000_000_000)  # 1 SOL
+        print(f"1 SOL = {int(quote.out_amount) / 1e6:.2f} USDC")
+        print(f"Price impact: {quote.price_impact_pct}%")
+
+asyncio.run(main())
+```
+
+### Swap tokens
+
+```python
+async with JupiterClient(api_key="your-key") as jup:
+    # Step 1: Get quote
+    quote = await jup.get_quote(SOL, USDC, 1_000_000_000)
+
+    # Step 2: Build swap transaction
+    swap = await jup.get_swap_transaction(
+        quote,
+        user_public_key="YourWalletPublicKey...",
+        priority_fee_lamports=500_000,  # 0.0005 SOL
+    )
+
+    # Step 3: Sign and send swap.swap_transaction with your wallet
+    print(f"Transaction ready (block height: {swap.last_valid_block_height})")
+```
+
+### Ultra API (recommended for production)
+
+```python
+async with JupiterClient(api_key="your-key") as jup:
+    # Combined quote + swap in one call
+    order = await jup.ultra_order(
+        input_mint=SOL,
+        output_mint=USDC,
+        amount=1_000_000_000,
+        taker="YourWalletPublicKey...",
+    )
+
+    print(f"Swap type: {order.swap_type}")
+    print(f"Out amount: {order.out_amount}")
+
+    # Sign order.swap_transaction with your wallet, then:
+    tx_sig = await jup.ultra_execute(signed_transaction, order.request_id)
+    print(f"Executed: {tx_sig}")
+```
+
+### Token verification
+
+```python
+from jupiter_swap import TokenClient
+
+async with TokenClient() as tokens:
+    info = await tokens.get_token_info("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
+    print(f"{info.symbol} — verified: {info.is_verified}, banned: {info.is_banned}")
+
+    # Check if a token is a known scam
+    if await tokens.is_banned("SomeScamMint..."):
+        print("🚫 Token is banned!")
+```
+
+---
+
+## 🔧 API Reference
+
+### `JupiterClient`
+
+| Method | Description |
+|--------|-------------|
+| `get_quote()` | Get the best swap route and price |
+| `get_swap_transaction()` | Build a signable transaction from a quote |
+| `ultra_order()` | Combined quote + swap via Ultra API (MEV protection) |
+| `ultra_execute()` | Execute a signed Ultra swap order |
+
+### `TokenClient`
+
+| Method | Description |
+|--------|-------------|
+| `get_token_info()` | Get token metadata and verification status |
+| `is_banned()` | Check if a token is on the banned list |
+| `is_verified()` | Check if a token is verified |
+| `get_strict_list()` | Get all strictly verified tokens |
+| `refresh_banned_list()` | Manually refresh the banned list |
+
+### Models
+
+- `QuoteResponse` — Route details, expected output, price impact
+- `SwapResponse` — Base64 transaction ready to sign
+- `UltraOrder` — Combined quote + transaction from Ultra API
+- `TokenInfo` — Name, symbol, decimals, verification flags
+
+---
+
+## 🛡️ Why this library?
+
+| Problem | Solution |
+|---------|----------|
+| Jupiter's Python SDK is deleted | This exists |
+| Raw `httpx.post()` calls everywhere | Typed client with proper models |
+| No 429 handling | Built-in retry with exponential backoff |
+| Token safety is an afterthought | `TokenClient` with banned/verified checks |
+| Sync-only clients | Fully async with `httpx` |
+
+---
+
+## 🔑 API Key
+
+A Jupiter API key is optional but recommended for production use (higher rate limits).
+
+Get one at [station.jup.ag](https://station.jup.ag/).
+
+```python
+client = JupiterClient(api_key="your-api-key")
+```
+
+---
+
+## 📦 Also by JinUltimate1995
+
+- [**solana-rpc-resilient**](https://github.com/JinUltimate1995/solana-rpc-resilient) — Solana RPC client with automatic failover, rate limiting, and circuit breaker
+- [**dexscreener-python**](https://github.com/JinUltimate1995/dexscreener-python) — Async DexScreener API client for token/pair data across 80+ chains
+
+---
+
+## License
+
+MIT

jupiter_swap_python-0.1.0/README.md

@@ -0,0 +1,155 @@
+# jupiter-swap-python
+
+**The missing Jupiter swap client for Python. Async. Typed. Production-tested.**
+
+[![PyPI version](https://img.shields.io/pypi/v/jupiter-swap-python?color=blue)](https://pypi.org/project/jupiter-swap-python/)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/JinUltimate1995/jupiter-swap-python/actions/workflows/ci.yml/badge.svg)](https://github.com/JinUltimate1995/jupiter-swap-python/actions)
+
+Jupiter's own Python SDK was abandoned (returns 404). This library fills the gap — a clean, typed, async client for [Jupiter](https://jup.ag), the #1 DEX aggregator on Solana.
+
+---
+
+## ⚡ Quickstart
+
+```bash
+pip install jupiter-swap-python
+```
+
+### Get a quote
+
+```python
+import asyncio
+from jupiter_swap import JupiterClient
+
+SOL = "So11111111111111111111111111111111111111112"
+USDC = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
+
+async def main():
+    async with JupiterClient() as jup:
+        quote = await jup.get_quote(SOL, USDC, 1_000_000_000)  # 1 SOL
+        print(f"1 SOL = {int(quote.out_amount) / 1e6:.2f} USDC")
+        print(f"Price impact: {quote.price_impact_pct}%")
+
+asyncio.run(main())
+```
+
+### Swap tokens
+
+```python
+async with JupiterClient(api_key="your-key") as jup:
+    # Step 1: Get quote
+    quote = await jup.get_quote(SOL, USDC, 1_000_000_000)
+
+    # Step 2: Build swap transaction
+    swap = await jup.get_swap_transaction(
+        quote,
+        user_public_key="YourWalletPublicKey...",
+        priority_fee_lamports=500_000,  # 0.0005 SOL
+    )
+
+    # Step 3: Sign and send swap.swap_transaction with your wallet
+    print(f"Transaction ready (block height: {swap.last_valid_block_height})")
+```
+
+### Ultra API (recommended for production)
+
+```python
+async with JupiterClient(api_key="your-key") as jup:
+    # Combined quote + swap in one call
+    order = await jup.ultra_order(
+        input_mint=SOL,
+        output_mint=USDC,
+        amount=1_000_000_000,
+        taker="YourWalletPublicKey...",
+    )
+
+    print(f"Swap type: {order.swap_type}")
+    print(f"Out amount: {order.out_amount}")
+
+    # Sign order.swap_transaction with your wallet, then:
+    tx_sig = await jup.ultra_execute(signed_transaction, order.request_id)
+    print(f"Executed: {tx_sig}")
+```
+
+### Token verification
+
+```python
+from jupiter_swap import TokenClient
+
+async with TokenClient() as tokens:
+    info = await tokens.get_token_info("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
+    print(f"{info.symbol} — verified: {info.is_verified}, banned: {info.is_banned}")
+
+    # Check if a token is a known scam
+    if await tokens.is_banned("SomeScamMint..."):
+        print("🚫 Token is banned!")
+```
+
+---
+
+## 🔧 API Reference
+
+### `JupiterClient`
+
+| Method | Description |
+|--------|-------------|
+| `get_quote()` | Get the best swap route and price |
+| `get_swap_transaction()` | Build a signable transaction from a quote |
+| `ultra_order()` | Combined quote + swap via Ultra API (MEV protection) |
+| `ultra_execute()` | Execute a signed Ultra swap order |
+
+### `TokenClient`
+
+| Method | Description |
+|--------|-------------|
+| `get_token_info()` | Get token metadata and verification status |
+| `is_banned()` | Check if a token is on the banned list |
+| `is_verified()` | Check if a token is verified |
+| `get_strict_list()` | Get all strictly verified tokens |
+| `refresh_banned_list()` | Manually refresh the banned list |
+
+### Models
+
+- `QuoteResponse` — Route details, expected output, price impact
+- `SwapResponse` — Base64 transaction ready to sign
+- `UltraOrder` — Combined quote + transaction from Ultra API
+- `TokenInfo` — Name, symbol, decimals, verification flags
+
+---
+
+## 🛡️ Why this library?
+
+| Problem | Solution |
+|---------|----------|
+| Jupiter's Python SDK is deleted | This exists |
+| Raw `httpx.post()` calls everywhere | Typed client with proper models |
+| No 429 handling | Built-in retry with exponential backoff |
+| Token safety is an afterthought | `TokenClient` with banned/verified checks |
+| Sync-only clients | Fully async with `httpx` |
+
+---
+
+## 🔑 API Key
+
+A Jupiter API key is optional but recommended for production use (higher rate limits).
+
+Get one at [station.jup.ag](https://station.jup.ag/).
+
+```python
+client = JupiterClient(api_key="your-api-key")
+```
+
+---
+
+## 📦 Also by JinUltimate1995
+
+- [**solana-rpc-resilient**](https://github.com/JinUltimate1995/solana-rpc-resilient) — Solana RPC client with automatic failover, rate limiting, and circuit breaker
+- [**dexscreener-python**](https://github.com/JinUltimate1995/dexscreener-python) — Async DexScreener API client for token/pair data across 80+ chains
+
+---
+
+## License
+
+MIT

jupiter_swap_python-0.1.0/jupiter_swap/__init__.py

@@ -0,0 +1,19 @@
+"""
+jupiter-swap-python — async Jupiter DEX aggregator client for Python.
+"""
+
+from .client import JupiterClient
+from .models import QuoteResponse, SwapResponse, TokenInfo, UltraOrder
+from .tokens import TokenClient
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "JupiterClient",
+    "TokenClient",
+    "QuoteResponse",
+    "SwapResponse",
+    "UltraOrder",
+    "TokenInfo",
+    "__version__",
+]