Instrument search
Resolve an instrument by name or ticker (q=)
GET
/openapi/v3/resolveRefresh: Minute / daily
This endpoint uses v3 at https://openapi.sosovalue.com/openapi/v3. Do not append it to /openapi/v1; see version-specific conventions.
This is the only place in the entire API that does fuzzy matching — every other endpoint resolves exactly. When an exact endpoint returns 400401 / 400901, follow its hint / suggestion here.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Required | Free text: company name, misspelling, symbol fragment |
| limit | integer | Optional | Default 10, max 50 |
Request Example
curl "https://openapi.sosovalue.com/openapi/v3/resolve?q=apple" \ -H "x-soso-api-key: $SOSO_API_KEY"
Response Fields
data.candidates[]:
| Field | Type | Description |
|---|---|---|
| kind | String | The layer the candidate belongs to |
| id | Number | Stable id at that layer |
| symbol / name | String | Symbol / name |
| matched | String | The field that matched |
| score | Number | Match score (descending) |
| href | String | A ready-to-call relative path |
Notes
- Currently English fuzzy matching only. Chinese and semantic search are planned — do not rely on Chinese free-text search.