Normalize, geocode, and parse Japanese addresses. x402-enabled for AI agents.
Pay from $0.001 to $0.005 per request in USDC on Base / Polygon / Solana, settled onchain via the x402 protocol, no signup, no API key needed.
UPTIME 24H 100% │ 7D 100% │ 30D 100%
ASSESSMENT
updated 18m agoEvidence-backed signals, not a single score. Click any chip for the proof. Measured values stay read-only; unknown is honest.
reliability 100%
- uptime 24h
- 100%
- uptime 7d
- 100%
- uptime 30d
- 100%
- uptime 90d
- 100%
- response p95
- 370ms
- avg response
- 304ms
- total checks
- 9
compliance A (11/12)
11 of 12 x402 conformance checks pass. Full checklist below.
price $0.001 to $0.005 (p14 in Data)
- price (min)
- $0.001
- price (max)
- $0.005
- category percentile (min)
- p14 in Data
- category percentile (max)
- p15 in Data
- endpoints / prices
- 6 / 3
- model
- tiered
- stability
- 100%
risk clean
No deterministic risk flag. Risk fires only on an exact blocklist match, or a reserved-brand name with a mismatched verified payTo. Never from low uptime, a high price, or a model guess.
WHAT IT DOES
ai-derivedProvides services for normalizing, geocoding, parsing, and reverse-geocoding Japanese addresses. conf 100%
- category
- address-api conf 100%
- in
- body
AI-generated summary. The measured data is never altered by it.
ENDPOINTS
| METHOD | PATH | DESCRIPTION | PRICE | NETWORK | ASSET |
|---|---|---|---|---|---|
| POST | /batch | $0.004 | Base/Polygon/Solana | USDC | |
| POST | /geocode | $0.005 | Base/Polygon/Solana | USDC | |
| POST | /normalize | $0.005 | Base/Polygon/Solana | USDC | |
| POST | /parse | $0.005 | Base/Polygon/Solana | USDC | |
| GET | /postal-code/1000001 | $0.001 | Base/Polygon/Solana | USDC | |
| POST | /reverse-geocode | $0.005 | Base/Polygon/Solana | USDC |
6 endpoints
REQUEST / RESPONSE EXAMPLE
An unpaid request to GET /postal-code/1000001 returns HTTP 402 with the payment terms. Settle onchain via your facilitator, then retry with the X-Payment header.
// request
curl -i 'https://address.agentic-jp.com/postal-code/1000001'
// 402 response (captured by monitor) · 6 payloads · click to expand
[
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/normalize"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/normalize"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/normalize"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "5000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/normalize",
"mimeType": "application/json",
"description": "Japanese address normalization (住所正規化): standardize a JP address into clean prefecture / city / town / chome-banchi components. Fixes fullwidth/halfwidth digits, old-form kanji, and chome-banchi notation variants, and resolves the 7-digit postal code. Returns a 0-1 confidence score so agents can flag low-quality input. Use for address validation, cleansing, deduplication, and canonicalization before storage or comparison."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"address": "東京都千代田区永田町１ー７ー１"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"input": "東京都千代田区永田町１ー７ー１",
"components": {
"go": "1",
"city": "千代田区",
"town": "永田町",
"chome": "1",
"banchi": "7",
"prefecture": "東京都"
},
"confidence": 0.98,
"normalized": "東京都千代田区永田町1-7-1",
"postal_code": "100-0014"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 200,
"description": "A raw Japanese address string in any common format"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/geocode"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/geocode"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/geocode"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "5000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/geocode",
"mimeType": "application/json",
"description": "Geocode a Japanese (JP) address to WGS84 lat/lng coordinates, with a granularity level (prefecture → city → town → chome → banchi) and a 0-1 confidence score showing how precisely the input resolved. Japan-only. Use for mapping, distance calculation, or delivery routing."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"address": "東京都千代田区永田町1-7-1"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"lat": 35.6739,
"lng": 139.7449,
"level": "banchi",
"confidence": 0.95,
"normalized": "東京都千代田区永田町1-7-1"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 200,
"description": "Japanese address to geocode"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/reverse-geocode"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/reverse-geocode"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/reverse-geocode"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "5000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/reverse-geocode",
"mimeType": "application/json",
"description": "Reverse-geocode WGS84 lat/lng coordinates within Japan to a normalized Japanese (JP) address with structured components. Use to label a GPS fix, a map pin, or a photo location with a human-readable address."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"lat": 35.6739,
"lng": 139.7449
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"address": "東京都千代田区永田町1-7-1",
"confidence": 0.92
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"description": "Latitude within Japan (20–46)"
},
"lng": {
"type": "number",
"description": "Longitude within Japan (122–154)"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/postal-code/:zip"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "1000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/postal-code/:zip"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "1000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/postal-code/:zip"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "1000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/postal-code/:zip",
"mimeType": "application/json",
"description": "Look up Japanese (JP) address candidates for a 7-digit postal code (郵便番号), backed by the official Japan Post KEN_ALL dataset. One postal code can map to several towns; all candidates are returned with kana readings. Use for address autofill and postal-code validation."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"pathParams": {
"zip": "1000001"
},
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"candidates": [
{
"city": "千代田区",
"kana": "ナガタチョウ",
"town": "永田町",
"prefecture": "東京都"
}
],
"postal_code": "100-0014"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"pathParams": {
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"description": "Japanese 7-digit postal code, hyphen optional"
}
}
},
"queryParams": {
"type": "object",
"properties": {}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"routeTemplate": "/postal-code/:zip"
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/parse"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/parse"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "5000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/parse"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "5000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/parse",
"mimeType": "application/json",
"description": "Extract a fully structured Japanese (JP) address — prefecture, city, town, chome-banchi, plus building name, room number and addressee — from free-form, OCR, or voice-transcribed text. Use to turn one messy line into typed fields for invoices, shipping labels, or CRM records."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"text": "東京都千代田区永田町1丁目7-1 衆議院第二議員会館 1234号室 田中太郎 様"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"address": {
"room": "1234号室",
"building": "衆議院第二議員会館",
"normalized": "東京都千代田区永田町1-7-1"
},
"addressee": {
"name": "田中太郎",
"honorific": "様"
},
"confidence": 0.85
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 2000,
"description": "Free-form text (OCR / voice transcript) containing a Japanese address"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/batch"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "4000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
{
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"extra": {
"name": "USD Coin",
"version": "2",
"resource": "https://address.agentic-jp.com/batch"
},
"payTo": "0x38c9F689274E2fC3AE360744eF88ce212077a584",
"amount": "4000",
"scheme": "exact",
"network": "eip155:137",
"maxTimeoutSeconds": 300
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F",
"resource": "https://address.agentic-jp.com/batch"
},
"payTo": "2BTzdCAcCLaNA2SSZ1YjJvTtscNCpUMUEjLY3LyBpNMk",
"amount": "4000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://address.agentic-jp.com/batch",
"mimeType": "application/json",
"description": "Batch-normalize or batch-geocode up to 100 Japanese (JP) addresses in a single call — same processing as POST /normalize and POST /geocode, with per-item success/error reporting. Dynamic pricing: a small per-item fee. Use for bulk-cleaning an address column or import file."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"body": {
"items": [
{
"id": "1",
"address": "東京都千代田区永田町1-7-1"
}
],
"operation": "normalize"
},
"type": "http",
"method": "POST",
"bodyType": "json"
},
"output": {
"type": "json",
"example": {
"count": 1,
"results": [
{
"id": "1",
"success": true
}
],
"operation": "normalize"
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method",
"bodyType",
"body"
],
"properties": {
"body": {
"required": [
"operation",
"items"
],
"properties": {
"items": {
"type": "array",
"maxItems": 100
},
"operation": {
"enum": [
"normalize",
"geocode"
],
"type": "string"
}
}
},
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
}
}
},
"x402Version": 2
}
] UPTIME
RESPONSE TIME
7d UPTIME 100%
UPTIME 7D 100%
AVG RESP 306ms
TOTAL CHECKS 11
RECENT CHECKS
TIME STATUS RESP
● OK 328ms
● OK 293ms
● OK 370ms
● OK 313ms
● OK 356ms
● OK 334ms
● OK 229ms
● OK 264ms
● OK 353ms
● OK 229ms
● OK 292ms
OVER TIME
All charts share the 7d window selected here. Every series is also served as JSON at /api/v1/services/japan-address-api/price, /scores, /volume and /buyers. On-chain volume and distinct buyers are measured over the service's settlement address and are a conservative undercount (only settlements that reach a measured facilitator are counted).
PRICE (captured 402, USD)
Median across 6 endpoints. Use the selector to isolate one.
SUB-SCORES (uptime + x402 compliance)
VOLUME (on-chain settlement, USD)
Shared payout address (1 other service). On-chain settlement on this address may include those services, so this reads as operator volume, not service-only.
DISTINCT BUYERS
Shared payout address (1 other service). Buyers on this address may include those of other services on the same address.
COMPLIANCE
11/12 checks pass · grade A- 402 payload captured
- accepts[] array present
- payTo address recoverable
- payTo at accepts[0].payTo (conformant shape)
- payTo is a valid on-chain address
- atomic price declared
- atomic price in a sane range
- asset (token) address declared
- network resolves to CAIP-2
- payment scheme declared
- response mimeType declared
- served over HTTPS
EMBED THIS BADGE
// HTML
<a href="https://x402-list.com/services/japan-address-api?utm_source=badge&utm_medium=referral&utm_campaign=embed"> <img src="https://x402-list.com/badge/japan-address-api.svg" alt="Japan Address API listed on x402-list" height="28"> </a>
// Markdown
[](https://x402-list.com/services/japan-address-api?utm_source=badge&utm_medium=referral&utm_campaign=embed)
// HTML · live uptime variant
<a href="https://x402-list.com/services/japan-address-api?utm_source=badge&utm_medium=referral&utm_campaign=embed"> <img src="https://x402-list.com/badge/japan-address-api.svg?data=uptime" alt="Japan Address API uptime on x402-list" height="28"> </a>