v14.0.0 (#26)

Author: truemagic-coder

README.md

@@ -73,7 +73,7 @@ config = {
     "tools": {
         "solana_ultra": {
             "private_key": "my-private-key", # Required - base58 string - please use env vars to store the key as it is very confidential
-            "jupiter_api_key": "my-jupiter-api-key", # Optional but recommended - get free key at jup.ag for dynamic rate limits (starts at 5 RPS, scales with usage)
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag (60 req/min on free tier)
             "referral_account": "my-referral-account", # Optional - your Jupiter referral account public key for collecting fees
             "referral_fee": 50, # Optional - fee in basis points (50-255 bps, e.g., 50 = 0.5%). Jupiter takes 20% of this fee.
             "payer_private_key": "payer-private-key", # Optional - base58 private key for gasless transactions (integrator pays gas)
@@ -88,10 +88,9 @@ config = {
 - **Transaction Landing**: Jupiter handles retries and transaction confirmation
 - **Referral Fees**: Optionally collect integrator fees (50-255 bps) via your Jupiter referral account
 - **Integrator Gas Payer**: Optionally pay for gas on behalf of users for truly gasless swaps
-- **Dynamic Rate Limits**: With API key, rate limits scale automatically with your usage (free)
 
-**API Key (Recommended):**
-Get a free Jupiter API key at [jup.ag](https://jup.ag) for dynamic rate limits. Without a key, you use the lite API with lower limits. With a key, you start at 5 RPS and it scales automatically at no cost.
+**API Key (Required):**
+Get a free Jupiter API key at [portal.jup.ag](https://portal.jup.ag). The free tier provides 60 requests per minute. The lite API (no key) was deprecated on December 31, 2025.
 
 **Setting up Referral Account:**
 To collect fees, you need a Jupiter referral account. Create one at [referral.jup.ag](https://referral.jup.ag/). Jupiter takes 20% of the referral fee you set. You also need to create token accounts for the tokens you want to collect fees in.
@@ -108,7 +107,7 @@ config = {
     "tools": {
         "jupiter_trigger": {
             "private_key": "my-private-key", # Required - base58 string
-            "jupiter_api_key": "my-jupiter-api-key", # Optional - for pro API with higher rate limits
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
             "referral_account": "my-referral-account", # Optional - for collecting fees
             "referral_fee": 50, # Optional - fee in basis points (50-255 bps)
             "payer_private_key": "payer-private-key", # Optional - for gasless transactions
@@ -139,7 +138,7 @@ config = {
     "tools": {
         "jupiter_recurring": {
             "private_key": "my-private-key", # Required - base58 string
-            "jupiter_api_key": "my-jupiter-api-key", # Optional - for pro API with higher rate limits
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
             "payer_private_key": "payer-private-key", # Optional - for gasless transactions
         },
     },
@@ -173,7 +172,9 @@ This plugin enables Solana Agent to get token holdings with USD values for any w
 ```python
 config = {
     "tools": {
-        "jupiter_holdings": {}, # No configuration required
+        "jupiter_holdings": {
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
+        },
     },
     "agents": [
         {
@@ -198,7 +199,9 @@ This plugin enables Solana Agent to get security warnings and risk information f
 ```python
 config = {
     "tools": {
-        "jupiter_shield": {}, # No configuration required
+        "jupiter_shield": {
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
+        },
     },
     "agents": [
         {
@@ -223,7 +226,9 @@ This plugin enables Solana Agent to search for Solana tokens by symbol, name, or
 ```python
 config = {
     "tools": {
-        "jupiter_token_search": {}, # No configuration required
+        "jupiter_token_search": {
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
+        },
     },
     "agents": [
         {
@@ -271,7 +276,7 @@ config = {
             "app_id": "your-privy-app-id", # Required - your Privy application ID
             "app_secret": "your-privy-app-secret", # Required - your Privy application secret
             "signing_key": "wallet-auth:your-signing-key", # Required - your Privy wallet authorization signing key
-            "jupiter_api_key": "my-jupiter-api-key", # Optional but recommended - get free key at jup.ag for dynamic rate limits
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
             "referral_account": "my-referral-account", # Optional - your Jupiter referral account public key for collecting fees
             "referral_fee": 50, # Optional - fee in basis points (50-255 bps, e.g., 50 = 0.5%). Jupiter takes 20% of this fee.
             "payer_private_key": "payer-private-key", # Optional - base58 private key for gasless transactions (integrator pays gas)
@@ -285,7 +290,6 @@ config = {
 - **Privy Delegated Wallets**: Use Privy's embedded wallets with delegation for seamless user experience
 - **Referral Fees**: Optionally collect integrator fees (50-255 bps) via your Jupiter referral account
 - **Integrator Gas Payer**: Optionally pay for gas on behalf of users for truly gasless swaps
-- **Dynamic Rate Limits**: With API key, rate limits scale automatically with your usage (free)
 
 ### Privy Trigger
 
@@ -298,7 +302,7 @@ config = {
             "app_id": "your-privy-app-id", # Required - your Privy application ID
             "app_secret": "your-privy-app-secret", # Required - your Privy application secret
             "signing_key": "wallet-auth:your-signing-key", # Required - your Privy wallet authorization signing key
-            "jupiter_api_key": "my-jupiter-api-key", # Optional - for pro API with higher rate limits
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
             "referral_account": "my-referral-account", # Optional - for collecting fees
             "referral_fee": 50, # Optional - fee in basis points (50-255 bps)
             "payer_private_key": "payer-private-key", # Optional - for gasless transactions
@@ -320,7 +324,7 @@ config = {
             "app_id": "your-privy-app-id", # Required - your Privy application ID
             "app_secret": "your-privy-app-secret", # Required - your Privy application secret
             "signing_key": "wallet-auth:your-signing-key", # Required - your Privy wallet authorization signing key
-            "jupiter_api_key": "my-jupiter-api-key", # Optional - for pro API with higher rate limits
+            "jupiter_api_key": "my-jupiter-api-key", # Required - get free key at portal.jup.ag
             "payer_private_key": "payer-private-key", # Optional - for gasless transactions
         },
     },

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "sakit"
-version = "13.3.6"
+version = "14.0.0"
 description = "Solana Agent Kit"
 authors = ["Bevan Hunt <bevan@bevanhunt.com>"]
 license = "MIT"

sakit/utils/recurring.py

@@ -16,9 +16,8 @@
 
 logger = logging.getLogger(__name__)
 
-# Use lite API for no-key access, main API for keyed access with dynamic rate limits
-JUPITER_RECURRING_API_LITE = "https://lite-api.jup.ag/recurring/v1"
-JUPITER_RECURRING_API_PRO = "https://api.jup.ag/recurring/v1"
+# Jupiter Recurring API base URL (API key required, free tier available at portal.jup.ag)
+JUPITER_RECURRING_API = "https://api.jup.ag/recurring/v1"
 
 
 @dataclass
@@ -59,25 +58,20 @@ class RecurringCancelResponse:
 class JupiterRecurring:
     """Jupiter Recurring API client for DCA orders."""
 
-    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None):
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
         """
         Initialize Jupiter Recurring client.
 
         Args:
-            api_key: Optional Jupiter API key for dynamic rate limits
-            base_url: Optional custom base URL (auto-selects based on api_key if not provided)
+            api_key: Jupiter API key (required, get free key at portal.jup.ag)
+            base_url: Optional custom base URL (defaults to api.jup.ag)
         """
-        if base_url:
-            self.base_url = base_url
-        elif api_key:
-            self.base_url = JUPITER_RECURRING_API_PRO
-        else:
-            self.base_url = JUPITER_RECURRING_API_LITE
-
+        self.base_url = base_url or JUPITER_RECURRING_API
         self.api_key = api_key
-        self._headers = {"Content-Type": "application/json"}
-        if api_key:
-            self._headers["x-api-key"] = api_key
+        self._headers = {
+            "Content-Type": "application/json",
+            "x-api-key": api_key,
+        }
 
     async def create_order(
         self,

sakit/utils/trigger.py

@@ -16,9 +16,8 @@
 
 logger = logging.getLogger(__name__)
 
-# Use lite API for no-key access, main API for keyed access with dynamic rate limits
-JUPITER_TRIGGER_API_LITE = "https://lite-api.jup.ag/trigger/v1"
-JUPITER_TRIGGER_API_PRO = "https://api.jup.ag/trigger/v1"
+# Jupiter Trigger API base URL (API key required, free tier available at portal.jup.ag)
+JUPITER_TRIGGER_API = "https://api.jup.ag/trigger/v1"
 
 
 @dataclass
@@ -70,25 +69,20 @@ class TriggerCancelMultipleResponse:
 class JupiterTrigger:
     """Jupiter Trigger API client for limit orders."""
 
-    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None):
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
         """
         Initialize Jupiter Trigger client.
 
         Args:
-            api_key: Optional Jupiter API key for dynamic rate limits
-            base_url: Optional custom base URL (auto-selects based on api_key if not provided)
+            api_key: Jupiter API key (required, get free key at portal.jup.ag)
+            base_url: Optional custom base URL (defaults to api.jup.ag)
         """
-        if base_url:
-            self.base_url = base_url
-        elif api_key:
-            self.base_url = JUPITER_TRIGGER_API_PRO
-        else:
-            self.base_url = JUPITER_TRIGGER_API_LITE
-
+        self.base_url = base_url or JUPITER_TRIGGER_API
         self.api_key = api_key
-        self._headers = {"Content-Type": "application/json"}
-        if api_key:
-            self._headers["x-api-key"] = api_key
+        self._headers = {
+            "Content-Type": "application/json",
+            "x-api-key": api_key,
+        }
 
     async def create_order(
         self,

sakit/utils/ultra.py

@@ -16,9 +16,8 @@
 
 logger = logging.getLogger(__name__)
 
-# Use lite API for no-key access, main API for keyed access with dynamic rate limits
-JUPITER_ULTRA_API_LITE = "https://lite-api.jup.ag/ultra/v1"
-JUPITER_ULTRA_API_PRO = "https://api.jup.ag/ultra/v1"
+# Jupiter Ultra API base URL (API key required, free tier available at portal.jup.ag)
+JUPITER_ULTRA_API = "https://api.jup.ag/ultra/v1"
 
 
 @dataclass
@@ -54,26 +53,20 @@ class UltraExecuteResponse:
 class JupiterUltra:
     """Jupiter Ultra API client."""
 
-    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None):
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
         """
         Initialize Jupiter Ultra client.
 
         Args:
-            api_key: Optional Jupiter API key for dynamic rate limits (get free key at jup.ag)
-            base_url: Optional custom base URL (auto-selects based on api_key if not provided)
+            api_key: Jupiter API key (required, get free key at portal.jup.ag)
+            base_url: Optional custom base URL (defaults to api.jup.ag)
         """
-        # Use Pro API with dynamic rate limits if API key provided, otherwise use Lite API
-        if base_url:
-            self.base_url = base_url
-        elif api_key:
-            self.base_url = JUPITER_ULTRA_API_PRO
-        else:
-            self.base_url = JUPITER_ULTRA_API_LITE
-
+        self.base_url = base_url or JUPITER_ULTRA_API
         self.api_key = api_key
-        self._headers = {"Content-Type": "application/json"}
-        if api_key:
-            self._headers["x-api-key"] = api_key
+        self._headers = {
+            "Content-Type": "application/json",
+            "x-api-key": api_key,
+        }
 
     async def get_order(
         self,