Skip to content

feat: perps api #771

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
0xYankee-Raccoons wants to merge 18 commits into
base: main
Choose a base branch
from
Open

feat: perps api #771

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
1bc8636
feat: perps api
0xYankee-Raccoons Oct 30, 2025
faaac3b
chore: update
0xYankee-Raccoons Nov 5, 2025
5adef3a
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Nov 5, 2025
5832e4d
chore: update
0xYankee-Raccoons Nov 5, 2025
4fb9a34
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Nov 5, 2025
bbfb2c2
chore: fix copy
0xYankee-Raccoons Nov 5, 2025
0475d9e
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Nov 12, 2025
bea6993
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Nov 14, 2025
3706236
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Nov 25, 2025
11c79a1
chore: update
0xYankee-Raccoons Nov 25, 2025
2893538
:wqerge branch 'main' into feat/perps-api
0xYankee-Raccoons Dec 2, 2025
57029b2
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Dec 8, 2025
368a965
chore: add api key auth
0xYankee-Raccoons Dec 8, 2025
4534d07
chore: fix perps nav
0xYankee-Raccoons Dec 8, 2025
cf2c469
chore: jlp checkpoint
0xYankee-Raccoons Dec 9, 2025
678b342
chore: complete jlp doc
0xYankee-Raccoons Dec 10, 2025
d1d94ba
chore: fees doc checkpoint
0xYankee-Raccoons Dec 10, 2025
10f0e54
Merge branch 'main' into feat/perps-api
0xYankee-Raccoons Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .DS_Store
View file
Open in desktop
Binary file not shown.
3 changes: 3 additions & 0 deletions api-reference/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,9 @@ description: "Overview of Jupiter API Reference"
<Card title="Lend (Beta)" href="/api-reference/lend" icon="folder-open" horizontal>
1 item
</Card>
<Card title="Perps (Beta)" href="/api-reference/perps" icon="folder-open" horizontal>
4 items
</Card>
<Card title="Trigger" href="/api-reference/trigger" icon="folder-open" horizontal>
5 items
</Card>
Expand Down
2 changes: 1 addition & 1 deletion api-reference/lend.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@ description: "Overview of Jupiter Lend API"

<CardGroup>
<Card title="Earn (Beta)" href="/api-reference/lend/earn" icon="folder-open" horizontal>
11 items
11 items
</Card>
</CardGroup>
20 changes: 20 additions & 0 deletions api-reference/perps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Perps (Beta)"
sidebarTitle: "Overview"
description: "Overview of Jupiter Perps API"
---

<CardGroup>
<Card title="Transaction Execution" href="/api-reference/perps/post-transaction-execute" icon="folder-open" horizontal>
1 item
</Card>
<Card title="Trading" href="/api-reference/perps/trading-overview" icon="folder-open" horizontal>
23 items
</Card>
<Card title="JLP" href="/api-reference/perps/get-jlp-info" icon="folder-open" horizontal>
3 items
</Card>
<Card title="JLP Lending" href="/api-reference/perps/get-lending-info" icon="folder-open" horizontal>
5 items
</Card>
</CardGroup>
3 changes: 3 additions & 0 deletions api-reference/perps/delete-orders-limit.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml delete /orders/limit
---
3 changes: 3 additions & 0 deletions api-reference/perps/delete-tpsl-with-fee.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml delete /tpsl-with-fee
---
3 changes: 3 additions & 0 deletions api-reference/perps/delete-tpsl.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml delete /tpsl
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-jlp-info.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /jlp-info
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-lending-history.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /lending/history
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-lending-info.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /lending/info
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-lending-positions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /lending/positions
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-market-stats.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /market-stats
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-orders-expired.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /orders/expired
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-orders-limit.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /orders/limit
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-pool-info.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /pool-info
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-positions-collateral-limits.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /positions/collateral-limits
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-positions.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /positions
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-top-traders.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /top-traders
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-trader-stats.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /trader-stats
---
3 changes: 3 additions & 0 deletions api-reference/perps/get-trades.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml get /trades
---
3 changes: 3 additions & 0 deletions api-reference/perps/patch-orders-limit.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml patch /orders/limit
---
3 changes: 3 additions & 0 deletions api-reference/perps/patch-tpsl-with-fee.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml patch /tpsl-with-fee
---
3 changes: 3 additions & 0 deletions api-reference/perps/patch-tpsl.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml patch /tpsl
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-jlp-burn.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /jlp/burn
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-jlp-mint.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /jlp/mint
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-lending-deposit-borrow.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /lending/deposit-borrow
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-lending-pay-withdraw.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /lending/pay-withdraw
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-orders-limit.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /orders/limit
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-positions-close-all.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /positions/close-all
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-positions-decrease-with-fee.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /positions/decrease-with-fee
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-positions-decrease.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /positions/decrease
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-positions-increase-with-fee.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /positions/increase-with-fee
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-positions-increase.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /positions/increase
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-tpsl-with-fee.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /tpsl-with-fee
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-tpsl.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /tpsl
---
3 changes: 3 additions & 0 deletions api-reference/perps/post-transaction-execute.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
---
openapi: /openapi-spec/perps/perps.yaml post /transaction/execute
---
20 changes: 20 additions & 0 deletions api-reference/perps/trading-overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: "Trading Overview"
sidebarTitle: "Overview"
description: "Overview of Trading Endpoints in Jupiter Perps API"
---

<CardGroup>
<Card title="Informational" href="/api-reference/perps/get-market-stats" icon="folder-open" horizontal>
9 items
</Card>
<Card title="Positions" href="/api-reference/perps/post-positions-increase" icon="folder-open" horizontal>
5 items
</Card>
<Card title="Limit" href="/api-reference/perps/post-orders-limit" icon="folder-open" horizontal>
3 items
</Card>
<Card title="TPSL" href="/api-reference/perps/post-tpsl" icon="folder-open" horizontal>
6 items
</Card>
</CardGroup>
129 changes: 123 additions & 6 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -169,16 +169,53 @@
"icon": "chart-line",
"groups": [
{
"group": " ",
"pages": ["docs/perps/index"]
"group": "About Perps",
"pages": [
"docs/perps/index",
"docs/perps/get-started"
]
},
{
"group": "Architecture",
"pages": [
"docs/perps/jlp",
"docs/perps/oracles",
"docs/perps/fees",
"docs/perps/liquidation",
"docs/perps/jlp-lend"
]
},
{
"group": "Perps API",
"pages": [
"docs/perps/transaction-execution",
{
"group": "Trading",
"pages": [
"docs/perps/trading/position-data",
"docs/perps/trading/position-management",
"docs/perps/trading/limit-orders",
"docs/perps/trading/tpsl-orders"
]
},
{
"group": "JLP",
"pages": [
"docs/perps/jlp/getting-jlp",
"docs/perps/jlp-lend/position-data",
"docs/perps/jlp-lend/position-management"
]
}
]
},
{
"group": "Perps Program",
"pages": [
"docs/perps/position-account",
"docs/perps/position-request-account",
"docs/perps/pool-account",
"docs/perps/custody-account"
"docs/perps/program/index",
"docs/perps/program/position-account",
"docs/perps/program/position-request-account",
"docs/perps/program/pool-account",
"docs/perps/program/custody-account"
]
}
]
Expand Down Expand Up @@ -418,6 +455,86 @@
}
]
},
{
"group": "Perps",
"tag": "BETA",
"pages": [
"api-reference/perps",
{
"group": "Transaction Execution",
"pages": [
"api-reference/perps/post-transaction-execute"
]
},
{
"group": "Trading",
"pages": [
"api-reference/perps/trading-overview",
{
"group": "Informational",
"pages": [
"api-reference/perps/get-market-stats",
"api-reference/perps/get-trader-stats",
"api-reference/perps/get-top-traders",
"api-reference/perps/get-pool-info",
"api-reference/perps/get-positions",
"api-reference/perps/get-positions-collateral-limits",
"api-reference/perps/get-orders-limit",
"api-reference/perps/get-orders-expired",
"api-reference/perps/get-trades"
]
},
{
"group": "Positions",
"pages": [
"api-reference/perps/post-positions-increase",
"api-reference/perps/post-positions-increase-with-fee",
"api-reference/perps/post-positions-decrease",
"api-reference/perps/post-positions-decrease-with-fee",
"api-reference/perps/post-positions-close-all"
]
},
{
"group": "Limit Orders",
"pages": [
"api-reference/perps/post-orders-limit",
"api-reference/perps/patch-orders-limit",
"api-reference/perps/delete-orders-limit"
]
},
{
"group": "TPSL",
"pages": [
"api-reference/perps/post-tpsl",
"api-reference/perps/post-tpsl-with-fee",
"api-reference/perps/patch-tpsl",
"api-reference/perps/patch-tpsl-with-fee",
"api-reference/perps/delete-tpsl",
"api-reference/perps/delete-tpsl-with-fee"
]
}
]
},
{
"group": "JLP",
"pages": [
"api-reference/perps/get-jlp-info",
"api-reference/perps/post-jlp-mint",
"api-reference/perps/post-jlp-burn"
]
},
{
"group": "JLP Lending",
"pages": [
"api-reference/perps/get-lending-info",
"api-reference/perps/get-lending-positions",
"api-reference/perps/get-lending-history",
"api-reference/perps/post-lending-deposit-borrow",
"api-reference/perps/post-lending-pay-withdraw"
]
}
]
},
{
"group": "Trigger",
"pages": [
Expand Down
Loading