jup-ag · 0xYankee-Raccoons · Nov 21, 2024 · Nov 21, 2024 · Nov 21, 2024 · Nov 22, 2024
diff --git a/Moved/2-how-swap-works/2-how-swap-works.md b/Moved/2-how-swap-works/2-how-swap-works.md
@@ -17,11 +17,8 @@ The Jupiter Swap is a decentralized exchange aggregator designed to provide the
 Jupiter V3 introduced multiple improvements to the swap experience! 
 
 The Metropolis upgrade introduced Instant Routing, Dynamic Slippage, Smart Token Filtering, Ecosystem Token List and new Safety features.
-[Dive into these new features in detail here! ->](/guides/2-jupiter-spot/2-jupiter-swap/2-how-swap-works/1-metropolis-features.md)
 
 Metis, a routing protocol, was also introduced to improve route discovery, reducing slippage and scalability in V3.
-[Dive into key features of the Metis routing protocol here! ->](/guides/2-jupiter-spot/2-jupiter-swap/2-how-swap-works/3-metis-routing.md)
-
 
 ### Token Ledger For Increased Swap Success Rates
 

diff --git a/docs/100-swap-api/3-send-swap-transaction.md b/docs/100-swap-api/3-send-swap-transaction.md
@@ -134,7 +134,7 @@ We are using [Triton’s `getRecentPrioritizationFees`](https://docs.triton.one/
 
 ```jsx
 const swapResponse = await (
-  await fetch('https://api.jup.ag/swap/v1', {
+  await fetch('https://api.jup.ag/swap/v1/swap', {
       method: 'POST',
       headers: {
       'Content-Type': 'application/json'
@@ -164,7 +164,7 @@ When `true`, it allows the transaction to utilize a dynamic compute unit rather
 
 ```jsx
 const swapTransaction = await (
-  await fetch('https://api.jup.ag/swap/v1', {
+  await fetch('https://api.jup.ag/swap/v1/swap', {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json'
@@ -192,7 +192,7 @@ To understand Dynamic Slippage better, you can read here:
 
 ```jsx
 const swapTransaction = await (
-  await fetch('https://api.jup.ag/swap/v1', {
+  await fetch('https://api.jup.ag/swap/v1/swap', {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json'
@@ -259,7 +259,7 @@ Additionally, Jito enables bundling transactions to ensure they execute together
 
 ```jsx
 const swapTransaction = await (
-  await fetch('https://api.jup.ag/swap/v1', {
+  await fetch('https://api.jup.ag/swap/v1/swap', {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json'

diff --git a/docs/200-perp-api/1-perp-api.md b/docs/200-perp-api/1-perp-api.md
@@ -0,0 +1,14 @@
+---
+sidebar_label: "Perp API"
+description: "Use the Jupiter Perp API to trade or analyze."
+title: "Coming Soon!"
+---
+
+<head>
+    <title>Coming Soon!</title>
+    <meta name="twitter:card" content="summary" />
+</head>
+
+:::warning
+The Perp API for trading and analyzing is still a **work in progress**, stay tuned!
+:::
diff --git a/docs/200-perp-api/204-custody-account.md b/docs/200-perp-api/204-custody-account.md
@@ -49,6 +49,7 @@ Each `Custody` account contains the following data:
 | `targetRatioBps`   | **Type:** `u64`<br /><br />The target weightage (in basis points) for the custody in the JLP pool. |
 | `assets`           | **Type:** [`Assets`](#assets)<br /><br />Contains data used to calculate PNL, AUM, and core business logic for the program. |
 | `fundingRateState` | **Type:** [`FundingRateState`](#fundingratestate)<br /><br />Contains data used to calculate borrow fees for open positions. |
+| `jumpRateState`    | **Type:** [`JumpRateState`](#jumpratestate)<br /><br />Contains data used to calculate borrow fees for open positions. |
 
 ### `PricingParams`
 
@@ -76,4 +77,13 @@ Each `Custody` account contains the following data:
 | --- | --- |
 | `cumulativeInterestRate` | **Type:** `u128`<br /><br />Traders are required to pay hourly borrow fees for opening leveraged positions. This fee is calculated based on two primary factors: the size of the trader's position and the current utilization of the pool for the custody.<br /><br />To calculate borrow fees more efficiently, each custody account contains a value called `cumulativeInterestRate`.<br /><br />Correspondingly, each position account stores a `cumulativeInterestSnapshot` which captures the value of `cumulativeInterestRate` at the time of the position's last update. Whenever there's a change in either the borrowed assets or the total assets within a custody, the `cumulativeInterestRate` for the custody is updated.<br /><br />The difference between the custody's `cumulativeInterestRate` and the position's `cumulativeInterestSnapshot` is then used to calculate the position's borrow fees. |
 | `lastUpdate` | **Type:** `i64`<br /><br />The UNIX timestamp for when the custody's borrow fee data was last updated. |
-| `hourlyFundingDbps` | **Type:** `u64`<br /><br />A constant used to calculate the hourly borrow fees for the custody. The Jupiter Perpetuals exchange works with Gauntlet and Chaos Labs to update and fine tune the `hourlyFundingDbps` to respond to traders' feedback and market conditions. |
+| `hourlyFundingDbps` | **Type:** `u64`<br /><br />**NOTE: This will be deprecated in the near future.** A constant used to calculate the hourly borrow fees for the custody. The Jupiter Perpetuals exchange works with Gauntlet and Chaos Labs to update and fine tune the `hourlyFundingDbps` to respond to traders' feedback and market conditions. |
+
+### `JumpRateState`
+
+| Field | Description |
+| --- | --- |
+| `minRateBps` | **Type:** `u64`<br /><br />The lowest borrow rate, applied at 0% utilization. |
+| `maxRateBps` | **Type:** `u64`<br /><br />The highest borrow rate, applied at 100% utilization. |
+| `targetRateBps` | **Type:** `u64`<br /><br />The borrow rate when utilization reaches its target level. |
+| `targetUtilizationRate` | **Type:** `u64`<br /><br />The optimal utilization level for the custody. |
diff --git a/docs/200-perp-api/205-price-feed-account.md b/docs/200-perp-api/205-price-feed-account.md
@@ -0,0 +1,28 @@
+---
+sidebar_label: "Price Feed Accounts"
+description: "Understand and integrate the Jupiter Perp Program."
+title: "Price Feed Accounts"
+---
+
+<head>
+    <title>Price Feed Accounts</title>
+    <meta name="twitter:card" content="summary" />
+</head>
+
+This page contains an overview of the **Solana account types** used in the Jupiter Perpetuals Program, and specifically the `PriceFeed` account.
+
+The `PriceFeed` account is a struct which represents a set of parameters and states associated to price data managed by the Dove Oracle Program which consists of the following price feeds.
+
+| Asset | Price Feed Account |
+|-------|----------------|
+| SOL | [39cWjvHrpHNz2SbXv6ME4NPhqBDBd4KsjUYv5JkHEAJU](https://solscan.io/account/39cWjvHrpHNz2SbXv6ME4NPhqBDBd4KsjUYv5JkHEAJU) |
+| ETH | [5URYohbPy32nxK1t3jAHVNfdWY2xTubHiFvLrE3VhXEp](https://solscan.io/account/5URYohbPy32nxK1t3jAHVNfdWY2xTubHiFvLrE3VhXEp) |
+| BTC | [4HBbPx9QJdjJ7GUe6bsiJjGybvfpDhQMMPXP1UEa7VT5](https://solscan.io/account/4HBbPx9QJdjJ7GUe6bsiJjGybvfpDhQMMPXP1UEa7VT5) |
+| USDC | [A28T5pKtscnhDo6C1Sz786Tup88aTjt8uyKewjVvPrGk](https://solscan.io/account/A28T5pKtscnhDo6C1Sz786Tup88aTjt8uyKewjVvPrGk) |
+| USDT | [AGW7q2a3WxCzh5TB2Q6yNde1Nf41g3HLaaXdybz7cbBU](https://solscan.io/account/AGW7q2a3WxCzh5TB2Q6yNde1Nf41g3HLaaXdybz7cbBU) |
+
+:::tip Example Typescript Repository
+[The code snippet in the examples repo shows how to fetch and stream onchain price updates from the accounts above](https://github.com/julianfssen/jupiter-perps-anchor-idl-parsing/blob/main/src/examples/poll-and-stream-oracle-price-updates.ts)
+
+You can also find the [Custody Account fields in the repository](https://github.com/julianfssen/jupiter-perps-anchor-idl-parsing/blob/main/src/idl/doves-idl.ts) or on a [blockchain explorer](https://solscan.io/account/DoVEsk76QybCEHQGzkvYPWLQu9gzNoZZZt3TPiL597e#anchorProgramIdl).
+:::
diff --git a/docs/dex-integration.md b/docs/dex-integration.md
@@ -25,7 +25,7 @@ Our top priority is securing the best prices and the best token selection for ou
 Given the amount of integration work involved:
 
 - A DEX must have enough liquidity to be useful for trading and to attract volume, as of 1 January 2025, minimum DEX TVL is $500,000.
-- Each market/pool must have a [minimum liquidity](../guides/general/get-your-token-on-jupiter) to show up on Jupiter, as of 1 January 2025, minimum market liquidity is $500.
+- Each market/pool must have a [minimum liquidity](../guides/spot/instant/how-to-get-your-token-on-jupiter) to show up on Jupiter, as of 1 January 2025, minimum market liquidity is $500.
 
 ### Markets API
 - This API should track all markets/pools that is listed or delisted, this will allow us to automatically track new markets as you add them to your DEX.