Wallets
Solana Server Wallets
Create and manage Solana wallets for backend applications using thirdweb's secure server wallet infrastructure.
Funding Required
Solana server wallets are not sponsored. You must fund your wallet with SOL to transact.
- Wallet Management: Create and list Solana wallets
- Balance & Transactions: Check balances, send SOL/SPL tokens, query transaction status
- Signing: Sign messages and transactions without broadcasting
- Token Swaps: Get quotes and execute swaps (mainnet only)
- Raw Transactions: Build and broadcast custom transactions with full instruction control
Create a Solana server wallet from the dashboard or via API.
Transfer SOL to your wallet address to cover transaction fees.
Send tokens, sign messages, execute swaps, or submit custom transactions.
fetch("https://api.thirdweb.com/v1/solana/wallets?page=1&limit=100", { method: "GET", headers: { "x-secret-key": "<your-project-secret-key>", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
pageintegerPage number for paginated results. Starts at 1.
Example:
1limitintegerMaximum number of wallets to return per page.
Example:
100fetch("https://api.thirdweb.com/v1/solana/wallets", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { label: "treasury-solana-wallet", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
labelRequiredUnique label to identify the wallet. Used for retrieval and management.
Example:
treasury-solana-walletfetch( "https://api.thirdweb.com/v1/solana/wallets/{address}/balance?tokenAddress=8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", { method: "GET", headers: { "x-secret-key": "<your-project-secret-key>", }, },);x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
addressstringRequiredPublic key of the Solana wallet.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BchainIdstringRequiredSolana network to query. Choose either solana:mainnet or solana:devnet.
tokenAddressstringSPL token mint address. Omit to retrieve native SOL balance.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BTransfer native SOL or SPL tokens. Automatically handles token account creation for SPL tokens.
POST
/v1/solana/sendfetch("https://api.thirdweb.com/v1/solana/send", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { from: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", to: "FhtwVYF1wKAm7fWmE2N5P2eCv13wt2aT8W4Q9NQ9YcJH", amount: "1000000", chainId: "solana:devnet", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
fromRequiredSolana wallet address that will sign and submit the transfer.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BtoRequiredDestination Solana address.
Example:
FhtwVYF1wKAm7fWmE2N5P2eCv13wt2aT8W4Q9NQ9YcJHamountRequiredAmount to transfer expressed in base units (lamports for SOL or token decimals).
Example:
1000000chainIdRequiredSolana network identifier in CAIP-2 format. Use "solana:mainnet" or "solana:devnet" for convenience, or full CAIP-2 format.
Example:
solana:devnetfetch("https://api.thirdweb.com/v1/solana/sign-message", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { from: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", message: "Welcome to thirdweb", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
fromRequiredThe Solana wallet address used for signing.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BmessageRequiredMessage to sign. Can be plain text or hexadecimal format (starting with 0x). The format is automatically detected.
Example:
Welcome to thirdwebSign a transaction without broadcasting. Provide a serialized transaction or instructions to assemble one.
fetch("https://api.thirdweb.com/v1/solana/sign-transaction", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { from: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", chainId: "solana:devnet", transaction: "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAECAwQFBg==", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
fromRequiredThe Solana wallet address that will sign the transaction.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BchainIdRequiredSolana network the transaction targets. Use solana:mainnet or solana:devnet.
Example:
solana:devnettransactionBase64 encoded Solana transaction to sign.
Example:
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAECAwQFBg==fetch("https://api.thirdweb.com/v1/solana/broadcast-transaction", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { chainId: "solana:devnet", signedTransaction: "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgIAAQIDBAUGBwgJ", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
chainIdRequiredSolana network the signed transaction targets. Use solana:mainnet or solana:devnet.
Example:
solana:devnetsignedTransactionRequiredBase64 encoded signed transaction to broadcast to the Solana network.
Example:
AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAgIAAQIDBAUGBwgJSubmit a transaction composed of one or more instructions. Transactions are queued and processed asynchronously.
fetch("https://api.thirdweb.com/v1/solana/transactions", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { from: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", chainId: "solana:devnet", instructions: [ { programId: "11111111111111111111111111111111", accounts: [ { address: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", isSigner: true, isWritable: true, }, { address: "FhtwVYF1wKAm7fWmE2N5P2eCv13wt2aT8W4Q9NQ9YcJH", isSigner: false, isWritable: true, }, ], data: "02000000e888b30000000000", encoding: "hex", }, ], },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
fromRequiredSolana wallet address that will sign and submit the transaction.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BchainIdRequiredSolana network identifier in CAIP-2 format. Use "solana:mainnet" or "solana:devnet" for convenience, or full CAIP-2 format.
Example:
solana:devnetinstructionsRequiredSet of instructions executed sequentially in a single transaction.
Example:
[ { "programId": "11111111111111111111111111111111", "accounts": [ { "address": "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", "isSigner": true, "isWritable": true }, { "address": "FhtwVYF1wKAm7fWmE2N5P2eCv13wt2aT8W4Q9NQ9YcJH", "isSigner": false, "isWritable": true } ], "data": "02000000e888b30000000000", "encoding": "hex" }]Failed to load OpenAPI specification: Path /v1/solana/transactions/{transactionId} not found in OpenAPI spec
Mainnet Only
Token swaps are only available on Solana mainnet.
fetch( "https://api.thirdweb.com/v1/solana/swap?address=8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B&tokenIn=8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B&tokenOut=8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", { method: "GET", headers: { "x-secret-key": "<your-project-secret-key>", }, },);x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
addressstringRequiredSolana wallet address that will execute the swap.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BtokenInstringRequiredInput token mint address (the token being sold).
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BtokenOutstringRequiredOutput token mint address (the token being purchased).
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BamountstringRequiredAmount of input token to swap, expressed in the smallest unit (e.g., lamports for SOL).
chainIdstringRequiredPOST
/v1/solana/swapfetch("https://api.thirdweb.com/v1/solana/swap", { method: "POST", headers: { "x-secret-key": "<your-project-secret-key>", }, body: { address: "8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5B", tokenIn: "So11111111111111111111111111111111111111112", tokenOut: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", amount: "100000000", chainId: "solana:mainnet", },});x-secret-keybackendProject secret key - for backend usage only. Should not be used in frontend code.
x-client-idfrontendProject client ID - for frontend usage on authorized domains.
x-ecosystem-idoptionalEcosystem ID - for ecosystem wallets.
x-ecosystem-partner-idoptionalEcosystem partner ID - for ecosystem wallets.
AuthorizationfrontendBearer token (JWT) for user wallet authentication
addressRequiredSolana wallet address that will execute the swap.
Example:
8JBLmveV4YF5AQ7EVnKJgyj6etGgVkPp3tYqQMTu3p5BtokenInRequiredInput token mint address (the token being sold).
Example:
So11111111111111111111111111111111111111112tokenOutRequiredOutput token mint address (the token being purchased).
Example:
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vamountRequiredAmount of input token to swap, expressed in the smallest unit (e.g., lamports for SOL).
Example:
100000000chainIdRequiredExample:
solana:mainnet{ "result": { "signature": "5ttCNobho7nk5F1Hh4pU4d9T2o1yAFn3p1w8z8jk2jKd9KWCKN6dzyuT5xP1ny4wz9f5xCLjAF6Y9s9EoTW4aE1X", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inputAmount": "100000000", "outputAmount": "95423156", "inputUsdValue": 10.5, "outputUsdValue": 10.48, "requestId": "uuid-1234-5678" }}
| Network | Identifier |
|---|---|
| Mainnet | solana:mainnet |
| Devnet | solana:devnet |