MiCA COMPLIANCE CHECKER API — ENDPOINT REFERENCE
=================================================

Answers MiCA (EU Markets in Crypto-Assets Regulation) compliance questions
about crypto entities in the EU/EEA, from official EU regulatory registers.
Machine-payable via the x402 protocol: AI agents pay per call in USDC, no
account, no API key.

DATA
----
Source: ESMA Interim MiCA Register (the official ESMA publication of authorised
crypto-asset service providers, e-money token issuers, and entities flagged
non-compliant by EU national competent authorities), enriched with GLEIF LEI
reference data. Refreshed daily from weekly ESMA publications; every response
carries as_of_date. Health and freshness: GET https://api.micacheck.workers.dev/health

PAYMENT (x402)
--------------
Protocol: x402 v2, scheme "exact", network eip155:8453 (Base mainnet, real USDC).
Calling a paid endpoint without payment returns HTTP 402 with a
PAYMENT-REQUIRED header describing price and payment details; x402 client
libraries (e.g. @x402/fetch) handle the 402 -> pay -> retry loop automatically.

PAID ENDPOINTS
--------------
GET /check   —   $0.02 per call

  Is this crypto entity MiCA-authorised in the EU/EEA, in which register, with what status? Query params: name (string) OR lei (20-character LEI). JSON: match_confidence (exact|strong|weak|none), authorised (boolean), flagged_noncompliant (boolean), matches[] with register, legal_name, lei, home_member_state, competent_authority, status, services[], authorisation_date. Data source: ESMA Interim MiCA Register, official EU data; refreshed daily from weekly ESMA publications.

GET /entity/*   —   $0.05 per call

  Full MiCA register record(s) for one legal entity, enriched with GLEIF reference data. Path param: lei (20-character ISO 17442 LEI). JSON: records[] across the CASP, EMT-issuer and non-compliant registers (names, lei, member state, authority, status, services[], dates, website) plus gleif (legal_address, entity_status, headquarters_country; null if GLEIF is unavailable). Data source: ESMA Interim MiCA Register, official EU data; refreshed daily from weekly ESMA publications.

GET /noncompliant   —   $0.02 per call

  Lists entities publicly flagged as non-compliant under MiCA by EU national competent authorities. Query parameter: country (string, optional; 2-letter EU member-state code, e.g. IT). JSON response: count (number) and entities[] with legal_name, commercial_name, lei, home_member_state, competent_authority, website, infringement, reason, decision_date (ISO date), record_updated. Data source: ESMA Interim MiCA Register, official EU data; refreshed daily from weekly ESMA publications.

RESPONSE ENVELOPE (all paid endpoints)
--------------------------------------
{
  "source": "ESMA Interim MiCA Register",
  "as_of_date": "YYYY-MM-DD",
  "disclaimer": "Informational only. Verify against the live ESMA register before acting. Not legal advice.",
  "data": { ...endpoint-specific payload... }
}

EXAMPLE
-------
GET https://api.micacheck.workers.dev/check?name=Bitpanda
-> data.match_confidence: "exact", data.authorised: true,
   data.matches[0]: { register: "casp", legal_name: "Bitpanda GmbH",
   lei: "5493007WZ7IFULIL8G21", home_member_state: "AT", status: "authorised",
   services: ["providing custody and administration of crypto-assets on behalf of clients", ...] }

A lookup that finds nothing returns matches: [], authorised: false,
match_confidence: "none" — this API never infers or fabricates register content.

FREE ENDPOINTS
--------------
GET /        service description
GET /docs    this reference
GET /health  data freshness and row counts per register

Informational only. Verify against the live ESMA register before acting. Not legal advice.