Batch quotes
Batch quotes
GET
/openapi/v3/quotesRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| refs | string | Required | Comma-separated, ≤ 50 (above the limit → 400003) |
| fx | string | Optional | USD also converts price fields for CNY/HKD listings. Omitted (or compatibility values native / none / mixed) keeps price fields native; market-cap and turnover fields remain USD either way |
| expand | string | Optional | profile attaches data.profiles, keyed by the original input ref. Equity profiles contain latest valuation fields and ipo_date; fund profiles contain the fund block |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/quotes?refs=AAPL.US,MSTR.US" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.quotes is keyed by the input refs verbatim; data.count is the hit count.
Notes
- Partial success does not fail the request: refs that are unresolved / ambiguous / have no snapshot are summarized in the top-level
warnings, while HTTP stays 200 andcodestays0. - Check
data.quotesfor each ref's key individually — do not retry the whole batch just becausewarningsis non-empty. Batch endpoints do not run the disambiguation negotiation.