# Hermes Agent Commerce API

> Agent-ready research, enrichment, compliance, developer-intelligence, and data-quality utilities. Paid operations use x402 on Base with USDC.

## Company research and lead qualification

Use this flow when you need to research a company, enrich a domain, investigate a business or domain, inspect a company website, or qualify a lead.

1. Free preview: POST https://hermes-counterparty-api.onrender.com/v1/company-domain-intelligence/preview
   - Purpose: Bounded free company-domain DNS preview
   - JSON body: {"domain":"stripe.com"}
   - No payment is required.
2. Full enrichment: POST https://hermes-counterparty-api.onrender.com/v1/company-domain-intelligence — $0.02
   - Purpose: Company domain intelligence: research and enrich a business domain with public web and infrastructure signals
   - Adds full DNS, RDAP, mail-policy, website/contact/social, security, and source-provenance details.
   - An unpaid call returns HTTP 402 with the x402 payment challenge; pay that challenge and retry the same request.

## Discovery

- OpenAPI 3.1: https://hermes-counterparty-api.onrender.com/openapi.json
- Agent402/x402 manifest: https://hermes-counterparty-api.onrender.com/.well-known/x402
- Prefer the free company preview before purchasing full company-domain intelligence.

## Paid operation catalog

- POST /v1/counterparty-availability — $0.03: Counterparty availability and contact-window brief
- POST /v1/entity-sanctions-screen — $0.02: OFAC sanctions screening for a person or organization
- POST /v1/company-domain-intelligence — $0.02: Company domain intelligence: research and enrich a business domain with public web and infrastructure signals
- POST /v1/sec-company-snapshot — $0.02: SEC company snapshot by ticker or CIK with filings and financial facts
- POST /v1/dependency-vulnerability-check — $0.005: Check an exact dependency version for known OSV vulnerabilities
- POST /v1/package-maintenance-snapshot — $0.005: Package maintenance snapshot for an exact npm or PyPI version
- POST /v1/profile — $0.02: Profile JSON or CSV data quality
- POST /v1/duplicate-audit — $0.005: Audit duplicate JSON or CSV rows
- POST /v1/quality-gate — $0.01: Pass/fail data-quality gate
- POST /v1/schema-drift — $0.015: Detect schema drift
- POST /v1/data-contract-check — $0.015: Check data-contract compatibility
- POST /v1/clean-normalize — $0.02: Clean and normalize JSON or CSV
- POST /v1/repair-plan — $0.02: Generate a deterministic dataset repair plan