Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
config

Get platform configuration

Returns current platform parameters including fee structure, funding limits, referral reward percentages, and supported networks.

This endpoint is **public** (no authentication required) and is designed as the
single source of truth for all clients (web app, Chrome extension, SDK, agents).

Values are controlled by server-side environment variables and may change without
a client-side deployment. See the response schema for the full list of fields.
get/v1/config

Response

Successful Response

fee_percentagestring required

Tipping fee percentage (e.g., 0.02 for 2%). Split: 1% Grove + 1% referrer/BDR.

receiver_percentagestring required

Portion received by tip recipient (1 - fee_percentage)

min_fund_amountstring required

Minimum amount (in USD value) for a single funding transaction.

max_fund_amountstring required

Maximum amount (in USD value) a user can fund their account with in a single transaction.

max_account_balancestring nullable required

Maximum total balance (in USD value) an account can hold. Set to 0 to disable. Null if no limit.

referral_user_reward_percentagestring required

Default reward percentage for user referrers (e.g., 0.01 = 1%)

referral_bdr_reward_percentagestring required

Default reward percentage for BDR referrers (e.g., 0.01 = 1%)

supported_networksstring[] required

List of supported blockchain network identifiers

default_networkstring required

Default network for new accounts

default_tokenstring required

Default token symbol

min_tip_amountstring required

Minimum amount (in USD value) for a single tip.

max_tip_amountstring required

Maximum amount (in USD value) for a single tip.

min_withdrawal_amountstring required

Minimum amount (in USD value) for a withdrawal.

max_withdrawal_amountstring required

Maximum amount (in USD value) for a single withdrawal.

referral_user_duration_daysinteger required

Default reward window for user referrers in days (e.g., 365)

referral_bdr_duration_daysinteger required

Default reward window for BDR referrers in days (e.g., 365)

profile_base_urlstring required

Base URL for public profile pages (e.g., https://grove.city/{handle})

Example response

{
  "fee_percentage": "0.02",
  "receiver_percentage": "0.98",
  "min_fund_amount": "0.01",
  "max_fund_amount": "500.00",
  "max_account_balance": "500.00",
  "referral_user_reward_percentage": "0.01",
  "referral_bdr_reward_percentage": "0.01",
  "supported_networks": [
    "base-sepolia",
    "base"
  ],
  "default_network": "base-sepolia",
  "default_token": "USDC",
  "min_tip_amount": "0.01",
  "max_tip_amount": "20.00",
  "min_withdrawal_amount": "0.01",
  "max_withdrawal_amount": "1000.00",
  "referral_user_duration_days": 365,
  "referral_bdr_duration_days": 365,
  "profile_base_url": "https://grove.city"
}