Actions34
- Account Actions
- Confirmation Actions
- Market Actions
- Order Actions
- Position Actions
- Session Actions
- Watchlist Actions
Market → Search
AI-generatedSummary
Search for Capital.com markets by free-text term or EPIC codes and return a list of matching instruments.
Inputs
- searchTerm — Free-text term to search markets by. If empty, search ignores this field.
- epics — Comma-separated EPICs to filter the search by. If empty, search ignores this field.
- limit — Maximum number of results to return. Defaults to 50.
- simple — Whether to return a simplified version of the response instead of the raw data. Defaults to true.
Output shape
A list of market items.
If 'Simplify' is enabled, each item contains keys like epic, instrumentName, instrumentType, marketStatus, bid, offer, percentageChange, netChange, high, and low. If disabled, the response returns the raw API object.
Examples
Example 1: Find all instruments containing the word 'Gold'
Set Search Term to 'Gold', leave EPICs empty, Limit to 20, and Simplify to true.
Example 2: Filter results to specific assets by EPIC
Set EPICs to 'GOLD,AUDUSD,XAUUSD', leave Search Term empty, and Simplify to false to see raw data.