docs: add API reference to README

## Summary
Document the available HTTP endpoints.

## Acceptance Criteria
- README lists each endpoint with method, path, request body shape, and example response
- Covers GET /opportunities and POST /opportunities