DOCUMENTATION

Macroeconomic Data

38 Chinese and global macroeconomic time series covering monetary policy, prices, output, and trade.

Macroeconomic Data API

38 Chinese and global macroeconomic time series covering monetary policy, prices, output, and trade.

Endpoints Summary (38 endpoints)

EndpointMethodKey ParametersDescription
/v1/macro/commodity-dailyGETstart_date, end_date, symbol, limitGet Commodity Daily
/v1/macro/consumer-confidenceGETstart_date, end_date, limitGet Consumer Confidence
/v1/macro/cpiGETstart_date, end_date, limitGet Cpi
/v1/macro/crypto-dailyGETstart_date, end_date, symbol, limitGet Crypto Daily
/v1/macro/deposit-rateGETstart_date, end_date, limitGet Deposit Rate
/v1/macro/energy-inventoryGETstart_date, end_date, indicator, item, limitGet Energy Inventory
/v1/macro/enterprise-boomGETstart_date, end_date, limitGet Enterprise Boom
/v1/macro/epu-indexGETstart_date, end_date, country, limitGet Epu Index
/v1/macro/fdiGETstart_date, end_date, limitGet Fdi
/v1/macro/fixed-investmentGETstart_date, end_date, limitGet Fixed Investment
/v1/macro/forex-dailyGETstart_date, end_date, symbol, limitGet Forex Daily
/v1/macro/fx-reservesGETstart_date, end_date, limitGet Fx Reserves
/v1/macro/fx-spotGETstart_date, end_date, pair_name, limitGet Fx Spot
/v1/macro/gdpGETstart_date, end_date, limitGet Gdp
/v1/macro/global-index-dailyGETstart_date, end_date, symbol, limitGet Global Index Daily
/v1/macro/global-index-spotGETstart_date, end_date, index_name, limitGet Global Index Spot
/v1/macro/global-risk-factorGETstart_date, end_date, factor_name, limitGet Global Risk Factor
/v1/macro/industrial-productionGETstart_date, end_date, limitGet Industrial Production
/v1/macro/lprGETstart_date, end_date, limitGet Lpr
/v1/macro/migration-areaGETstart_date, end_date, area, indicator, city_name, limitGet Migration Area
/v1/macro/migration-scaleGETstart_date, end_date, area, indicator, limitGet Migration Scale
/v1/macro/money-supplyGETstart_date, end_date, limitGet Money Supply
/v1/macro/new-house-priceGETstart_date, end_date, limitGet New House Price
/v1/macro/new-loansGETstart_date, end_date, limitGet New Loans
/v1/macro/oil-price-adjustmentGETstart_date, end_date, limitGet Oil Price Adjustment
/v1/macro/oil-price-regionGETstart_date, end_date, province, limitGet Oil Price Region
/v1/macro/passenger-load-factorGETstart_date, end_date, limitGet Passenger Load Factor
/v1/macro/pmiGETstart_date, end_date, limitGet Pmi
/v1/macro/ppiGETstart_date, end_date, limitGet Ppi
/v1/macro/real-estateGETstart_date, end_date, limitGet Real Estate
/v1/macro/retail-salesGETstart_date, end_date, limitGet Retail Sales
/v1/macro/rrrGETstart_date, end_date, limitGet Rrr
/v1/macro/shiborGETstart_date, end_date, limitGet Shibor
/v1/macro/social-financeGETstart_date, end_date, limitGet Social Finance
/v1/macro/society-electricityGETstart_date, end_date, limitGet Society Electricity
/v1/macro/trade-balanceGETstart_date, end_date, limitGet Trade Balance
/v1/macro/traffic-volumeGETstart_date, end_date, limitGet Traffic Volume
/v1/macro/urban-unemploymentGETstart_date, end_date, limitGet Urban Unemployment

Detailed Endpoint Specifications

GET /v1/macro/commodity-daily

Get Commodity Daily

Retrieves daily international commodity data.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
symbolstringOptional—Commodity symbol (e.g. XAUUSD / USO)
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/commodity-daily?start_date=2026-01-01&symbol=sz.000001&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/commodity-daily"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/consumer-confidence

Get Consumer Confidence

Retrieves the consumer confidence index.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/consumer-confidence?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/consumer-confidence"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/cpi

Get Cpi

Retrieves CPI (Consumer Price Index) data.

Returns monthly CPI values, year-over-year growth rates, and cumulative values. Data source: the macro_cn_cpi table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records (default: 10 years)

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/cpi?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/cpi"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/crypto-daily

Get Crypto Daily

Retrieves daily crypto asset data.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
symbolstringOptional—Crypto asset symbol (e.g. BTCUSD)
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/crypto-daily?start_date=2026-01-01&symbol=sz.000001&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/crypto-daily"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/deposit-rate

Get Deposit Rate

Retrieves the benchmark deposit rate.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/deposit-rate?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/deposit-rate"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/energy-inventory

Get Energy Inventory

Retrieves U.S. crude oil inventory macro indicators.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
indicatorstringOptional—Indicator name
itemstringOptional—Commodity item
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/energy-inventory?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/energy-inventory"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "indicator": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/enterprise-boom

Get Enterprise Boom

Retrieves the enterprise business climate index.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/enterprise-boom?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/enterprise-boom"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/epu-index

Get Epu Index

Retrieves the economic policy uncertainty index (monthly).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
countrystringOptional—Country/region
limitintegerOptional200Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/epu-index?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/epu-index"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "country": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/fdi

Get Fdi

Retrieves foreign direct investment (FDI) data.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/fdi?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/fdi"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/fixed-investment

Get Fixed Investment

Retrieves fixed-asset investment data.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/fixed-investment?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/fixed-investment"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/forex-daily

Get Forex Daily

Retrieves daily forex data.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
symbolstringOptional—Currency pair symbol (e.g. EURUSD)
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/forex-daily?start_date=2026-01-01&symbol=sz.000001&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/forex-daily"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/fx-reserves

Get Fx Reserves

Retrieves foreign exchange reserves data.

Returns monthly foreign exchange reserves (in hundreds of millions of USD) and year-over-year growth rates. Data source: the macro_cn_fx_reserves table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/fx-reserves?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/fx-reserves"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/fx-spot

Get Fx Spot

Retrieves forex spot quote snapshots (archived daily).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start snapshot date (YYYY-MM-DD)
end_datestringOptional—End snapshot date (YYYY-MM-DD)
pair_namestringOptional—Currency pair name
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/fx-spot?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/fx-spot"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "pair_name": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/gdp

Get Gdp

Retrieves GDP (Gross Domestic Product) data.

Returns quarterly GDP, year-over-year growth rates, and the breakdown across the three industries (primary/secondary/tertiary). Data source: the macro_cn_gdp table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start quarter (YYYY-MM-DD)
end_datestringOptional—End quarter (YYYY-MM-DD)
limitintegerOptional40Maximum number of records (default: 10 years)

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/gdp?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/gdp"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/global-index-daily

Get Global Index Daily

Retrieves historical daily data for core global indices.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
symbolstringOptional—Index symbol (e.g. SP500)
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/global-index-daily?start_date=2026-01-01&symbol=sz.000001&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/global-index-daily"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "symbol": "sz.000001"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/global-index-spot

Get Global Index Spot

Retrieves real-time global index snapshots (archived daily).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start snapshot date (YYYY-MM-DD)
end_datestringOptional—End snapshot date (YYYY-MM-DD)
index_namestringOptional—Index name
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/global-index-spot?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/global-index-spot"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "index_name": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/global-risk-factor

Get Global Risk Factor

Retrieves global risk factors (daily).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
factor_namestringOptional—Factor name
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/global-risk-factor?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/global-risk-factor"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "factor_name": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/industrial-production

Get Industrial Production

Retrieves the year-over-year growth rate of industrial value added.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/industrial-production?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/industrial-production"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/lpr

Get Lpr

Retrieves LPR (loan prime rate) data.

Returns the 1-year and 5-year LPR rates. Data source: the macro_cn_lpr table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/lpr?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/lpr"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/migration-area

Get Migration Area

Retrieves city-level details of China’s population migration (daily).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
areastringOptional—Region (city or province)
indicatorstringOptional—Direction (move_in / move_out)
city_namestringOptional—City name
limitintegerOptional300Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/migration-area?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/migration-area"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "area": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/migration-scale

Get Migration Scale

Retrieves China’s migration scale index (daily).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
areastringOptional—Region (city or province)
indicatorstringOptional—Direction (move_in / move_out)
limitintegerOptional200Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/migration-scale?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/migration-scale"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "area": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/money-supply

Get Money Supply

Retrieves money supply (M0/M1/M2) data.

Returns monthly M0, M1, and M2 values along with their year-over-year growth rates. Data source: the macro_cn_money_supply table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/money-supply?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/money-supply"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/new-house-price

Get New House Price

Retrieves the new house price index.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/new-house-price?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/new-house-price"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/new-loans

Get New Loans

Retrieves new RMB loan data.

Returns monthly new loan amounts and cumulative loan totals. Data source: the macro_cn_new_loans table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/new-loans?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/new-loans"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/oil-price-adjustment

Get Oil Price Adjustment

Retrieves the history of China’s refined oil product price adjustments.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional200Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/oil-price-adjustment?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/oil-price-adjustment"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/oil-price-region

Get Oil Price Region

Retrieves region-level oil price details for China.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
provincestringOptional—Province
limitintegerOptional500Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/oil-price-region?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/oil-price-region"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "province": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/passenger-load-factor

Get Passenger Load Factor

Retrieves passenger load factors for rail and civil aviation.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/passenger-load-factor?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/passenger-load-factor"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/pmi

Get Pmi

Retrieves PMI (Purchasing Managers’ Index) data.

Returns manufacturing and non-manufacturing PMI. Data source: the macro_cn_pmi table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/pmi?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/pmi"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/ppi

Get Ppi

Retrieves PPI (ex-factory price index for industrial producers) data.

Returns monthly PPI values, year-over-year growth rates, and cumulative values. Data source: the macro_cn_ppi table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/ppi?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/ppi"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/real-estate

Get Real Estate

Retrieves the real estate climate index.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/real-estate?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/real-estate"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/retail-sales

Get Retail Sales

Retrieves total retail sales of consumer goods.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/retail-sales?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/retail-sales"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/rrr

Get Rrr

Retrieves the reserve requirement ratio (RRR).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/rrr?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/rrr"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/shibor

Get Shibor

Retrieves the Shanghai Interbank Offered Rate (Shibor).

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/shibor?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/shibor"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/social-finance

Get Social Finance

Retrieves aggregate financing to the real economy (TSF) data.

Returns monthly TSF increments (in hundreds of millions of CNY). Data source: the macro_cn_social_finance table.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/social-finance?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/social-finance"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/society-electricity

Get Society Electricity

Retrieves total electricity consumption of the whole society.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/society-electricity?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/society-electricity"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/trade-balance

Get Trade Balance

Retrieves the import-export trade balance.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/trade-balance?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/trade-balance"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/traffic-volume

Get Traffic Volume

Retrieves passenger and freight traffic volume.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/traffic-volume?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/traffic-volume"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

GET /v1/macro/urban-unemployment

Get Urban Unemployment

Retrieves the urban unemployment rate.

Request Parameters

ParameterTypeRequiredDefaultDescription
start_datestringOptional—Start date (YYYY-MM-DD)
end_datestringOptional—End date (YYYY-MM-DD)
limitintegerOptional120Maximum number of records

cURL Example

curl -X GET "https://tickerlab.org/v1/macro/urban-unemployment?start_date=2026-01-01&limit=10" \
  -H "X-API-Key: $TICKERLAB_API_KEY"

Python Example

import requests

url = "https://tickerlab.org/v1/macro/urban-unemployment"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
    "start_date": "2026-01-01",
    "end_date": "value",
    "limit": 10
}
response = requests.get(url, headers=headers, params=params)
print(response.json())