# vergabe-api

> German public procurement notices (tenders, awards, planning) from oeffentlichevergabe.de (CC0) as normalised JSON: CPV, NUTS, buyer, deadlines, document links. Paid per call via x402 (USDC on Base), free sample and stats.

Provider: Viono Insights (Dr. Josua Decker), https://viono-insights.de. Legal notice: https://vergabe-api.applehorsefrog.workers.dev/impressum. Privacy: https://vergabe-api.applehorsefrog.workers.dev/datenschutz. Contact: kontakt@viono-insights.de.
Built with substantial AI assistance (Claude); the provider reviews and is responsible for it.

## Endpoints

- [Service descriptor](https://vergabe-api.applehorsefrog.workers.dev/): endpoints, prices, payment details (free)
- [OpenAPI 3.1](https://vergabe-api.applehorsefrog.workers.dev/openapi.json): full schema with x-payment-info per operation (free)
- [x402 discovery manifest](https://vergabe-api.applehorsefrog.workers.dev/.well-known/x402) (free)
- [Free sample](https://vergabe-api.applehorsefrog.workers.dev/v1/sample?cpv=72): 5 latest calls for tenders, optional ?cpv=
- [Stats](https://vergabe-api.applehorsefrog.workers.dev/v1/stats): notices per day, last 30 days (free)
- [Search](https://vergabe-api.applehorsefrog.workers.dev/v1/notices): filtered list, up to 100 records, $0.01 USDC per call via x402. Filters: kind, cpv, nuts, q, since, until, deadline_after, deadline_before, nature, procedure, legal_basis, buyer_type, min_value, limit, offset, fields, sort
- [Single notice](https://vergabe-api.applehorsefrog.workers.dev/v1/notice/{id}): full record with lots and winners, $0.002 USDC per call via x402

## MCP

- Remote (Streamable HTTP, free tools): https://vergabe-api.applehorsefrog.workers.dev/mcp
- Local with paid tools: npx -y github:applehorsefrog/vergabe-api (set VERGABE_PAYER_KEY)
- Registry: io.github.applehorsefrog/vergabe-api

## Payment

x402 v2, network eip155:8453 (Base), asset USDC, payTo 0x64FE7Dab6d5C2265A7dD912f0c1C4dd6614FA5c6, facilitator https://facilitator.payai.network. A request without payment returns 402 with a PAYMENT-REQUIRED header; any x402 client (e.g. @x402/fetch) pays automatically.

## Source

Code (MIT): https://github.com/applehorsefrog/vergabe-api. Data: Datenservice Oeffentlicher Einkauf, CC0 1.0; personal contact data removed at import.