Help Center
FAQs and guides for GroundAPI. Can't find your answer? Email us at support@wisefuturus.com
Getting Started
GroundAPI is a data API service designed for AI Agents. We provide 14 endpoints covering A-share stocks, market overview, fund data, weather, logistics, IP geolocation, web search, scraping, and news. 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: stock/news/fund $0.01/call, search/scrape/market/sector/screening $0.02/call. Weather, logistics, and IP are currently free.
Currently 14 endpoints: Stock data (/v1/finance/stock), Stock screening (/v1/finance/stock/screen), Market overview with sectors/funds/macro (/v1/finance/market), Fund (/v1/finance/fund), Weather (/v1/life/weather), Logistics (/v1/life/logistics), IP geolocation (/v1/life/ip), Web search (/v1/info/search), Web scraping (/v1/info/scrape), News (/v1/info/news), and more.
Technical
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.
Cache duration varies: A-share quotes 3s, logistics 2min, web search 5min, weather/scraping/news 10min, IP 24hr. Cached data is returned within the cache window; expired data triggers a fresh upstream request.
Billing & Payment
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.