Help Center

GroundAPI is a financial data API service designed for AI Agents. We provide 11 endpoints covering A-share stock data, screening, market overview, securities search, gold price, web search, news, trending, daily bulletin, weather, and calendar. Supports REST API and MCP. One API Key for everything.

After registering, go to Dashboard → API Keys → click 'Create New Key'. The new key is shown in full only once — save it securely. Each account can create multiple keys for different environments (dev, test, production).

500 free API calls per month per account, covering all endpoints. No credit card required. After that, pay-as-you-go: gold/news/trending/bulletin/weather/calendar $0.01/call, stock/screening/market/securities-search/web-search $0.02/call.

Currently 11 endpoints: Stock data (/v1/finance/stock), Stock screening (/v1/finance/stock/screen), Market overview (/v1/finance/market), Securities search (/v1/finance/search), Gold price (/v1/finance/gold-price), Web search (/v1/info/search), News (/v1/info/news), Trending (/v1/info/trending), Daily bulletin (/v1/info/bulletin), Weather (/v1/life/weather), Calendar (/v1/life/calendar).

MCP (Model Context Protocol) is Anthropic's protocol that lets AI assistants call external tools directly. Add GroundAPI's MCP address (mcp.groundapi.net/mcp) and your API Key to Claude Desktop's config file, restart, and Claude can query real-time data directly. See our blog tutorial for details.

All endpoints return unified JSON: success (boolean) and data (structured payload). On error, an error object with code and message is returned. This format is friendly to both humans and AI Agents.

Yes. Free users: 10 requests/second. Paid users: 100 requests/second. Exceeding the limit returns 429 status code. For higher concurrency, contact us for enterprise plans.

A-share stock/financial/screening data comes from a local database synced after market close (~15:35 CST snapshot of the day) — no intraday real-time quotes. Other endpoints are more real-time: web search 5min cache, weather/news 10min cache, trending/bulletin/gold 30min cache.

We use Stripe for payments, supporting Alipay, WeChat Pay, and international credit cards (Visa/Mastercard). Link your payment method in Dashboard → Billing, and usage beyond free tier is auto-billed monthly.

After logging in, the Dashboard overview shows monthly call totals, costs, and trend charts. The 'Usage' page lets you filter by API type and export CSV. The 'Billing' page shows current month breakdown and history.

API call charges are non-refundable as data has been delivered. However, if you encounter invalid calls due to service issues, contact support@wisefuturus.com and we'll verify and compensate with free credits.

Go to Dashboard → Settings → 'Danger Zone' at the bottom, click delete account. All API keys, call records, and billing data will be permanently deleted and cannot be recovered. Final deletion requires confirmation via support@wisefuturus.com.