Stocks & funds market data API (v3)
Second-generation market data under the /openapi/v3 prefix: US, HK and A-share stocks, ETFs and funds, perpetuals. Instruments and listings, candles (with adjustment), quotes and daily metrics, corporate actions, issuers and fundamentals, holders and ratings, market aggregates, search and vocabularies — 35 endpoints. Excludes indices, crypto spot pairs and on-chain metrics.
- Base URL · differs from v1
- https://openapi.sosovalue.com/openapi/v3
- Markets
- US · HK · A-shares · ETFs / funds · perpetuals
- Candle intervals
- 1m 5m 15m 30m 60m 4h 1d 1w 1mo
- Adjustment
- unadjusted / back / forward
- Rate-limit headers
- Minute and monthly quota headers; HTTP 429 when exceeded
Daily candles and volume
$129.30-9.29%Nov 5, 2026 · USD
- Open
- 139.37
- High
- 141.17
- Low
- 123.9
- Close
- 129.3
- Volume
- 26M
Change vs previous close
Static API snapshot · Nov 6, 2026
View sample JSON response
{
"data": {
"candles": [
{
"trade_date": "2026-11-05",
"bar_start_at": "2026-11-05T00:00:00Z",
"open": "139.37",
"high": "141.17",
"low": "123.895",
"close": "129.3",
"volume": "26116063.306263"
},
{
"trade_date": "2026-11-04",
"bar_start_at": "2026-11-04T00:00:00Z",
"open": "136.6",
"high": "146.07",
"low": "135.8",
"close": "142.54",
"volume": "18878189.717635"
},
{
"trade_date": "2026-11-03",
"bar_start_at": "2026-11-03T00:00:00Z",
"open": "131.51",
"high": "138.41",
"low": "131.09",
"close": "135.63",
"volume": "11592338.324219"
},
{
"trade_date": "2026-11-02",
"bar_start_at": "2026-11-02T00:00:00Z",
"open": "132.22",
"high": "137.3",
"low": "129.34",
"close": "130.76",
"volume": "13341993.552446"
},
{
"trade_date": "2026-10-30",
"bar_start_at": "2026-10-30T00:00:00Z",
"open": "131.7",
"high": "134.51",
"low": "124.06",
"close": "130.51",
"volume": "34010946.5605"
},
{
"trade_date": "2026-10-29",
"bar_start_at": "2026-10-29T00:00:00Z",
"open": "141.65",
"high": "144.76",
"low": "138.88",
"close": "141.62",
"volume": "13375040.377501"
},
{
"trade_date": "2026-10-28",
"bar_start_at": "2026-10-28T00:00:00Z",
"open": "139.6",
"high": "145.3",
"low": "138.665",
"close": "145.16",
"volume": "12207333.597165"
},
{
"trade_date": "2026-10-27",
"bar_start_at": "2026-10-27T00:00:00Z",
"open": "140.075",
"high": "142",
"low": "138.69",
"close": "141.4",
"volume": "10777683.555544"
},
{
"trade_date": "2026-10-26",
"bar_start_at": "2026-10-26T00:00:00Z",
"open": "141.665",
"high": "144.7",
"low": "137.26",
"close": "139.82",
"volume": "15709632.244677"
},
{
"trade_date": "2026-10-23",
"bar_start_at": "2026-10-23T00:00:00Z",
"open": "144.43",
"high": "152.21",
"low": "144.205",
"close": "146.01",
"volume": "18575760.881288"
},
{
"trade_date": "2026-10-22",
"bar_start_at": "2026-10-22T00:00:00Z",
"open": "145.03",
"high": "149.4",
"low": "143.41",
"close": "145.8",
"volume": "20600157.484995"
},
{
"trade_date": "2026-10-21",
"bar_start_at": "2026-10-21T00:00:00Z",
"open": "146.3",
"high": "155.69",
"low": "143.93",
"close": "153.48",
"volume": "22587340.491635"
},
{
"trade_date": "2026-10-20",
"bar_start_at": "2026-10-20T00:00:00Z",
"open": "133.75",
"high": "146.75",
"low": "133.595",
"close": "142.72",
"volume": "18535021.125276"
},
{
"trade_date": "2026-10-19",
"bar_start_at": "2026-10-19T00:00:00Z",
"open": "139.13",
"high": "141.1",
"low": "135.8",
"close": "136.02",
"volume": "11934535.36197"
},
{
"trade_date": "2026-10-16",
"bar_start_at": "2026-10-16T00:00:00Z",
"open": "145.95",
"high": "146.83",
"low": "134.11",
"close": "136.83",
"volume": "31969955.136523"
},
{
"trade_date": "2026-10-15",
"bar_start_at": "2026-10-15T00:00:00Z",
"open": "137.74",
"high": "151.33",
"low": "134.892",
"close": "151.29",
"volume": "22287000.505334"
},
{
"trade_date": "2026-10-14",
"bar_start_at": "2026-10-14T00:00:00Z",
"open": "149.76",
"high": "152.18",
"low": "141.74",
"close": "143.24",
"volume": "20850077.126071"
},
{
"trade_date": "2026-10-13",
"bar_start_at": "2026-10-13T00:00:00Z",
"open": "153.105",
"high": "156.2",
"low": "150.925",
"close": "152.18",
"volume": "12381914.775655"
},
{
"trade_date": "2026-10-12",
"bar_start_at": "2026-10-12T00:00:00Z",
"open": "153.4",
"high": "158.4035",
"low": "150.8407",
"close": "152.68",
"volume": "13157308.811116"
},
{
"trade_date": "2026-10-09",
"bar_start_at": "2026-10-09T00:00:00Z",
"open": "154.215",
"high": "158.11",
"low": "150.5",
"close": "154.34",
"volume": "16042183.396624"
}
],
"count": 20,
"has_more": true,
"order": "desc",
"page_size": 20
}
}Endpoints
GET/openapi/v3/instrumentsInstrument catalog and filters (cursor pagination)GET/openapi/v3/instruments/{ref}One instrumentGET/openapi/v3/instruments/{ref}/listingsAn instrument's listings across exchangesGET/openapi/v3/listings/{ref}One listing's detailGET/openapi/v3/instruments/{ref}/candlesCandles with adjustment and interval, priced from the primary listing (date cursor)GET/openapi/v3/listings/{ref}/candlesRaw candles for one listingGET/openapi/v3/instruments/{ref}/quoteReal-time quote snapshot (404 / 400404 outside trading hours does not mean the instrument is missing)GET/openapi/v3/listings/{ref}/quoteQuote snapshot for one listingGET/openapi/v3/quotesBatch quotesGET/openapi/v3/instruments/{ref}/latestLatest trade for an instrumentGET/openapi/v3/listings/{ref}/latestLatest trade for one listingGET/openapi/v3/instruments/{ref}/metricsDaily metrics; latest=1 for snapshot modeGET/openapi/v3/instruments/{ref}/corporate-actionsUnified corporate-action stream; filter with action_typeGET/openapi/v3/instruments/{ref}/dividendsDividendsGET/openapi/v3/instruments/{ref}/splitsSplitsGET/openapi/v3/instruments/{ref}/adjustment-factorsAdjustment factors, to audit adjusted pricesGET/openapi/v3/parties/{ref}Issuer detailGET/openapi/v3/parties/{ref}/profileCompany profileGET/openapi/v3/profilesBatch company profiles (refs=A,B,C, up to 50)GET/openapi/v3/parties/{ref}/earningsEarnings actualsGET/openapi/v3/parties/{ref}/estimatesAnalyst consensus estimatesGET/openapi/v3/parties/{ref}/financialsIssuer financial statementsGET/openapi/v3/instruments/{ref}/holdingsETF holdingsGET/openapi/v3/instruments/{ref}/allocationsETF allocation breakdownsGET/openapi/v3/instruments/{ref}/holdersInstitutional and fund holdersGET/openapi/v3/instruments/{ref}/analyst-ratingsAnalyst ratingsGET/openapi/v3/instruments/{ref}/insider-transactionsInsider transactionsGET/openapi/v3/instruments/{ref}/treasuryListed-company crypto treasuryGET/openapi/v3/market/breadthAdvancers and decliners (US equities)GET/openapi/v3/market/sectorsSector performance, industry-ETF proxy basis (US equities)GET/openapi/v3/market/industriesIndustry and sector performance, constituent-weighted (US equities)GET/openapi/v3/resolveResolve an instrument by name or ticker (q=)GET/openapi/v3/reference/vocabAll controlled vocabularies in one downloadGET/openapi/v3/reference/enumsBusiness enums such as market_status and action_typeGET/openapi/v3/reference/{dict}A single vocabulary
cURL (any language that can send an HTTP request)
curl "https://openapi.sosovalue.com/openapi/v3/instruments/MSTR.US/candles?interval=1d&adjust=back&limit=60" \ -H "x-soso-api-key: $SOSO_API_KEY" # ref is a full_symbol such as MSTR.US or BTC-USDT-PERP.BINANCE (charset [A-Za-z0-9._-]) # Prices are decimal strings; next page: pass pagination.next_cursor as ?to= (order=desc, the default)
Response fields
GET /openapi/v3/instruments/{ref}/candles| Field | Type | Unit | Description |
|---|---|---|---|
| data.candles[].trade_date | string | YYYY-MM-DD | Exchange-local session date |
| data.candles[].bar_start_at | string | RFC3339 | Bar start time, UTC |
| data.candles[].open / high / low / close | string | instrument currency | OHLC as decimal strings |
| data.candles[].volume | string | shares / units | Volume |
| data.candles[].provisional | boolean | — | Only present when true (same-day bar not yet finalized) |
| pagination.next_cursor | string | null | — | Date cursor: pass as from (order=asc) or to (order=desc) |
| meta / warnings | object / array | — | How to read the values (price_type, adjust, currency…) and known data gaps |