developer docs reset using versioning

Moved/1-limit-order-api.md

@@ -525,4 +525,4 @@ The Jupiter Limit Order's project account for the Referral Program is `45ruCyfdR
 
 ## Referral
 
-Check out the [referral program](/docs/apis/adding-fees) for Limit Order.
+Check out the [referral program](/docs/old//apis/adding-fees) for Limit Order.

Moved/2-how-swap-works/2-how-swap-works.md

@@ -46,7 +46,7 @@ The Token Ledger caters to a wide range of use cases, which include but are not
 - Facilitating the exchange of NFTs for tokens other than SOL.
 
 Read more about the Token Ledger:
-https://station.jup.ag/docs/apis/swap-api#using-token-ledger-instruction
+https://station.jup.ag/docs/old/apis/swap-api#using-token-ledger-instruction
 
 
 ## Safety Notifications

Moved/blog-v1/2023-09-18-dca-out-of-beta/index.md

@@ -60,7 +60,7 @@ So in this scenario, if the **SOL price is within $19-$20**, the DCA will execut
 
 ## Expanded Tradable Token Selection
 
-Additionally, we've significantly broadened our range of supported tokens, expanding from the **top 20 traded tokens on Jupiter's list to encompass over 600 tokens**. This expansion is backed by the community-verified [Jupiter Strict Token List](/docs/token-list/token-list-api).
+Additionally, we've significantly broadened our range of supported tokens, expanding from the **top 20 traded tokens on Jupiter's list to encompass over 600 tokens**. This expansion is backed by the community-verified [Jupiter Strict Token List](/docs/old/token-list/token-list-api).
 
 ![DCAcomment4](DCAcomment4.jpg)
 

Moved/blog-v1/2023-10-23-jupiter-planetary-developer-week/index.md

@@ -91,7 +91,7 @@ The Token Ledger caters to a wide range of use cases, which include but are not
 - Facilitating the exchange of NFTs for tokens other than SOL.
 
 Read more about the Token Ledger:
-https://station.jup.ag/docs/apis/swap-api#using-token-ledger-instruction
+https://station.jup.ag/docs/old/apis/swap-api#using-token-ledger-instruction
 
 ### Referral Fees Program to Simplify Fee Collection
 In our pursuit of making life easier for our partners, we've streamlined the process of charging referral fees with the new referral fees program.
@@ -109,9 +109,9 @@ The partner journey is now hyper easy - They head over to Jupiter, create a refe
 
 Give our dashboard a spin here: https://referral.jup.ag
 
-Read here on how to add your platform fees to Jupiter Swap : https://station.jup.ag/docs/apis/adding-fees
+Read here on how to add your platform fees to Jupiter Swap : https://station.jup.ag/docs/old/apis/adding-fees
 
-More info on Jupiter Referral Program: https://station.jup.ag/docs/additional-topics/referral-program
+More info on Jupiter Referral Program: https://station.jup.ag/docs/old/additional-topics/referral-program
 
 ![Referral](referral1.jpg)
 
@@ -131,7 +131,7 @@ For CPI to work, the transaction will be composed of these instructions:
 4. The program then transfers the SOL back to the user.
 
 
-Read more here: https://station.jup.ag/docs/apis/cpi
+Read more here: https://station.jup.ag/docs/old/apis/cpi
 
 The CPI approach is not without its limitations - because of Solana’s transaction limit of 1232 byte size, lookup tables cannot be used within a CPI call, swaps via CPI can fail at runtime since Jupiter routes may involve multiple DEXes in order to reduce price impact. Instead, we recommend taking the “flash-fil” approach to utilizing Jupiter Swap.
 
@@ -149,7 +149,7 @@ For Flash Fill to work, the transaction will be composed of these instructions:
 
 This approach entirely bypasses the need for CPI calls, effectively sidestepping the constraints imposed by CPI.
 
-To delve deeper into these two approaches, check out our documentation here: https://station.jup.ag/docs/apis/flash-fill
+To delve deeper into these two approaches, check out our documentation here: https://station.jup.ag/docs/old/apis/flash-fill
 
 ## Partners Using v6 API
 A big shout out to our key early adopters for running our v6 API and helping us improve our stability and features. Check out how they are using Jupiter to power their use cases.
@@ -194,7 +194,7 @@ ExactOut is particularly useful in scenarios involving the purchase of NFTs, all
 The good news is that since the NFT Marketplace has integrated ExactOut into its interface, you can simply purchase the 40 SOL NFT and Jupiter swap would automatically calculate the most optimal amount of BONK required to purchase the 40 SOL NFT. This is achieved in a single click, eliminating the need to leave the site or perform additional calculations, while ensuring that you receive the best possible price through Jupiter.
 This is extremely important to Solana as payments are a crucial part of bridging crypto with real-life applications, ultimately contributing to the mainstream adoption of the Solana ecosystem.
 
-Read more about ExactOut here: https://station.jup.ag/docs/apis/payments-api
+Read more about ExactOut here: https://station.jup.ag/docs/old/apis/payments-api
 
 ### ExactOut Showcase #1 - Sollinked
 

Moved/blog-v2/2023-09-18-dca-out-of-beta/index.md

@@ -60,7 +60,7 @@ So in this scenario, if the **SOL price is within $19-$20**, the DCA will execut
 
 ## Expanded Tradable Token Selection
 
-Additionally, we've significantly broadened our range of supported tokens, expanding from the **top 20 traded tokens on Jupiter's list to encompass over 600 tokens**. This expansion is backed by the community-verified [Jupiter Strict Token List](/docs/token-list/token-list-api).
+Additionally, we've significantly broadened our range of supported tokens, expanding from the **top 20 traded tokens on Jupiter's list to encompass over 600 tokens**. This expansion is backed by the community-verified [Jupiter Strict Token List](/docs/old//token-list/token-list-api).
 
 ![DCAcomment4](DCAcomment4.jpg)
 

Moved/blog-v2/2023-10-23-jupiter-planetary-developer-week/index.md

@@ -91,7 +91,7 @@ The Token Ledger caters to a wide range of use cases, which include but are not
 - Facilitating the exchange of NFTs for tokens other than SOL.
 
 Read more about the Token Ledger:
-https://station.jup.ag/docs/apis/swap-api#using-token-ledger-instruction
+https://station.jup.ag/docs/old/apis/swap-api#using-token-ledger-instruction
 
 ### Referral Fees Program to Simplify Fee Collection
 In our pursuit of making life easier for our partners, we've streamlined the process of charging referral fees with the new referral fees program.
@@ -109,9 +109,9 @@ The partner journey is now hyper easy - They head over to Jupiter, create a refe
 
 Give our dashboard a spin here: https://referral.jup.ag
 
-Read here on how to add your platform fees to Jupiter Swap : https://station.jup.ag/docs/apis/adding-fees
+Read here on how to add your platform fees to Jupiter Swap : https://station.jup.ag/docs/old/apis/adding-fees
 
-More info on Jupiter Referral Program: https://station.jup.ag/docs/additional-topics/referral-program
+More info on Jupiter Referral Program: https://station.jup.ag/docs/old/additional-topics/referral-program
 
 ![Referral](referral1.jpg)
 
@@ -131,7 +131,7 @@ For CPI to work, the transaction will be composed of these instructions:
 4. The program then transfers the SOL back to the user.
 
 
-Read more here: https://station.jup.ag/docs/apis/cpi
+Read more here: https://station.jup.ag/docs/old/apis/cpi
 
 The CPI approach is not without its limitations - because of Solana’s transaction limit of 1232 byte size, lookup tables cannot be used within a CPI call, swaps via CPI can fail at runtime since Jupiter routes may involve multiple DEXes in order to reduce price impact. Instead, we recommend taking the “flash-fil” approach to utilizing Jupiter Swap.
 
@@ -149,7 +149,7 @@ For Flash Fill to work, the transaction will be composed of these instructions:
 
 This approach entirely bypasses the need for CPI calls, effectively sidestepping the constraints imposed by CPI.
 
-To delve deeper into these two approaches, check out our documentation here: https://station.jup.ag/docs/apis/flash-fill
+To delve deeper into these two approaches, check out our documentation here: https://station.jup.ag/docs/old/apis/flash-fill
 
 ## Partners Using v6 API
 A big shout out to our key early adopters for running our v6 API and helping us improve our stability and features. Check out how they are using Jupiter to power their use cases.
@@ -194,7 +194,7 @@ ExactOut is particularly useful in scenarios involving the purchase of NFTs, all
 The good news is that since the NFT Marketplace has integrated ExactOut into its interface, you can simply purchase the 40 SOL NFT and Jupiter swap would automatically calculate the most optimal amount of BONK required to purchase the 40 SOL NFT. This is achieved in a single click, eliminating the need to leave the site or perform additional calculations, while ensuring that you receive the best possible price through Jupiter.
 This is extremely important to Solana as payments are a crucial part of bridging crypto with real-life applications, ultimately contributing to the mainstream adoption of the Solana ecosystem.
 
-Read more about ExactOut here: https://station.jup.ag/docs/apis/payments-api
+Read more about ExactOut here: https://station.jup.ag/docs/old//apis/payments-api
 
 ### ExactOut Showcase #1 - Sollinked
 

Moved/legacy/2-how-does-jupiter-work.md

@@ -25,7 +25,7 @@ Jupiter will split your trade into smaller trade sizes. For example, if you want
 
 ### Automatically lists new tokens
 
-The number of new tokens being added is increasing at an ever faster pace. Jupiter automatically lists any tokens as long as their have [reached enough liquidity](/docs/get-your-token-onto-jup). This means you can be assured that you'll be able to trade new tokens as they launch on Solana.
+The number of new tokens being added is increasing at an ever faster pace. Jupiter automatically lists any tokens as long as their have [reached enough liquidity](/docs/old//get-your-token-onto-jup). This means you can be assured that you'll be able to trade new tokens as they launch on Solana.
 
 ### Automatically lists new markets
 

docs/0-api-usage.md

@@ -0,0 +1,35 @@
+---
+sidebar_label: "API Usage"
+description: "Know how to use Jupiter API to build world class apps."
+title: "API Usage"
+---
+
+<head>
+    <title>API Usage</title>
+    <meta name="twitter:card" content="summary" />
+</head>
+
+In 1 December 2024, Jupiter have introduced new hostnames and the usage of our APIs through API keys to facilitate better developer support.
+
+## What's New?
+
+*Last updated: 1 December 2024*
+- API will now be served through new hostnames.
+- API will now be served through API keys.
+- The new service willl comprise of 3 service types.
+
+| Service Types | Description |
+| --- | --- |
+| Free with no API key | New rate limits, however, will gradually decrease. |
+| Paid plan with API key | Fixed rate limits, self served through an API dashboard. |
+| Custom with API key | Custom rate limitsk, mainly for partner usage. |
+
+## What's Old?
+
+- Old hostnames will be fully deprecated in the next 6 months on **1 June 2025**.
+- Old hostnames during this period will have reduced rate limits to facilitate migration to the new API.
+
+## Help us help you
+
+- If you need have increasing demand and growth in your app, please reach out to us.
+- If you need higher rate limits than the free access, please fill up this form.

docs/1-get-started.md

@@ -0,0 +1,86 @@
+---
+sidebar_label: "Get Started"
+description: "Get Started with setting up libraries, connection and local wallet to build with Jupiter API."
+title: "Get Started"
+---
+
+<head>
+    <title>Get Started</title>
+    <meta name="twitter:card" content="summary" />
+</head>
+
+To use Jupiter and interact with the Solana network, you need to install the necessary libraries and set up a connection to the network via an RPC endpoint.
+
+:::note about the guide
+In this guide, we'll be using the most used library, `web3.js` to get you started. Do note that there are other libraries using Rust instead of Javascript.
+:::
+
+## 1. Install required libraries
+
+Running this example requires a minimum of [NodeJS 16](https://nodejs.org/en/). In your command line terminal, install the libraries.
+
+The current documentation walkthrough was developed with
+- `"@solana/web3.js": "^1.95.4"`
+- `"@coral-xyz/anchor": "^0.30.1"`
+- `"@solana/spl-token": "^0.4.9"`
+- `"@jup-ag/referral-sdk": "^0.1.7"`
+
+```bash
+npm i @solana/web3.js@1
+npm i @coral-xyz/anchor
+npm i cross-fetch
+npm i bs58
+```
+
+## 2. Import from libraries
+
+Next, create a new Javascript/Typescript file and import these interfaces and functions.
+
+```jsx
+import { Connection, Keypair, VersionedTransaction } from '@solana/web3.js';
+import { Wallet } from '@coral-xyz/anchor';
+import bs58 from 'bs58';
+import fetch from 'cross-fetch';
+```
+
+## 3. Set up Connection
+
+Solana provides a [default RPC endpoint](https://solana.com/docs/core/clusters) to get started and in the example code, we will be using that. However, as your application grows, we recommend you to always use your own or provision a 3rd party provider’s RPC endpoint such as [Helius](https://helius.dev/) or [Triton](https://triton.one/).
+
+```jsx
+const connection = new Connection('https://api.mainnet-beta.solana.com');
+```
+
+## 4. Set up your Wallet
+
+You can paste in your private key for testing purposes but this is not recommended for production applications.
+
+If you want to store your private key in the project directly, you can do it via a `.env` file.
+
+```jsx
+// index.js
+import dotenv from 'dotenv';
+
+const wallet = new Wallet(Keypair.fromSecretKey(bs58.decode(process.env.PRIVATE_KEY || '')));
+
+console.log(wallet.publicKey.toBase58());
+```
+
+```
+// .env
+PRIVATE_KEY=""
+```
+
+If you have [created a wallet via Solana CLI](https://solana.com/docs/intro/installation#solana-cli-basics) and your private key is stored outside of your project, you can do it this way instead.
+
+```jsx
+import fs from 'fs';
+
+const privateKeyArray = JSON.parse(fs.readFileSync('/Users/user/.config/solana/id.json', 'utf8').trim());
+
+const wallet = new Wallet(Keypair.fromSecretKey(new Uint8Array(privateKeyArray)));
+
+console.log(wallet.publicKey.toBase58());
+```
+
+Now, you are all set up and ready to use one of our product’s APIs and send a transaction to the Solana network!

docs/100-swap-api/1-get-quote.md

@@ -0,0 +1,129 @@
+---
+sidebar_label: "Get Quote"
+description: "Start using Jupiter Swap API by getting a Quote."
+title: "Get Quote"
+---
+
+<head>
+    <title>Get Quote</title>
+    <meta name="twitter:card" content="summary" />
+</head>
+
+:::warning Please use the Swap API at your own discretion.
+
+The Jupiter UI at https://jup.ag/ contains multiple safeguards, warnings and default settings to guide our users to trade safer. Jupiter is not liable for lesses incurred by users on other platforms.
+
+If you need clarification or support, please reach out to us in [Discord](https://discord.gg/jup).
+:::
+
+The Quote API enables you to tap into the Jupiter routing engine, which accesses the deep liquidity available within the DEXes of Solana's DeFi ecosystem. In this guide, we will walkthrough how you can get a quote for a specific token pair and other related parameters.
+
+## Let’s Get Started
+
+In this guide, we will be using the Solana web3.js package.
+
+If you have not set up your environment to use the necessary libraries and the connection to the Solana network, please head over to [get started](../1-get-started.md).
+
+:::tip API Reference
+To fully utilize the Quote API, check out the [Quote API Reference](/docs/api/quote).
+:::
+
+## Quote API
+
+The root URL of the Quote API is as such.
+
+```
+https://api.jup.ag/quote
+```
+
+The most common trading pair on Solana is SOL and USDC, in order to get a quote for this specific token pair, you need to pass in the required parameters such as:
+
+| Parameters | Description |
+| --- | --- |
+| inputMint | The pubkey or token mint address e.g. So11111111111111111111111111111111111111112 |
+| outputMint | The pubkey or token mint address e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
+| amount | The number of **input** tokens before the decimal is applied, also known as the “raw amount” or “integer amount” in lamports for SOL or atomic units for all other tokens. |
+| slippageBps | The number of basis points you can tolerate to lose during time of execution. e.g. 1% = 100bps |
+
+## Get Quote
+
+Using the root URL and parameters to pass in, it is as simple as the example code below!
+
+```jsx
+const quoteResponse = await (
+    await fetch(
+        'https://api.jup.ag/quote/v1?inputMint=So11111111111111111111111111111111111111112&outputMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=100000000&slippageBps=50&restrictIntermediateTokens=true'
+    )
+  ).json();
+
+console.log(JSON.stringify(quoteResponse, null, 2));
+```
+
+From the above example, you should see this response.
+
+```json
+{
+  "inputMint": "So11111111111111111111111111111111111111112",
+  "inAmount": "100000000",
+  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+  "outAmount": "16198753",
+  "otherAmountThreshold": "16117760",
+  "swapMode": "ExactIn",
+  "slippageBps": 50,
+  "platformFee": null,
+  "priceImpactPct": "0",
+  "routePlan": [
+    {
+      "swapInfo": {
+        "ammKey": "5BKxfWMbmYBAEWvyPZS9esPducUba9GqyMjtLCfbaqyF",
+        "label": "Meteora DLMM",
+        "inputMint": "So11111111111111111111111111111111111111112",
+        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
+        "inAmount": "100000000",
+        "outAmount": "16198753",
+        "feeAmount": "24825",
+        "feeMint": "So11111111111111111111111111111111111111112"
+      },
+      "percent": 100
+    }
+  ],
+  "contextSlot": 299283763,
+  "timeTaken": 0.015257836
+}
+```
+
+:::tip
+`outAmount` refers to the best possible output amount based on the route at time of quote, this means that `slippageBps` does not affect.
+:::
+
+## What’s Next
+
+Now, you are able to get a quote, next steps is to submit a transaction to execute the swap based on the quote given. Let’s go!
+
+---
+
+## Additional Resources
+
+### Restrict Intermediate Tokens
+
+`restrictIntermediateTokens` can be set to `true` . If your route is routed through random intermediate tokens, it will fail more frequently. With this, we make sure that your route is only routed through highly liquid intermediate tokens to give you the best price and more stable route.
+
+### Legacy Transactions
+
+All Jupiter swaps are using Versioned Transactions and Address Lookup Tables. However, not all wallets support Versioned Transactions yet, so if you detect a wallet that does not support versioned transactions, you will need to set the `asLegacyTransaction` parameter to `true`.
+
+### Adding Fees
+
+By using the Quote API in your app, you can add a fee to charge your users. You can refer to the `platformFeeBps` parameter and to add it, you will need to set up a Referral Account through our Referral Program, read here to get started.
+
+:::note
+If you choose to set up platform fees on your app to charge your users, Jupiter will take 2.5% of the fee.
+:::
+
+### Direct Routes and Max Accounts
+
+These 2 parameters can be useful for those who are building your own programs or apps. `onlyDirectRoutes` essentially restricts the routing to only go through 1 market; whereas `maxAccounts` can provide you with flexibility to utilize other accounts in your transaction.
+
+:::warning unfavorable trades
+Please be aware that using these 2 parameters can often yield unfavorable trades or outcomes.
+:::