# Halfway API

> Pay $0.03 USDC with x402 to find three real meeting places ranked for equal travel time between two origins. No maps API key, account, or subscription is required.

## API resources

- [Agent guide](https://halfwayapi.com/): Endpoint, payment flow, supported inputs, ranking method, and limitations.
- [OpenAPI 3.1 contract](https://halfwayapi.com/openapi.json): Complete request and response schemas for POST /v1/meet-halfway.
- [Paid endpoint](https://halfwayapi.com/v1/meet-halfway): x402 v2 endpoint on Base mainnet; send a JSON POST to receive payment requirements.
- [Data handling](https://halfwayapi.com/data-handling): Provider disclosure, storage rules, and exact cache-retention limits.
- [Health](https://halfwayapi.com/healthz): Free production health check.

## Use cases

- Choose a cafe or restaurant with a balanced commute for two people.
- Select a mutually fair coworking space or park.
- Find an EV charger that minimizes the travel-time difference.

## Important limitations

- Driving estimates use free-flow traffic, not live traffic.
- Results do not guarantee current opening status, ratings, reviews, or a global optimum.