Convert a one-line US street address into coordinates using the US Census Bureau Geocoder

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x9d6b6fdB04040a55d58B24ff4C90C08cf6083C8f",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "maxTimeoutSeconds": 60
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "address": "1600 Pennsylvania Ave NW, Washington, DC 20500",
          "limit": 1
        },
        "type": "http"
      },
      "output": {
        "example": {
          "data": {
            "benchmark": "Public_AR_Current",
            "items": [
              {
                "address_components": {
                  "city": "WASHINGTON",
                  "from_address": "1600",
                  "pre_direction": null,
                  "pre_type": null,
                  "state": "DC",
                  "street_name": "PENNSYLVANIA",
                  "suffix_direction": "NW",
                  "suffix_type": "AVE",
                  "to_address": "1648",
                  "zip": "20500"
                },
                "lat": 38.898699,
                "lon": -77.035188,
                "matched_address": "1600 PENNSYLVANIA AVE NW, WASHINGTON, DC, 20500",
                "precision": "tiger_interpolated",
                "side": "L",
                "tiger_line_id": "76225813"
              }
            ],
            "page": {
              "has_more": false,
              "limit": 1,
              "next_offset": null,
              "offset": 0,
              "returned": 1,
              "total": 1
            },
            "query": {
              "address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
            }
          },
          "meta": {
            "capability": "location.us.geocode",
            "freshness": "live",
            "source": "census_geocoder",
            "version": "3.0.0"
          }
        },
        "type": "json"
      }
    },
    "routeTemplate": "/v1/locations/us/geocode",
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "additionalProperties": false,
              "properties": {
                "address": {
                  "description": "One-line US street address including city and state, e.g. \"1600 Pennsylvania Ave NW, Washington, DC 20500\".",
                  "maxLength": 200,
                  "minLength": 5,
                  "type": "string"
                },
                "limit": {
                  "default": 5,
                  "description": "Maximum number of candidate matches to return, in the Census Bureau's own order. page.total always reports how many the Census Bureau returned in total, so a low limit never hides an ambiguous address.",
                  "maximum": 10,
                  "minimum": 1,
                  "type": "integer"
                },
                "offset": {
                  "default": 0,
                  "description": "Zero-based index of the first candidate to return. The Census Bureau returns every match in one response, so paging is applied by Eckari over that set - pass page.next_offset to walk the remaining candidates without a second upstream lookup.",
                  "minimum": 0,
                  "type": "integer"
                }
              },
              "required": [
                "address"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  },
  "payment-identifier": {
    "info": {
      "required": false
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "id": {
          "maxLength": 128,
          "minLength": 16,
          "pattern": "^[a-zA-Z0-9_-]+$",
          "type": "string"
        },
        "required": {
          "type": "boolean"
        }
      },
      "required": [
        "required"
      ],
      "type": "object"
    }
  }
}

curl "https://api.eckari.com/v1/locations/us/geocode"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://api.eckari.com/v1/locations/us/geocode");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://api.eckari.com/v1/locations/us/geocode")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header