Input Schema
{
"headerFields": {
"Authorization": {
"description": "Bearer JWT for funding an existing Grove account. When omitted, the call creates and funds a new account instead.",
"required": false,
"type": "string"
},
"X-PAYMENT": {
"description": "Base64-encoded x402 payment payload returned after signing the payment request described in the initial 402 response.",
"required": true,
"type": "string"
}
},
"method": "POST",
"queryParams": {
"amount": {
"description": "Human-readable token amount to fund the tipping account. These funds can be used to tip creators on the internet. Examples: '0.01', '1', '1.05', '100.10'. Defaults to '1' when omitted. Token determined by 'token' parameter (default: USDC).",
"required": false,
"type": "string"
},
"network": {
"description": "Network identifier. Supported: ethereum-mainnet, base-sepolia, base, solana-devnet, solana-testnet, solana-mainnet. Defaults to base when omitted. Account.network is set on first funding (immutable - represents VM type).",
"examples": [
"ethereum-mainnet",
"base-sepolia",
"base",
"solana-devnet",
"solana-testnet",
"solana-mainnet"
],
"required": false,
"type": "string"
},
"referral_code": {
"description": "Optional referral code from an existing user (e.g., 'GRV-ABC123'). Only applies to new account creation. If provided for existing accounts, it is ignored. Invalid codes don't block account creation but are reported in referral_status.",
"examples": [
"GRV-ABC123"
],
"required": false,
"type": "string"
},
"token": {
"description": "Token symbol. Defaults to USDC when omitted. Supported tokens vary by network. Check network token configuration.",
"examples": [
"USDC",
"ETH"
],
"required": false,
"type": "string"
}
},
"type": "http"
}
Output Schema
{
"$defs": {
"ReferralStatus": {
"description": "Status of referral code application during account creation.\n\nIncluded in FundResponse to provide feedback on referral code processing.\nAllows successful account creation even with invalid referral codes,\nwhile still informing the user of the outcome.",
"properties": {
"applied": {
"title": "Applied",
"type": "boolean"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
}
},
"required": [
"applied"
],
"title": "ReferralStatus",
"type": "object"
}
},
"description": "Response model for successful funding.\n\nWhen creating a new account (no JWT provided):\n- account_id, api_key, address, and client_address are populated\n- Use api_key as Bearer token for future requests\n- referral_code contains the new account's shareable referral code\n- referral_status contains feedback on any provided referral code\n\nWhen funding existing account (JWT provided):\n- account_id and api_key are None\n- address and client_address are populated\n- referral_code and referral_status are None (referrals only apply to new accounts)",
"properties": {
"account_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Id"
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Address"
},
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Api Key"
},
"client_address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Client Address"
},
"funded_amount": {
"title": "Funded Amount",
"type": "string"
},
"new_balance": {
"title": "New Balance",
"type": "string"
},
"referral_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Referral Code"
},
"referral_status": {
"anyOf": [
{
"$ref": "#/$defs/ReferralStatus"
},
{
"type": "null"
}
],
"default": null
},
"tx_hash": {
"title": "Tx Hash",
"type": "string"
}
},
"required": [
"funded_amount",
"new_balance",
"tx_hash"
],
"title": "FundResponse",
"type": "object"
}