# SemiData API

> Semiconductor supply chain intelligence for AI agents and analysts. Structured data on export controls, mineral deposits, SEC filings, restricted entities, and trade flows for gallium, germanium, rare earths, cobalt, lithium, silicon, indium, tellurium, and selenium. Every response carries a meta block with source, as_of, total, and pagination.

## Access

- **x402 micropayments**  -  $0.005/request in USDC on Base mainnet. No signup. Works on every data endpoint AND on MCP tools/call.
- **Free API key**  -  100 requests/day. Email signup at https://semidata.dev/
- **MCP**  -  JSON-RPC 2.0 Streamable HTTP server at https://semidata.dev/v1/mcp (initialize, tools/list, tools/call).

## Endpoints

### GET /v1/signals
Federal Register regulatory signals on semiconductor-critical materials: export controls, sanctions, import restrictions, and strategic-reserve actions. LLM-structured with importance scoring.
Source: US Federal Register (LLM-structured with Claude)  -  rolling  -  refreshed weekly
Params: `material`, `type`, `importance`, `country`, `since`, `q`, `limit`, `offset`

### GET /v1/deposits
USGS MRDS mineral deposit records for semiconductor-critical materials. 1,233 deposits. NOTE: this is a 2011 historical snapshot  -  use as_of in the response meta.
Source: USGS Mineral Resources Data System (MRDS)  -  2011 snapshot  -  MRDS is a static historical dataset, not live production data
Params: `commodity`, `country`, `state`, `status`, `min_score`, `active_only`, `q`, `limit`, `offset`

### GET /v1/edgar
SEC EDGAR filings processed with an LLM to extract supply chain signals, sentiment, and material mentions.
Source: SEC EDGAR (8-K, 10-K, 10-Q; LLM-extracted)  -  rolling  -  refreshed weekly
Params: `material`, `entity`, `form`, `importance`, `sentiment`, `since`, `q`, `limit`, `offset`

### GET /v1/entities
US Consolidated Screening List. Use for supplier / counterparty due diligence against export-control and sanctions lists.
Source: US Consolidated Screening List (BIS Entity List, OFAC SDN, MEU, CMIC, DPL)  -  rolling  -  refreshed weekly
Params: `name`, `country`, `list_name`, `q`, `limit`, `offset`

### GET /v1/tradeflows
UN Comtrade annual export volumes by country and HS code for semiconductor-critical materials.
Source: UN Comtrade (annual)  -  public Comtrade data lags 2-3 years  -  see period / data_year in the response
Params: `material`, `reporter`, `hs_code`, `period`, `min_value`, `limit`, `offset`

### POST /v1/mcp
MCP server (JSON-RPC 2.0). Methods: initialize, tools/list, tools/call, ping. Auth: X-API-Key header or X-Payment (x402).

## MCP Configuration

```json
{
  "mcpServers": {
    "semi-data": {
      "url": "https://semidata.dev/v1/mcp",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}
```

## Data Sources

- US Federal Register (LLM-structured with Claude)
- USGS Mineral Resources Data System (MRDS)
- SEC EDGAR (8-K, 10-K, 10-Q; LLM-extracted)
- US Consolidated Screening List (BIS Entity List, OFAC SDN, MEU, CMIC, DPL)
- UN Comtrade (annual)

## Notes for agents

- Country filters on /v1/signals use full country NAMES (e.g. "China"), not ISO codes. /v1/entities uses ISO-2 codes.
- /v1/deposits is a 2011 USGS snapshot  -  historical, not live production.
- /v1/tradeflows lags 2-3 years; check the period field.
- Paginate with limit + offset; meta.next_offset is null when exhausted.