curl --request POST \
--url https://mcp.echozero.app/api/v1/wallet/virtual/add-funds \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"amountInUsdc": 100
}
'{
"success": true,
"data": {
"success": true,
"transactionId": "<string>"
}
}Wallet
Add virtual funds
Mirrors GraphQL addFundsToVirtualWallet (primary amountInUsdc; deprecated amountInSol). Body must include a positive amountInUsdc and/or amountInSol (empty body → 400). Frozen wallets return WALLET_FROZEN / HTTP 403.
POST
/
api
/
v1
/
wallet
/
virtual
/
add-funds
curl --request POST \
--url https://mcp.echozero.app/api/v1/wallet/virtual/add-funds \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--header 'x-signature: <x-signature>' \
--header 'x-timestamp: <x-timestamp>' \
--data '
{
"amountInUsdc": 100
}
'{
"success": true,
"data": {
"success": true,
"transactionId": "<string>"
}
}Authorizations
Headers
Required for API-key authenticated requests. HMAC-SHA256(secretKey, timestamp + METHOD + path + body) as lowercase hex. Omit only for JWT/OAuth session tokens or public routes.
Required with x-signature. Epoch milliseconds; rejected if drift exceeds 5 minutes. Omit only for JWT/OAuth session tokens or public routes.
Body
application/json
OpenAPI: McpWalletAddVirtualFundsBodyDto. GraphQL: AddFundsToVirtualWalletArgs in apps/gql-main/src/wallet/args/walletOperation.args.ts.