RETAINED FOR COMPATIBILITY

Deprecated APIs

Existing calls remain compatible. New integrations should select an individual operation from the detailed catalog. Migrate existing integrations using the examples below.

Migrate to an explicit data identity

Old endpoint	Recommended endpoint
`POST /v1/fundamentals` {"operation":"FinancialStatement","parameters":{…}}	`POST /v1/data/operations/FinancialStatement` {"parameters":{…}}
`GET /v1/fundamentals?operation=FinancialStatement`	`GET /v1/catalog/operations/FinancialStatement`
`GET /v1/datasets`	`GET /v1/catalog/categories` `GET /v1/catalog/operations`
`GET /v1/catalog/plans`	`GET /v1/billing/catalog`

Move the operation identity into the path. Raw response envelopes, parameter semantics, authentication and current limits remain compatible. Catalog search is paginated. No removal date is set for these endpoints.

Browse individual operations →

Retained legacy operations

This directory retains coarse data calls, original dataset groups and old plan quotes. Use the data catalog and current annual subscription quotes for new integrations.

GET /v1/discovery · List exact discovery operation contracts

curl --request GET \
  'https://spark-data.cn/v1/discovery' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/discovery · Invoke a discovery or screening operation

curl --request POST \
  'https://spark-data.cn/v1/discovery' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"FinancialProductFilter","parameters":{}}'

GET /v1/entities · List exact entity operation contracts

curl --request GET \
  'https://spark-data.cn/v1/entities' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/entities · Invoke an entity or reference-data operation

curl --request POST \
  'https://spark-data.cn/v1/entities' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"CompanyBasicInfo","parameters":{"stockObject":["600570"],"pageSize":1}}'

GET /v1/market-data · List exact market-data operation contracts

curl --request GET \
  'https://spark-data.cn/v1/market-data' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/market-data · Invoke a unified market-data operation

curl --request POST \
  'https://spark-data.cn/v1/market-data' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"AShareLiveQuote","parameters":{"stockObject":["600570"],"pageSize":1}}'

GET /v1/fundamentals · List exact fundamentals operation contracts

curl --request GET \
  'https://spark-data.cn/v1/fundamentals' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/fundamentals · Invoke a fundamentals or forecast operation

curl --request POST \
  'https://spark-data.cn/v1/fundamentals' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"MangOperationAnalysis","parameters":{"stockObject":["600570"],"pageSize":1}}'

GET /v1/ownership · List exact ownership operation contracts

curl --request GET \
  'https://spark-data.cn/v1/ownership' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/ownership · Invoke an ownership or portfolio operation

curl --request POST \
  'https://spark-data.cn/v1/ownership' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"FundCompanyFund","parameters":{}}'

GET /v1/events · List exact event operation contracts

curl --request GET \
  'https://spark-data.cn/v1/events' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/events · Invoke an event, corporate-action, or risk operation

curl --request POST \
  'https://spark-data.cn/v1/events' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"ConvertibleBondIssue","parameters":{}}'

GET /v1/analytics · List exact analytics operation contracts

curl --request GET \
  'https://spark-data.cn/v1/analytics' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/analytics · Invoke an analytics, valuation, or ranking operation

curl --request POST \
  'https://spark-data.cn/v1/analytics' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"FundMarketSizeStats","parameters":{}}'

GET /v1/economy · List exact economy operation contracts

curl --request GET \
  'https://spark-data.cn/v1/economy' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/economy · Invoke a macro, regional, or industry-economy operation

curl --request POST \
  'https://spark-data.cn/v1/economy' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"RegionalEconomicData","parameters":{}}'

GET /v1/content · List exact content operation contracts

curl --request GET \
  'https://spark-data.cn/v1/content' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

POST /v1/content · Invoke a research, filing, news, or policy operation

curl --request POST \
  'https://spark-data.cn/v1/content' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"operation":"ResearchReport","parameters":{}}'

GET /v1/datasets · List stable dataset groups covering all 371 operations

curl --request GET \
  'https://spark-data.cn/v1/datasets' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

GET /v1/datasets/{dataset_id} · Return one dataset and its stable operation names

curl --request GET \
  'https://spark-data.cn/v1/datasets/cn-equity' \
  --header "Authorization: Bearer $SPARKDATA_API_KEY"

GET /v1/catalog/plans · Inspect planned annual tiers and purchase availability

curl --request GET \
  'https://spark-data.cn/v1/catalog/plans'