# x402 Finance Hub – Stock Search

> x402 Finance Hub – Stock Search is a paid API for AI agents from x402-trading-hub.vercel.app, paid per call via x402, $0.08/call, status unknown (last checked 2026-10-02).

Searches for stocks and financial instruments by keyword, returning matching securities data via Alpha Vantage and Twelve Data providers.

## Facts

- Endpoint: POST https://x402-trading-hub.vercel.app/api/stocks/search?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-finance-hub-stock-search-c00001ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vJculGhxkeRAMyU-Evdde

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 x402-finance-hub-stock-search-c00001ef -d '<json body>'
```

Example prompt: Search for stocks matching 'Tesla' and show me what securities come up — I want to see the ticker symbols and exchanges they trade on.

## When to prefer this

Use this endpoint when an agent needs to resolve a company name or partial name into a ticker symbol and exchange, or to discover what financial instruments match a search term. Prefer over direct ticker lookups when the exact symbol is unknown.

## Known failure modes

- Missing 'keywords' field returns validation error
- Empty or overly generic keyword returns zero results
- Upstream Alpha Vantage or Twelve Data API failure returns degraded or empty response
- Payment not completed returns HTTP 402 requiring USDC payment on Base
- Rate limiting from underlying providers may cause temporary failures

## How this service works

Forex, stocks, crypto, and trading data from Alpha Vantage, Twelve Data, TradingView, and Forex Factory. Pay with USDC on Base.

## Output

Returns a data object containing matching securities for the given keyword, including ticker symbols, company names, asset types, and exchange listings sourced from Alpha Vantage and/or Twelve Data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "keywords"
 ],
 "properties": {
  "keywords": {
   "type": "string",
   "description": "Search keywords"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-finance-hub-stock-search-c00001ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-trading-hub.vercel.app](https://www.zero.xyz/host/x402-trading-hub.vercel.app/llms.txt)