Skip to content
API Reference

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

Funders

Manage the funder wallets that pay for funding your trading wallets.

A funder is a wallet Proxima holds for your account and uses as the source of funding jobs. Each funder has a network type: an SVM funder serves Solana, an EVM funder serves every EVM chain and reports a native balance per chain.

A funder can be the default for one or more chains. When the web app creates a funding draft, it picks the default funder of the target chain. Withdrawing to one of your own funders never prompts for 2FA (see Withdrawals).

A funder wallet of the account with its live native balances.

Attributes

  • pubkey string
    Funder address. EVM addresses are lowercase.
  • network_type enum
    Network type. An EVM funder serves every EVM chain.
    Possible values svmevm
  • is_default array<string>
    Chain IDs this funder is the default for. Empty when it is the default nowhere.
  • native_balances object
    Native balance per chain ID, in base units (lamports or wei), as decimal strings.
  • created_at integer
    Unix timestamp (seconds) at which the funder was created.

List funders

Bearer JWT
GET /wallets/funders/list

Returns every funder of the account, SVM and EVM, with live native balances.

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 Funder objects.

  • funders array<object>
    Funders of the account.

Errors

StatusCodeWhen and what to do
422 upstream_failure Reading the balances of SVM funders 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.funders.list() src/lib/proxima/endpoints/wallets/funders.ts

Create a funder

Bearer JWT
POST /wallets/{network_type}/funders/add

Generates a new funder, imports one from a private key, or promotes an existing wallet to funder.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Check before retrying Generating creates a new funder on each call; importing the same secret again is harmless. Before retrying a generate, call List funders and check whether the funder was added.

The web app generates new funders and, on SVM, promotes an existing wallet by address from the funder settings.

Path parameters

  • network_type enum Required
    Network type of the funder.
    Possible values svmevm

Body parameters application/json

  • key string | object Required
    The string "None" to generate a new keypair, { "secret": "..." } to import a private key, or { "pubkey": "..." } to use one of your existing wallets (SVM only).
    Child attributes 2
    • secret string Optional
      Private key to import. Requires key-management rights on the license.
    • pubkey string Optional
      Address of an existing wallet of the account to use as funder. SVM only.
  • is_default boolean Optional
    Whether to make the new funder the default.

Returns 200 OK · application/json

  • pubkey string
    Address of the funder.

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 key.secret is not a valid secret key for the network. Send a valid secret key for the network in key.secret.
400 bad_request On SVM, key.pubkey is not a valid Solana address. Send a valid base58 address in key.pubkey.
400 bad_request key.pubkey was sent on EVM, where a funder can only be generated or imported. Generate the EVM funder, or import it with key.secret.
403 forbidden A secret key was sent and the license cannot import keys. Generate the funder instead, or use a license with key-management rights.
404 not_found On SVM, the wallet named by key.pubkey is not on the account. Use an address from List wallets.
422 unprocessable The account already has 10 funders on this network. Remove an unused funder with Delete a funder 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.funders.add(networkType, request) src/lib/proxima/endpoints/wallets/funders.ts

POST /wallets/funders/export

Returns the private key of a funder.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Two-factor
Step-up for wallet.export_funder when the user protects it. How it works
Retry
Safe to retry Read-only: a repeat returns the same key.

Body parameters application/json

  • pubkey string Required
    Address of the funder.

Returns 200 OK · application/json

  • pubkey string
    Address of the funder.
  • secret_key string
    Private key: base58 on SVM, hex on EVM.

Errors

StatusCodeWhen and what to do
404 not_found On EVM, the funder is not on the account. Use an address from List funders.
500 internal_error On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token, 401 2fa_required and 429 when rate limited.

Web client proxima.wallets.funders.export(pubkey) src/lib/proxima/endpoints/wallets/funders.ts

Delete a funder

Bearer JWT
POST /wallets/funders/remove

Removes a funder that holds no withdrawable balance.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry A repeat after a successful removal returns a "Funder not found" error.

Before deleting, the web app withdraws the funder's balance and waits for the withdrawal to finish.

Body parameters application/json

  • pubkey string Required
    Address of the funder.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.

Errors

StatusCodeWhen and what to do
400 bad_request On SVM, the address is not a valid Solana address. Use an address from List funders.
404 not_found On EVM, the funder is not on the account. Use an address from List funders.
500 internal_error On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders.
409 conflict On EVM, the funder still holds a withdrawable balance on a chain. Move the balance out with Execute a withdrawal, then retry.
409 conflict On SVM, the funder still holds a withdrawable balance. Move the balance out with Execute a withdrawal, then retry.
500 internal_error On SVM, the funder is the account's last funder. Returned as a 500. EVM has no such check. Create another funder with Create a funder first.
500 internal_error On SVM, the funder is the account's active shield deployer. Returned as a 500. Keep this funder while the shield it deployed is active.
422 upstream_failure On SVM, the balance check could not read the funder's balance 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.funders.remove(pubkey) src/lib/proxima/endpoints/wallets/funders.ts

POST /wallets/funders/set-default

Makes a funder the default for the given chains.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Retry
Safe to retry Chains are applied one at a time, so after an error the earlier chains may already be set; check List funders. Sending the same body again is harmless.

Body parameters application/json

  • pubkey string Required
    Address of the funder.
  • chains array<string> Required
    Chain IDs to make it the default for. Must match the funder's network type.

Returns 200 OK · application/json

  • ok boolean
    Always true on success.

Errors

StatusCodeWhen and what to do
400 bad_request An EVM funder was set for sol. Use an SVM funder for sol.
400 bad_request An SVM funder was set for an EVM chain. Use an EVM funder for EVM chains.
404 not_found On EVM, the funder is not on the account. Use an address from List funders.
500 internal_error On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from List funders.

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.funders.setDefault(pubkey, chains) src/lib/proxima/endpoints/wallets/funders.ts