Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

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

  • pubkey string
    Wallet address: a base58 public key on SVM, a 0x address on EVM.
  • network_type enum
    Network the wallet belongs to.
    Possible values svmevm
  • created_at integer
    Unix timestamp (seconds) at which the wallet was added to the account.
  • launches array<integer>
    Launches the wallet has been used in.
  • tag_ids array<integer>
    IDs of the folders the wallet belongs to.
  • funding_source string | null
    How the wallet was funded: None, Wallet (a direct transfer), or the ID of the exchange that funded it, for example binance.
  • from_marketplace boolean
    Whether the wallet was delivered by a marketplace order.
  • native_balances object
    Native balance per chain ID, in base units (lamports or wei), as decimal strings.
  • tx_count object
    Number of transactions per chain ID: an integer string on Solana, a number on EVM chains.
  • volume object
    Traded volume per chain ID, in native base units, as decimal strings.
  • pnl_native object
    PnL 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_usd object
    PnL per chain ID, in micro-USD. On Solana, an integer string; a loss reads "0". On EVM chains, always the number 0: USD PnL is not tracked there.
  • pnl_usd_total integer
    PnL across chains, in micro-USD, as a JSON number. A loss reads 0, and EVM wallets always read 0.
  • funded_at object
    Unix timestamp (seconds) of the last funding per chain ID; 0 when never funded.
  • routing string
    ID of the platform the wallet's trades are built through on the requested chain. direct by default. See Retrieve the routing config.

An external address on your watchlist. Proxima holds no key for it, so it cannot sign or be withdrawn from.

Attributes

  • pubkey string
    Watched address.
  • network_type enum
    Network of the address.
    Possible values svmevm
  • name string | null
    Label, at most 25 characters.
  • icon string | null
    Short text icon (for example an emoji), at most 20 characters.
  • image_link string | null
    URL of the uploaded avatar image.
  • is_bookmark boolean
    Whether the address is bookmarked.
  • created_at integer
    Unix timestamp (seconds) at which the address was added.

List wallets

Bearer JWT
GET /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_id enum Required
    Chain ID.
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

  • funding_status enum
    Status of the account's wallet funding.
    Possible values NoneRunningFailed
  • wallets array<object>
    List of Wallet objects.
  • tags object
    Folders of the account, by network type.
    Child attributes 2
    • svm array<object>
      SVM folders. See the Folder object.
    • evm array<object>
      EVM folders.

Errors

StatusCodeWhen 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

GET /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

  • default string
    Platform a wallet uses when none is set: direct.
  • platforms array<object>
    Available platforms.
    Child attributes 5
    • id string
      Platform ID used as a key in Set wallet routing. direct is Proxima's own route.
    • label string
      Display name.
    • fee_bps integer
      Fee a trade routed this way pays the platform, in basis points of its quote leg.
    • fee_pct number
      fee_bps as a percentage.
    • chains array<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

Bearer JWT
POST /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_id enum Required
    Chain the routing applies to.
    Possible values solethbscbaserobinhoodmonadarcxlayer

Body parameters application/json

  • <platform_id> array<string> Required
    One key per platform ID from the routing config; the value lists the wallet addresses to route through it. Only direct builds trades outside sol. At least one address is required overall.

Returns 200 OK · application/json

  • ok boolean
    true on success.
  • routing object
    Platform ID now set for each address, keyed by address. EVM addresses come back lowercase.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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_type enum Required
    Network type: svm (Solana) or evm (every EVM chain).
    Possible values svmevm

Body parameters application/json

  • amount_to_generate integer Required
    Number of new keypairs to generate.
  • secret_keys array<string> Optional
    Private keys to import alongside the generated wallets. Requires key-management rights on the license.
  • tag_ids array<integer> Optional
    IDs of folders to add the new wallets to.

Returns 200 OK · application/json

  • wallets array<string>
    Addresses of the wallets added.
  • tag_ids array<integer>
    Folder IDs the wallets were added to.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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

  • pubkeys array<string> Required
    Addresses of the wallets to delete, all on the same network.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • message string
    Human-readable confirmation.

Errors

StatusCodeWhen 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

GET /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_id enum Required
    Chain ID.
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

Returns a list of Wallet objects.

  • wallets array<object>
    Deleted wallets.

Errors

StatusCodeWhen 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

POST /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

  • pubkeys array<string> Required
    Addresses to restore, all on the same network. At most 5,000 per call.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.
  • restored array<string>
    Addresses that were restored.

Errors

StatusCodeWhen 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

POST /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_id string Required
    Launch ID. The client sends the numeric ID as a string.
  • pubkeys array<string> Required
    Addresses of launch wallets to add.
  • tag_ids array<integer> Optional
    IDs of folders to add the wallets to.

Returns 200 OK · application/json

  • wallets array<string>
    Addresses added.
  • tag_ids array<integer>
    Folder IDs the wallets were added to.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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_type enum Required
    Network type of the addresses.
    Possible values svmevm

Body parameters application/json

  • pubkeys array<string> Required
    Addresses to watch. At most 100 per request.
  • names array<string | null> Optional
    Label per address, at most 25 characters, or null. Optional; when sent, it must have one entry per address.
  • images array<string | null> Optional
    Base64-encoded avatar image per address (at most 2 MB), or null. Optional; when sent, it must have one entry per address.
  • icons array<string | null> Optional
    Short text icon per address, at most 20 characters, or null. Optional; when sent, it must have one entry per address.
  • is_bookmark array<boolean> Optional
    Bookmark flag per address. Ignored unless it has one entry per address.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.

Errors

StatusCodeWhen 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

Bearer JWT
POST /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

  • pubkey string Required
    Address to update.
  • name string | null Optional
    New label, 1 to 25 characters. null clears it.
  • icon string | null Optional
    New text icon, at most 20 characters. null clears it.
  • image string | null Optional
    New avatar as base64-encoded image data, at most 2 MB. null removes it.
  • is_bookmark boolean Optional
    Bookmark flag.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.

Errors

StatusCodeWhen 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

Bearer JWT
GET /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.

  • wallets array<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

POST /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

  • pubkeys array<string> Required
    Addresses to stop watching. SVM and EVM addresses can be mixed.

Returns 200 OK · application/json

  • removed integer
    Number of watched wallets removed. Addresses that were not watched are skipped.

Errors

StatusCodeWhen 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