# Microquery

> Pay-per-query SQL for AI agents. Register once, receive 100,000 micro-USDC
> ($0.10) free trial credit, then run SQL over SEC EDGAR financials, NVD/CVE vulnerabilities,
> OSV open-source advisories, PubMed biomedical literature, Ethereum on-chain
> data, Bitcoin, FDA FAERS adverse events, FEC campaign finance, FRED macro
> data, ClinicalTrials, DeFi TVL, arXiv preprints, and more. Agents pay per
> query in USDC on Base — no subscriptions, no API keys tied to a credit card.
> Pricing: 150 micro-USDC per GiB scanned (~$0.15/TB).

## Machine-readable entry point (start here)

- [Agent quickstart](https://microquery.dev/v1/agent-quickstart): Public JSON
  endpoint. Returns a self-contained document covering registration,
  authentication, querying, pricing, deposits, available datasets, and use-case
  examples. An autonomous agent can bootstrap itself from this single response
  without reading any other documentation.

## Reference documentation

- [API reference](https://microquery.dev/docs.md): Registration, Bearer and
  EIP-712 authentication, query endpoint, cost estimation, pricing, deposits,
  and account management.
- [Dataset schemas](https://microquery.dev/datasets.md): Field names, types,
  partition keys, and example SQL for every table.
- [Runnable examples](https://microquery.dev/examples.md): Four multi-dataset
  Python scripts — company due diligence, drug safety, software security audit,
  and research-to-clinic pipeline.
- [FAQ](https://microquery.dev/faq.md): Billing, authentication, trust model,
  and common questions.
- [Full content for LLM ingestion](https://microquery.dev/llms-full.txt): All
  of the above concatenated into a single file.

## Use cases (multi-dataset combinations)

- **Company due diligence** — `sec` + `fec` + `fred`: SEC EDGAR financials,
  FEC political donation patterns, FRED macro indicators.
- **Drug safety report** — `fda` + `clinicaltrials` + `pubmed`: FDA FAERS
  adverse events, active clinical trials, PubMed publication trends.
- **Software security audit** — `nvd` + `osv`: NVD CVSS scores cross-referenced
  with OSV ecosystem-aware advisories for precise version ranges.
- **Research-to-clinic pipeline** — `pubmed` + `clinicaltrials`: Publication
  volume trend vs. trial phase distribution to gauge research maturity.

## Quick start

```bash
# Register — returns api_key and 100,000 micro-USDC trial credit ($0.10)
curl -X POST https://microquery.dev/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

# Query
curl -G https://microquery.dev/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "database=nvd" \
  --data-urlencode "query=SELECT id, descriptions[0].value AS description FROM cve WHERE metrics.cvssMetricV31[0].cvssData.baseScore > 9 LIMIT 5"
```

## Key facts

- Base URL: `https://microquery.dev`
- Query endpoint: `GET /query?database=X&query=SQL` (Bearer or EIP-712 auth)
- Response format: newline-delimited JSON; cost in `X-Microquery-Cost-MicroUSDC` header
- Trial credit: 100,000 micro-USDC ($0.10) on every new account (covers all example scripts)
- Minimum deposit: 250,000 micro-USDC (0.25 USDC) via EIP-2612 permit on Base
- No wallet required to start; wallet enables EIP-712 per-query spending caps