api.lodestarindex.com

Live 402 challenge

Captured by the enrichment pass, not read just now. Prices can change — always read the 402 the endpoint answers with.

{
  "max": 20,
  "x402": {
    "error": "Name the businesses with ?domains=a.com,b.com (up to 20); one read is billed per business found. The first 10 reads a month are free for each OAuth identity, key or paying wallet. This read carries none, so sign the payment below: a verified payment from a wallet with free reads left is not charged. This read costs $1.00 over x402 (see PAYMENT-REQUIRED). If you are the business owner, or an agent working for them, Watching covers your own locations from $149 a month per location ($89 at 21+), and your agents read them with no per-read charge.",
    "accepts": [
      {
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "version": "2"
        },
        "payTo": "0x46ee460ff2d11dd6262cec6de783f5de86a707da",
        "amount": "1000000",
        "scheme": "exact",
        "network": "eip155:8453",
        "maxTimeoutSeconds": 60
      }
    ],
    "resource": {
      "url": "https://api.lodestarindex.com/v1/trust/batch",
      "mimeType": "application/json",
      "description": "Lodestar Stamp receipt reads, one per business the shortlist finds"
    },
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "domains": "oasisheating.com,example.com"
            }
          }
        },
        "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",
                    "HEAD",
                    "DELETE"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "type": "object",
                  "required": [
                    "domains"
                  ],
                  "properties": {
                    "market": {
                      "type": "string",
                      "description": "Market slug from /v1/markets."
                    },
                    "domains": {
                      "type": "string",
                      "description": "Comma-separated business domains, up to 20. One read is billed per business found."
                    }
                  }
                }
              },
              "additionalProperties": false
            }
          }
        }
      }
    },
    "x402Version": 2
  },
  "error": "payment_required",
  "price": {
    "total_usd": "1.00",
    "per_read_usd": "1.00"
  },
  "units": 1,
  "reason": "discovery",
  "charter": "Payment never touches the record: paying changes access to this API answer, never what a receipt says.",
  "example": "/v1/trust/batch?domains=oasisheating.com,example.com",
  "message": "Name the businesses with ?domains=a.com,b.com (up to 20); one read is billed per business found. The first 10 reads a month are free for each OAuth identity, key or paying wallet. This read carries none, so sign the payment below: a verified payment from a wallet with free reads left is not charged. This read costs $1.00 over x402 (see PAYMENT-REQUIRED). If you are the business owner, or an agent working for them, Watching covers your own locations from $149 a month per location ($89 at 21+), and your agents read them with no per-read charge.",
  "upgrade": {
    "watching": {
      "for": "the business owner, or an agent the owner authorises",
      "url": "https://lodestarstamp.com/watch.html#pricing",
      "annual": "2 months free (pay 10 months, watched for 12); stacks with the location band",
      "covers": "A Watching subscription covers the owner's own watched locations; the owner's agents read those locations with no per-read charge.",
      "usd_per_location_month": [
        {
          "locations": "1",
          "usd_per_location_month": 149
        },
        {
          "locations": "2-5",
          "usd_per_location_month": 134
        },
        {
          "locations": "6-12",
          "usd_per_location_month": 119
        },
        {
          "locations": "13-20",
          "usd_per_location_month": 104
        },
        {
          "locations": "21+",
          "usd_per_location_month": 89
        }
      ]
    },
    "pay_per_read": {
      "how": "Sign one of the requirements in the PAYMENT-REQUIRED header (x402 v2, scheme \"exact\") and send the same request again with PAYMENT-SIGNATURE; over MCP, put the payment in _meta[\"x402/payment\"].",
      "usd": "1.00"
    }
  },
  "free_reads": {
    "per_month": 10,
    "resets_on": "2026-11-01",
    "identities": [
      "oauth",
      "key",
      "x402_payer"
    ]
  }
}

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "payTo": "0x46ee460ff2d11dd6262cec6de783f5de86a707da",
    "scheme": "exact",
    "network": "eip155:8453",
    "mimeType": "application/json",
    "resource": "https://api.lodestarindex.com/v1/trust/batch",
    "description": "",
    "maxAmountRequired": "1000000",
    "maxTimeoutSeconds": 60
  }
]

Provenance

Seen in the source catalog

2026-10-06 18:44Z

Last indexed by Roundhouse

2026-10-11 15:46Z

Last enriched (probe, favicon, geo)

2026-10-11 16:46Z

x402 version

1

Max timeout

60s

Liveness probe

HTTP 402