GroundAPI Finance - Stock API
The Finance - Stock API from GroundAPI — 2 operation(s) for finance - stock.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/groundapi-net:groundapi-net-finance-stock-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ground Finance - Stock API
description: Real-time Data API for AI Agents
version: 3.0.0
tags:
- name: Finance - Stock
paths:
/v1/finance/stock:
get:
tags:
- Finance - Stock
summary: Stock
operationId: stock_v1_finance_stock_get
security:
- APIKeyHeader: []
parameters:
- name: keyword
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Search by name or code (mutually exclusive with symbol)
title: Keyword
description: Search by name or code (mutually exclusive with symbol)
- name: symbol
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Security code(s), comma-separated for multi-compare (e.g. 000001 or 000001,601398 or 000001.SH)
title: Symbol
description: Security code(s), comma-separated for multi-compare (e.g. 000001 or 000001,601398 or 000001.SH)
- name: aspects
in: query
required: false
schema:
type: string
description: 'Comma-separated aspects: overview,profile,quote,kline,technical,financial,flow,holders,management,events,tick,summary,peers'
default: overview
title: Aspects
description: 'Comma-separated aspects: overview,profile,quote,kline,technical,financial,flow,holders,management,events,tick,summary,peers'
- name: days
in: query
required: false
schema:
type: integer
maximum: 500
minimum: 1
description: Lookback days for kline/technical/flow
default: 60
title: Days
description: Lookback days for kline/technical/flow
- name: period
in: query
required: false
schema:
type: string
description: 'K-line period: 5/15/30/60/d/w/m'
default: d
title: Period
description: 'K-line period: 5/15/30/60/d/w/m'
- name: limit
in: query
required: false
schema:
type: integer
maximum: 50
minimum: 1
description: Results limit (search mode)
default: 10
title: Limit
description: Results limit (search mode)
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/finance/stock/screen:
get:
tags:
- Finance - Stock
summary: Screen Stocks
operationId: screen_stocks_v1_finance_stock_screen_get
security:
- APIKeyHeader: []
parameters:
- name: industry
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by industry
title: Industry
description: Filter by industry
- name: concept
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by concept/theme
title: Concept
description: Filter by concept/theme
- name: pe_max
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: PE upper bound
title: Pe Max
description: PE upper bound
- name: pe_min
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: PE lower bound
title: Pe Min
description: PE lower bound
- name: pb_max
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: PB upper bound
title: Pb Max
description: PB upper bound
- name: min_market_cap
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: Min total market cap (CNY)
title: Min Market Cap
description: Min total market cap (CNY)
- name: max_market_cap
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: Max total market cap (CNY)
title: Max Market Cap
description: Max total market cap (CNY)
- name: min_dividend_yield
in: query
required: false
schema:
anyOf:
- type: number
- type: 'null'
description: Min dividend yield (%)
title: Min Dividend Yield
description: Min dividend yield (%)
- name: filter_preset
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Preset filter: low_pe_high_div / small_cap_growth / large_cap_stable'
title: Filter Preset
description: 'Preset filter: low_pe_high_div / small_cap_growth / large_cap_stable'
- name: sort_by
in: query
required: false
schema:
type: string
description: 'Sort: change_pct/pe/pb/market_cap/turnover_rate/dividend_yield/volume'
default: change_pct
title: Sort By
description: 'Sort: change_pct/pe/pb/market_cap/turnover_rate/dividend_yield/volume'
- name: order
in: query
required: false
schema:
type: string
description: 'Sort order: desc/asc'
default: desc
title: Order
description: 'Sort order: desc/asc'
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Number of results
default: 20
title: Limit
description: Number of results
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key
HTTPBearer:
type: http
scheme: bearer