Wallets
Create, list, delete and restore the trading wallets of your account, and manage watched addresses.
Wallets are the keypairs Proxima holds for your account and signs with. You generate them per network type (svm or evm), promote them from a launch, or buy them on the marketplace. List wallets returns them per chain with their native balance, volume, PnL, folders and trade routing.
Deleting a wallet archives it instead of destroying the key: List deleted wallets shows archived wallets and Restore deleted wallets brings them back within your license's wallet cap. Watch wallets are a separate list of external addresses you follow; Proxima holds no key for them.
Trade routing decides, per chain, which platform builds a wallet's trades. Retrieve the routing config lists the platforms and Set wallet routing assigns wallets to them.
- GET
/wallets/get/{chain_id} - GET
/wallets/routing/config - POST
/wallets/routing/{chain_id} - POST
/wallets/{network_type}/add - POST
/wallets/remove - GET
/wallets/deleted/{chain_id} - POST
/wallets/deleted/restore - POST
/wallets/add-from-launch - POST
/wallets/{network_type}/watch/add - POST
/wallets/rename - GET
/wallets/watch/list - POST
/wallets/watch/remove
The Wallet object
A trading wallet of the account, with its stats on the requested chain. Per-chain maps are keyed by chain ID and only contain the chains the response covers.
Attributes
-
pubkeystringWallet address: a base58 public key on SVM, a0xaddress on EVM. -
network_typeenumNetwork the wallet belongs to.Possible valuessvmevm -
created_atintegerUnix timestamp (seconds) at which the wallet was added to the account. -
launchesarray<integer>Launches the wallet has been used in. -
tag_idsarray<integer>IDs of the folders the wallet belongs to. -
funding_sourcestring | nullHow the wallet was funded:None,Wallet(a direct transfer), or the ID of the exchange that funded it, for examplebinance. -
from_marketplacebooleanWhether the wallet was delivered by a marketplace order. -
native_balancesobjectNative balance per chain ID, in base units (lamports or wei), as decimal strings. -
tx_countobjectNumber of transactions per chain ID: an integer string on Solana, a number on EVM chains. -
volumeobjectTraded volume per chain ID, in native base units, as decimal strings. -
pnl_nativeobjectPnL per chain ID, in native base units, as decimal strings. On Solana, a loss reads"0"; on EVM chains, the value keeps its sign. -
pnl_usdobjectPnL per chain ID, in micro-USD. On Solana, an integer string; a loss reads"0". On EVM chains, always the number0: USD PnL is not tracked there. -
pnl_usd_totalintegerPnL across chains, in micro-USD, as a JSON number. A loss reads0, and EVM wallets always read0. -
funded_atobjectUnix timestamp (seconds) of the last funding per chain ID;0when never funded. -
routingstringID of the platform the wallet's trades are built through on the requested chain.directby default. See Retrieve the routing config.
The Watch wallet object
An external address on your watchlist. Proxima holds no key for it, so it cannot sign or be withdrawn from.
Attributes
-
pubkeystringWatched address. -
network_typeenumNetwork of the address.Possible valuessvmevm -
namestring | nullLabel, at most 25 characters. -
iconstring | nullShort text icon (for example an emoji), at most 20 characters. -
image_linkstring | nullURL of the uploaded avatar image. -
is_bookmarkbooleanWhether the address is bookmarked. -
created_atintegerUnix timestamp (seconds) at which the address was added.
List wallets
/wallets/get/{chain_id} Returns the active wallets of the account on the network of a chain, with their stats on that chain.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Wallets of the chain's network type are returned (all SVM wallets for sol, all EVM wallets for an EVM chain), with balances and stats for chain_id. Folders are returned alongside: the list for the chain's network is filled, the other is empty. The web app calls this to render the Wallets page, the delete-wallets flow and the sell-all-tokens flow.
Path parameters
-
chain_idenum RequiredChain ID.Possible valuessolethbscbaserobinhoodmonadarcxlayer
Returns 200 OK · application/json
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | The chain is not supported. Use a supported chain_id; monad is no longer accepted. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.wallets.getWallets(chainId) src/lib/proxima/endpoints/wallets/wallets.ts
Retrieve the routing config
/wallets/routing/config Lists every platform a wallet's trades can be built through, with its fee and chains.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The first platform is always direct (shown as Proxima), available on every chain; the other platforms build trades on sol only. The web app loads it for the trade routing modals and filters platforms by chains.
Parameters
No parameters.
Returns 200 OK · application/json
-
defaultstringPlatform a wallet uses when none is set:direct. -
platformsarray<object>Available platforms.Child attributes 5
-
idstringPlatform ID used as a key in Set wallet routing.directis Proxima's own route. -
labelstringDisplay name. -
fee_bpsintegerFee a trade routed this way pays the platform, in basis points of its quote leg. -
fee_pctnumberfee_bpsas a percentage. -
chainsarray<string>Chain IDs the platform builds trades on.
-
Errors
Only the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.wallets.getRoutingConfig() src/lib/proxima/endpoints/wallets/wallets.ts
Set wallet routing
/wallets/routing/{chain_id} Sets the platform each listed wallet trades through on a chain.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Wallets not listed keep their routing, so sending the same body again leaves the same state.
The body maps platform IDs to the addresses that should trade through them. Platform IDs are matched case-insensitively, and routing a wallet to direct removes its routing. Wallets not listed keep their current routing. The web app sends it from the per-wallet routing modal and from the bulk trades-routing modal, which splits the selection across platforms by share.
Path parameters
-
chain_idenum RequiredChain the routing applies to.Possible valuessolethbscbaserobinhoodmonadarcxlayer
Body parameters application/json
-
<platform_id>array<string> RequiredOne key per platform ID from the routing config; the value lists the wallet addresses to route through it. Onlydirectbuilds trades outsidesol. At least one address is required overall.
Returns 200 OK · application/json
-
okbooleantrueon success. -
routingobjectPlatform ID now set for each address, keyed by address. EVM addresses come back lowercase.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain_id is not a chain the API serves. Use a supported chain_id; monad is no longer accepted. |
| 400 | bad_request | The body is not a JSON object whose values are arrays of address strings. Send an object mapping platform IDs to arrays of addresses. |
| 400 | bad_request | A key is not a platform ID, or names a platform that does not build trades on the chain. The whole batch is refused. Use platform IDs whose chains include the chain in Retrieve the routing config. |
| 400 | bad_request | An address is not a valid address of the chain. The whole batch is refused. Send Solana addresses for sol and 0x addresses for EVM chains. |
| 400 | bad_request | An address appears twice in the body, under two platforms or twice under one. The whole batch is refused. List each address once. |
| 400 | bad_request | The body lists no address. Send at least one address. |
| 400 | bad_request | Some addresses are not wallets of the account; the message lists them. The whole batch is refused. Route only wallets from List wallets. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.setRouting(chainId, batch) src/lib/proxima/endpoints/wallets/wallets.ts
Create wallets
/wallets/{network_type}/add Generates new wallets on a network type and optionally adds them to folders.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Each call generates new wallets. Before retrying, call List wallets and check whether the new wallets are already there.
Path parameters
-
network_typeenum RequiredNetwork type:svm(Solana) orevm(every EVM chain).Possible valuessvmevm
Body parameters application/json
-
amount_to_generateinteger RequiredNumber of new keypairs to generate. -
secret_keysarray<string> OptionalPrivate keys to import alongside the generated wallets. Requires key-management rights on the license. -
tag_idsarray<integer> OptionalIDs of folders to add the new wallets to.
Returns 200 OK · application/json
-
walletsarray<string>Addresses of the wallets added. -
tag_idsarray<integer>Folder IDs the wallets were added to.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | network_type is not svm or evm. Use svm or evm as network_type. |
| 400 | bad_request | On SVM, an entry of secret_keys is not a valid keypair. Check that every entry of secret_keys is a valid Solana secret key. |
| 400 | bad_request | On EVM, an entry of secret_keys is not a valid private key. Check that every entry of secret_keys is a valid hex private key. |
| 400 | bad_request | A folder in tag_ids is not on the account. Use folder IDs from the tags of List wallets. |
| 400 | bad_request | On EVM, amount_to_generate is 0 and no secret_keys were sent. Set amount_to_generate above 0 or send secret_keys. |
| 403 | forbidden | secret_keys was sent and the license cannot import keys. Remove secret_keys, or use a license with key-management rights. |
| 422 | unprocessable | The request would exceed the license's wallet limit. On EVM, only an import of more than 5,000 keys is refused. Generate fewer wallets, or remove unused ones with Delete wallets. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.addWallets(networkType, amount_to_generate, secret_keys?, tag_ids?) src/lib/proxima/endpoints/wallets/wallets.ts
Delete wallets
/wallets/remove Archives wallets so they no longer appear in the wallet list.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Deleting a wallet that is already deleted changes nothing.
The network is read from the address format: 0x addresses are EVM, anything else is SVM. On SVM, a wallet that still holds a withdrawable balance cannot be deleted. EVM wallets are archived without a balance check.
Body parameters application/json
-
pubkeysarray<string> RequiredAddresses of the wallets to delete, all on the same network.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
messagestringHuman-readable confirmation.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | No address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests. |
| 400 | bad_request | A non-0x address is not a valid Solana address. Check that every SVM address is a valid base58 public key. |
| 422 | unprocessable | An SVM wallet still holds funds above the dust floor. EVM wallets are not checked. Move the funds out with Execute a withdrawal before deleting the wallet. |
| 422 | upstream_failure | The SVM balance check could not read balances from the RPC. Retry after a short wait. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.removeWallets(pubkeys) src/lib/proxima/endpoints/wallets/wallets.ts
List deleted wallets
/wallets/deleted/{chain_id} Returns the archived wallets of the account on the network of a chain.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
chain_idenum RequiredChain ID.Possible valuessolethbscbaserobinhoodmonadarcxlayer
Returns 200 OK · application/json
Returns a list of Wallet objects.
-
walletsarray<object>Deleted wallets.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | The chain is not supported. Use a supported chain_id; monad is no longer accepted. |
| 422 | upstream_failure | On sol, reading the balances of the deleted wallets from the RPC failed. Retry after a short wait. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.wallets.getDeletedWallets(chainId) src/lib/proxima/endpoints/wallets/wallets.ts
Restore deleted wallets
/wallets/deleted/restore Makes deleted wallets active again.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Wallets already restored are no longer deleted; once none is left, a repeat returns 404.
The network is read from the address format. Addresses that are not deleted wallets of the account are ignored.
Body parameters application/json
-
pubkeysarray<string> RequiredAddresses to restore, all on the same network. At most 5,000 per call.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
restoredarray<string>Addresses that were restored.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | No address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | More than 5,000 addresses were sent. Split the addresses into batches of 5,000 or fewer. |
| 400 | bad_request | SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests. |
| 404 | not_found | None of the addresses is a deleted wallet of the account. Use addresses from List deleted wallets. |
| 422 | unprocessable | Restoring would exceed the license's wallet limit. Restore fewer wallets, or delete active ones first. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.restoreWallets(pubkeys) src/lib/proxima/endpoints/wallets/wallets.ts
Add wallets from a launch
/wallets/add-from-launch Adds wallets used in a launch to the account's trading wallets.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry On Solana, a wallet already added is refused with 409, so a repeat cannot add it twice.
The web app calls this from a launch's wallet list and from the wallets export menu.
Body parameters application/json
-
launch_idstring RequiredLaunch ID. The client sends the numeric ID as a string. -
pubkeysarray<string> RequiredAddresses of launch wallets to add. -
tag_idsarray<integer> OptionalIDs of folders to add the wallets to.
Returns 200 OK · application/json
-
walletsarray<string>Addresses added. -
tag_idsarray<integer>Folder IDs the wallets were added to.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | No address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | launch_id is not a valid launch ID. Send the launch's numeric ID as a string. |
| 404 | not_found | The launch is not on the account. Use the ID of one of your launches. |
| 400 | bad_request | EVM addresses were sent for a Solana launch. Send addresses of the launch's own chain. |
| 400 | bad_request | Solana addresses were sent for an EVM launch. Send addresses of the launch's own chain. |
| 400 | bad_request | For a Solana launch, an address is not a valid Solana address. Check that every address is a valid base58 public key. |
| 400 | bad_request | For an EVM launch, an address is not a valid EVM address. Check that every address is a valid 0x address. |
| 400 | bad_request | An address is not a wallet of the launch. Send only wallets of this launch. |
| 409 | conflict | On Solana, a wallet is already one of the account's trading wallets. Remove the wallets already listed by List wallets from pubkeys. |
| 404 | not_found | On Solana, a launch wallet has no stored key. Send only wallets of this launch. |
| 404 | not_found | A folder in tag_ids is not on the account. Use folder IDs from the tags of List wallets. |
| 400 | bad_request | For an EVM multi-launch, the launch group has no plan yet. Save the launch plan first, then retry. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.addFromLaunch(launch_id, pubkeys, tag_ids?) src/lib/proxima/endpoints/wallets/wallets.ts
Add watch wallets
/wallets/{network_type}/watch/add Adds external addresses to the watchlist.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Adding an address that is already watched updates its name, image and icon instead of duplicating it.
names, images and icons are parallel to pubkeys: entry i applies to address i, and null leaves it unset. The web app calls this from the Watchlist, from a live launch, and after a marketplace checkout.
Path parameters
-
network_typeenum RequiredNetwork type of the addresses.Possible valuessvmevm
Body parameters application/json
-
pubkeysarray<string> RequiredAddresses to watch. At most 100 per request. -
namesarray<string | null> OptionalLabel per address, at most 25 characters, ornull. Optional; when sent, it must have one entry per address. -
imagesarray<string | null> OptionalBase64-encoded avatar image per address (at most 2 MB), ornull. Optional; when sent, it must have one entry per address. -
iconsarray<string | null> OptionalShort text icon per address, at most 20 characters, ornull. Optional; when sent, it must have one entry per address. -
is_bookmarkarray<boolean> OptionalBookmark flag per address. Ignored unless it has one entry per address.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | network_type is not svm or evm. Use svm or evm as network_type. |
| 400 | bad_request | On SVM, no address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | On EVM, no address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | More than 100 addresses were sent. Split the addresses into batches of 100 or fewer. |
| 400 | bad_request | names does not have one entry per address. Send one names entry per address, null for none. |
| 400 | bad_request | A name is longer than 25 characters. Shorten the name to 25 characters or fewer. |
| 400 | bad_request | images does not have one entry per address. Send one images entry per address, null for none. |
| 400 | bad_request | icons does not have one entry per address. Send one icons entry per address, null for none. |
| 400 | bad_request | An icon is longer than 20 characters. Shorten the icon to 20 characters or fewer. |
| 400 | bad_request | On SVM, an address is not a valid Solana address. Check that every address is a valid base58 public key. |
| 400 | bad_request | On EVM, an address is not a valid EVM address. Check that every address is a valid 0x address. |
| 400 | bad_request | An image is not valid base64. Send each image as base64-encoded bytes. |
| 400 | bad_request | An image is larger than 2 MB once decoded. Send images of 2 MB or less. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.addWatchWallets(networkType, pubkeys, names, images, icons, is_bookmark?) src/lib/proxima/endpoints/wallets/wallets.ts
Update a wallet
/wallets/rename Sets the name, icon, image or bookmark flag of a wallet or watched address.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Sending the same values again leaves the wallet in the same state.
Omit a field to leave it unchanged; send null to clear it. The network is read from the address format. The web app uses it to edit watchlist entries and to toggle bookmarks.
Body parameters application/json
-
pubkeystring RequiredAddress to update. -
namestring | null OptionalNew label, 1 to 25 characters.nullclears it. -
iconstring | null OptionalNew text icon, at most 20 characters.nullclears it. -
imagestring | null OptionalNew avatar as base64-encoded image data, at most 2 MB.nullremoves it. -
is_bookmarkboolean OptionalBookmark flag.
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | pubkey is not a valid address. Send a valid Solana or 0x address. |
| 400 | bad_request | name is longer than 25 characters. Shorten name to 25 characters or fewer. |
| 400 | bad_request | name is an empty string. Send null to clear the name. |
| 400 | bad_request | icon is longer than 20 characters. Shorten icon to 20 characters or fewer. |
| 400 | bad_request | image is not valid base64. Send image as base64-encoded bytes. |
| 422 | unprocessable | The image is larger than 2 MB. Send an image of 2 MB or less. |
| 500 | internal_error | The address is not a wallet of the account. Returned as a 500, not a 404. Use an address from List wallets or List watch wallets. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.renameWallet(pubkey, name?, icon?, image?, is_bookmark?) src/lib/proxima/endpoints/wallets/wallets.ts
List watch wallets
/wallets/watch/list Returns every watched address of the account, SVM and EVM, most recent first.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Parameters
No parameters.
Returns 200 OK · application/json
Returns a list of Watch wallet objects.
-
walletsarray<object>Watched addresses.
Errors
Only the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.wallets.getWatchWallets() src/lib/proxima/endpoints/wallets/wallets.ts
Remove watch wallets
/wallets/watch/remove Removes addresses from the watchlist.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Addresses that are not watched are skipped, so a repeat returns
removed: 0.
Body parameters application/json
-
pubkeysarray<string> RequiredAddresses to stop watching. SVM and EVM addresses can be mixed.
Returns 200 OK · application/json
-
removedintegerNumber of watched wallets removed. Addresses that were not watched are skipped.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | No address was sent. Send at least one address in pubkeys. |
| 400 | bad_request | An address is neither a 0x address nor a valid Solana address. Check every address in pubkeys. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.wallets.removeWatchWallets(pubkeys) src/lib/proxima/endpoints/wallets/wallets.ts