# Japan Address API

> Normalize, geocode, reverse-geocode and parse Japanese addresses; postal-code lookup. Pay per call with USDC via the x402 protocol (HTTP 402) on Base, Polygon, or Solana. No API key, no signup: call any endpoint, read the payment instructions from the 402 response, pay, retry. Facilitator: Coinbase CDP.

## Endpoints
- POST /normalize ($0.005) — normalize an address into components
- POST /geocode ($0.005) — address to lat/lng
- POST /reverse-geocode ($0.005) — lat/lng to address
- GET /postal-code/{zip} ($0.001) — postal-code lookup
- POST /parse ($0.005) — structured address from messy text
- POST /batch — up to 100 items

## Machine-readable docs
- [x402 manifest with schemas and examples](https://address.agentic-jp.com/.well-known/x402)
- [OpenAPI 3.1](https://address.agentic-jp.com/openapi.json)
- [Agent skill guide](https://address.agentic-jp.com/.well-known/skill.md)

## How to pay
Any x402 client works: @x402/fetch or @x402/axios (npm), x402 (pip), Coinbase AgentKit, `npx agentcash`. MCP server for all 7 Japan Data APIs: `npx -y @mameta/japan-data-mcp`.

## All Japan Data APIs
- [Directory of all 8 services](https://agentic-jp.com/) · [services.json](https://agentic-jp.com/services.json)