# DeepSearch ETF Search API

> DeepSearch ETF Search API is a paid API for AI agents from x402.deepsearch.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Searches Korean ETF listings by keyword (theme, name, or holding) and returns matching ETF names, issuers, and symbols

## Facts

- Endpoint: GET https://x402.deepsearch.com/v1/context/etf/search
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deepsearch-etf-search-api-e0d97231
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mniYVzsxgrAN01NnCxs7F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability deepsearch-etf-search-api-e0d97231
```

Example prompt: Search DeepSearch for Korean ETFs related to semiconductors — I want to see which ETFs on KRX cover that theme, including their names, issuers, and ticker symbols.

## When to prefer this

Use this endpoint when you need to discover or search for Korean ETFs (listed on KRX) by theme, name, or underlying holding. Ideal for investment research workflows that need to map investment themes (e.g. 반도체, AI, S&P500) to actual tradable ETF symbols in Korea. Not suitable for US-listed ETFs or for retrieving price/financial data (use sibling endpoints for that).

## Known failure modes

- No ETFs found for obscure or misspelled keywords — returns empty etfs array
- Payment failure if USDC balance on Base Mainnet is insufficient — HTTP 402 error
- Invalid or missing keyword parameter — HTTP 400 validation error
- Rate limiting or service unavailability — HTTP 5xx error

## How this service works

Up to 10 years of financials + 3 years of daily price history for all 2,000+ KRX stocks. Pay-per-query with USDC on Base Mainnet — no subscription.

## Output

Returns a list of matching ETFs with their Korean names, issuer (asset management company), and KRX ticker symbols, along with the echoed search keyword.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "keyword"
     ],
     "properties": {
      "keyword": {
       "type": "string",
       "description": "Search term (theme / name / holding), e.g. 반도체, QQQ, S&P500"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "etfs": [
   {
    "name": "TIGER 미국AI반도체팹리스",
    "issuer": "미래에셋자산운용",
    "symbol": "491830"
   }
  ],
  "keyword": "반도체"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deepsearch-etf-search-api-e0d97231/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.deepsearch.com](https://www.zero.xyz/host/x402.deepsearch.com/llms.txt)