Skip to content

Commit c27d3f8

Browse files
docs: [submit] rewrite overview with accurate infrastructure details
Replace marketing-forward cards with technically accurate competitive advantage section. Correctly frames SWQoS as reserved bandwidth (not direct block production), documents Beam TPU forwarder, DoubleZero, and fiber infrastructure. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent ba3fbe7 commit c27d3f8

2 files changed

Lines changed: 14 additions & 22 deletions

File tree

llms.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ Token swap API with managed execution (/order) and custom transaction building (
6363

6464
- [Build](https://dev.jup.ag/docs/swap/build/index.md): How to use Jupiter's Router path via the GET /swap/v2/build endpoint to get raw swap instructions for building custom transactions. Uses Metis onchain routing only (no JupiterZ RFQ market makers). Returns computeBudgetInstructions, setupInstructions, swapInstruction, cleanupInstruction, otherInstructions, tipInstruction, and address lookup tables. Integrators assemble their own transaction, add custom instructions (CPI, memo, SOL transfer, etc.), simulate for compute units, compile to v0 transaction, sign, and send via their own RPC or via /submit for Jupiter's transaction landing. Optional parameters include slippageBps (number or 'rtse' for RTSE), tipAmount (for /submit), mode='fast', maxAccounts, platformFeeBps, payer (gasless). /execute is not available for /build. No Jupiter swap fees. Full @solana/kit and @solana/web3.js TypeScript code examples included.
6565
- [Common Instructions](https://dev.jup.ag/docs/swap/build/common-instructions.md): Reference of common Solana instructions that developers compose with Jupiter /build swap instructions. Covers: creating associated token accounts (ATA) with createAssociatedTokenAccountIdempotent, closing token accounts to reclaim rent, adding SOL transfers (tips, payments), attaching memo instructions, and general guidance on instruction ordering. Each instruction includes a @solana/kit code example showing how to build the instruction and where to place it relative to the swap instructions.
66-
- [Transaction Submission](https://dev.jup.ag/docs/transaction/submit.md): How to submit signed transactions through Jupiter's transaction landing infrastructure using POST api.jup.ag/tx/v1/submit. Jupiter operates one of the highest-staked validators on Solana and opens its landing pipeline to integrators. Accepts any signed Solana transaction (swaps, transfers, program calls) with a SOL tip (minimum 0.001 SOL / 1,000,000 lamports) to one of 16 permitted accounts. Zero credit cost, available on all plans including free and keyless access. Provides MEV protection (transactions are not exposed to public mempools), sub-second landing through direct block production, and the same infrastructure that powers Jupiter's own products. Can run in parallel with existing RPC submission for zero-risk comparison. Use /build's tipAmount parameter for automatic tip inclusion. Differs from /execute which is tied to the /order flow and uses swap fees instead of SOL tips.
66+
- [Transaction Submission](https://dev.jup.ag/docs/transaction/submit.md): How to submit signed transactions through Jupiter's proprietary transaction landing infrastructure using POST api.jup.ag/tx/v1/submit. Jupiter's infrastructure stack includes one of the highest-staked validators on Solana (providing SWQoS reserved bandwidth), a custom TPU forwarder (Beam), DoubleZero fiber network, and ultra-low-latency fiber from Tokyo to Frankfurt. Accepts any signed Solana transaction (swaps, transfers, program calls) with a SOL tip (minimum 0.001 SOL / 1,000,000 lamports) to one of 16 permitted accounts. Zero credit cost, available on all plans including free and keyless access. Provides MEV protection by removing all intermediaries between your transaction and the leader. Can run in parallel with existing RPC submission for zero-risk comparison. Use /build's tipAmount parameter for automatic tip inclusion. Differs from /execute which is tied to the /order flow and uses swap fees instead of SOL tips.
6767
- [Build Transaction](https://dev.jup.ag/docs/openapi-spec/swap/v2/swap.yaml): GET /build endpoint for Jupiter Swap API V2 at api.jup.ag/swap/v2/build. Returns a swap quote with raw instructions (computeBudgetInstructions, setupInstructions, swapInstruction, cleanupInstruction, otherInstructions) and address lookup tables. Integrators build their own transactions, add custom instructions (CPI, memo, transfer), simulate, sign, and send via their own RPC. Metis-only routing. No Jupiter swap fees. /execute is not available for /build transactions.
6868
- [Submit Transaction](https://dev.jup.ag/docs/openapi-spec/transaction/transaction.yaml): POST /submit endpoint for Jupiter Transaction API at api.jup.ag/tx/v1/submit. Submits any valid signed Solana transaction through Jupiter's transaction landing infrastructure. Requires a SOL tip of at least 0.001 SOL (1,000,000 lamports) to one of the 16 permitted tip receivers. Request body: signedTransaction (base64-encoded signed transaction). Response: signature (transaction signature). Works with /build swap transactions, non-Jupiter transactions, or any other signed transaction. Requires x-api-key header.
6969

transaction/submit.mdx

Lines changed: 13 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,27 @@
11
---
22
title: "Transaction Submission"
3-
description: "Submit transactions through Jupiter's validator for fast landing and MEV protection"
4-
llmsDescription: "How to submit signed transactions through Jupiter's transaction landing infrastructure using POST api.jup.ag/tx/v1/submit. Jupiter operates one of the highest-staked validators on Solana and opens its landing pipeline to integrators. Accepts any signed Solana transaction (swaps, transfers, program calls) with a SOL tip (minimum 0.001 SOL / 1,000,000 lamports) to one of 16 permitted accounts. Zero credit cost, available on all plans including free and keyless access. Provides MEV protection (transactions are not exposed to public mempools), sub-second landing through direct block production, and the same infrastructure that powers Jupiter's own products. Can run in parallel with existing RPC submission for zero-risk comparison. Use /build's tipAmount parameter for automatic tip inclusion. Differs from /execute which is tied to the /order flow and uses swap fees instead of SOL tips."
3+
description: "Submit transactions through Jupiter's proprietary infrastructure for fast landing and MEV protection"
4+
llmsDescription: "How to submit signed transactions through Jupiter's proprietary transaction landing infrastructure using POST api.jup.ag/tx/v1/submit. Jupiter's infrastructure stack includes one of the highest-staked validators on Solana (providing SWQoS reserved bandwidth), a custom TPU forwarder (Beam), DoubleZero fiber network, and ultra-low-latency fiber from Tokyo to Frankfurt. Accepts any signed Solana transaction (swaps, transfers, program calls) with a SOL tip (minimum 0.001 SOL / 1,000,000 lamports) to one of 16 permitted accounts. Zero credit cost, available on all plans including free and keyless access. Provides MEV protection by removing all intermediaries between your transaction and the leader. Can run in parallel with existing RPC submission for zero-risk comparison. Use /build's tipAmount parameter for automatic tip inclusion. Differs from /execute which is tied to the /order flow and uses swap fees instead of SOL tips."
55
---
66

7-
`/submit` sends your signed transactions through Jupiter's transaction landing infrastructure. Jupiter operates [one of the highest-staked validators on Solana](https://solanabeach.io/validators), and `/submit` opens the same pipeline that lands Jupiter's own swap transactions to any integrator. Your transactions go directly to Jupiter's validator with MEV protection, sub-second landing, and zero credit cost.
8-
9-
## Overview
10-
11-
<CardGroup cols={2}>
12-
<Card title="High-Stake Validator" icon="tower-broadcast">
13-
One of the most staked validators on Solana. More stake means more leader slots and more chances to include your transaction directly in a block.
14-
</Card>
15-
<Card title="MEV Protection" icon="shield-halved">
16-
Transactions go directly to Jupiter's validator, removing all intermediaries that could be malicious actors. The same infrastructure that protects millions of Jupiter swaps daily.
17-
</Card>
18-
<Card title="Sub-Second Landing" icon="bolt">
19-
When Jupiter's validator is the current leader, your transaction can be included in the very next block.
20-
</Card>
21-
<Card title="Free to Use" icon="circle-check">
22-
Zero API credits on all plans, including free and keyless access. The only cost is the SOL tip in your transaction.
23-
</Card>
24-
</CardGroup>
7+
`/submit` sends your signed transactions through Jupiter's proprietary transaction landing infrastructure. This is the same infrastructure that powers Jupiter's own swap products, now open to any integrator. It accepts any valid signed Solana transaction with a SOL tip, costs zero API credits, and works on all plans including keyless access.
8+
9+
## Why /submit is competitive
10+
11+
Jupiter's transaction landing stack is purpose-built for high throughput and low latency:
12+
13+
- **SWQoS via high-stake validator.** Jupiter operates [one of the highest-staked validators on Solana](https://solanabeach.io/validators). Solana's Stake-Weighted Quality of Service (SWQoS) reserves ~80% of a leader's TPU capacity for staked validators proportional to their stake. Higher stake means more reserved bandwidth when forwarding transactions to the current leader.
14+
- **Beam (custom TPU forwarder).** Jupiter's own TPU client bypasses standard RPC nodes and sends transactions directly to leaders via staked QUIC connections. This removes intermediaries that could be malicious actors and eliminates RPC processing overhead.
15+
- **DoubleZero.** Dedicated fiber network for validator communication, with FPGA-based spam filtering and transaction deduplication at the network edge. Cleaner transaction set, faster propagation between validators.
16+
- **Ultra-low-latency fiber.** Private fiber links from Tokyo to Frankfurt reduce physical propagation time between Jupiter's infrastructure and leader validators globally.
17+
- **High-performance, scalable infrastructure.** Built to handle the volume of Jupiter's own products, where millions of swaps land daily.
2518

2619
## How it works
2720

2821
1. Build your transaction (using `/build`, or assemble your own)
2922
2. Include a SOL tip (minimum 0.001 SOL) to one of 16 permitted accounts
3023
3. Sign the transaction
3124
4. POST the base64-encoded signed transaction to `https://api.jup.ag/tx/v1/submit`
32-
5. Jupiter lands the transaction through its validator pipeline
3325

3426
For `/build` transactions, use the `tipAmount` parameter to have the tip instruction included automatically. For non-Jupiter transactions, add a standard SOL transfer instruction to one of the [permitted tip accounts](#standalone-tip-instructions).
3527

0 commit comments

Comments
 (0)