---
title: "Get platform configuration"
method: GET
path: "/v1/config"
tags: ["config"]
---

# Get platform configuration

`GET /v1/config`

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.

## Response `200`

Successful Response

- PlatformConfigResponse — Response model for GET /v1/config — public platform parameters. Returns all configurable platform limits, fee structures, and network info so clients (app, extension, SDK) can render correct values without hardcoding.
  - `fee_percentage` string, required — Tipping fee percentage (e.g., 0.02 for 2%). Split: 1% Grove + 1% referrer/BDR.
  - `receiver_percentage` string, required — Portion received by tip recipient (1 - fee_percentage)
  - `min_fund_amount` string, required — Minimum amount (in USD value) for a single funding transaction.
  - `max_fund_amount` string, required — Maximum amount (in USD value) a user can fund their account with in a single transaction.
  - `max_account_balance` string, nullable, required — Maximum total balance (in USD value) an account can hold. Set to 0 to disable. Null if no limit.
  - `referral_user_reward_percentage` string, required — Default reward percentage for user referrers (e.g., 0.01 = 1%)
  - `referral_bdr_reward_percentage` string, required — Default reward percentage for BDR referrers (e.g., 0.01 = 1%)
  - `supported_networks` string[], required — List of supported blockchain network identifiers
  - `default_network` string, required — Default network for new accounts
  - `default_token` string, required — Default token symbol
  - `min_tip_amount` string, required — Minimum amount (in USD value) for a single tip.
  - `max_tip_amount` string, required — Maximum amount (in USD value) for a single tip.
  - `min_withdrawal_amount` string, required — Minimum amount (in USD value) for a withdrawal.
  - `max_withdrawal_amount` string, required — Maximum amount (in USD value) for a single withdrawal.
  - `referral_user_duration_days` integer, required — Default reward window for user referrers in days (e.g., 365)
  - `referral_bdr_duration_days` integer, required — Default reward window for BDR referrers in days (e.g., 365)
  - `profile_base_url` string, required — Base URL for public profile pages (e.g., https://grove.city/{handle})

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/revisions/f286b48a8105/schema)