POST
/
v1-alpha2
/
wallets
/
{walletLocator}
/
balances
Fund Wallet
curl --request POST \
  --url https://staging.crossmint.com/api/v1-alpha2/wallets/{walletLocator}/balances \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '{
  "amount": 10,
  "token": "usdc",
  "chain": "base-sepolia"
}'
[
  {
    "token": "usdc",
    "decimals": 6,
    "balances": {
      "base": "121000000",
      "ethereum": "121000000",
      "total": "242000000"
    }
  },
  {
    "token": "eth",
    "decimals": 18,
    "balances": {
      "ethereum": "1000000000000000000",
      "total": "1000000000000000000"
    }
  }
]
This is an alpha API and subject to change.
This endpoint is only available in staging and only supports USDC and USDXM.

Headers

​
X-API-KEY
string
required

API key required for authentication

Path Parameters

​
walletLocator
string
required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<walletType>
  • userId:<userId>:<walletType>
  • userId:<userId>:<walletType> (white label user example)
  • phoneNumber:<phoneNumber>:<walletType>
  • twitter:<handle>:<walletType>
  • x:<handle>:<walletType>
  • me:<walletType> (Use when calling from the client side with a client API key)

Body

application/json

Parameters required to fund a wallet

​
amount
number
required

The amount of currency to fund the wallet with. Between 1 and 100

Required range: 1 <= x <= 100
Example:

10

​
token
enum<string>
required

The currency to fund the wallet with

Available options:
usdc,
usdxm
Example:

"usdc"

​
chain

The chain to fund the wallet with

Available options:
arbitrum-sepolia,
avalanche-fuji,
base-sepolia,
barret-testnet,
ethereum-sepolia,
optimism-sepolia,
polygon-amoy,
sei-atlantic-2-testnet,
skale-nebula-testnet,
soneium-minato-testnet,
viction-testnet
Example:

"base-sepolia"

Response

Funds sent successfully.

The balances of the wallet

​
token
enum<string>
required

The token

Available options:
ape,
bnb,
coti,
eth,
matic,
mnt,
pol,
sei,
chz,
avax,
xai,
fuel,
hbar,
vic,
ip,
zcx,
u2u,
flow,
usdc,
usdce,
busd,
usdxm,
usdt,
credit,
usdf,
weth,
degen,
brett,
toshi,
eurc,
superverse,
pirate,
wld,
bonk,
trump,
xmeme,
fartcoin,
giga,
moodeng,
jailstool,
wen,
mlg,
duo,
pep,
harambe,
usedcar,
vine,
fartboy,
pnut,
stonks,
mew,
baby,
michi,
butthole,
anglerfish,
usa,
chillguy,
sigma,
maneki,
purpe,
lockin,
y2k,
fafo,
nub,
fullsend,
shoggoth,
mini,
llm,
sc,
fatgf,
pwease,
popcat,
spx,
fwog,
mother,
wif,
fric,
etf,
gyat,
bigballs,
goat,
stupid,
duko,
bitcoin,
buttcoin,
mcdull,
skbdi,
elon4afd,
mumu,
gme,
biao,
fred,
pengu,
asscoin,
bhad,
habibi,
quant,
hammy,
boden,
dolan,
nap,
scf,
titcoin,
zerebro,
rfc,
luce,
melania,
slerf,
bome,
ban,
pippin,
ghibli,
figure,
retardio,
memesai,
dogeai,
memecoin,
routine,
troll,
nobody,
italianrot,
jockey,
pppp,
useless,
gork,
hosico,
neet,
urmom,
bert,
fog,
mog,
boopa,
wizard,
trencher,
chacha,
labubu,
moonpig,
king,
hoodrat,
goonc,
gib,
assdaq,
xbt,
ripvc,
passroo,
buck,
chizzler,
kori,
cupsey,
grumpy,
aurafarm,
monkephone,
chillhouse,
aura,
usduc,
mask,
sugar,
dege,
aquarius,
aries,
cancer,
capricorn,
gemini,
leo,
libra,
pisces,
sagittarius,
scorpio,
taurus,
virgo,
ani,
blob,
boatkid,
ufd,
lizard,
tokabu,
worthless,
clippy,
nailong,
usdm1,
sol,
sui,
apt,
sfuel,
xion,
xlm
Example:

"eth"

​
decimals
number
required

The number of decimals of the token

Example:

18

​
balances
object
required

The balance of the wallet in different chains