Search Instruments
catalog.searchFREE. Resolve a human commodity name to an instrument code — 'cocoa' to CC, 'copper' to HG, 'palm oil' to PO. Use this instead of catalog.list when you already know the commodity by name and need the code to call price.latest or trade.flow. Returns nothing rather than a guess when no instrument matches. Free discovery tool — no payment required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "<q>"
},
"name": "catalog.search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Commodity name, synonym, or instrument code, e.g. 'cocoa' | |
| limit | No | Maximum results (1-50, default 10) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The query as interpreted | |
| results | Yes | Matching instruments, most confident first |