Truth Bear

Live 402 challenge

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

{
  "error": "X-PAYMENT header is required. This endpoint costs $0.25 USDC, above the x402 client default maxValue of $0.10 — raise maxValue to at least 250000 atomic units, or your own client rejects this payment locally and no request ever reaches us. Do not want to raise it? A cheaper alternative you can run right now: GET /gauge?signal_id=hydrology.river-level&entity=07010000&format=thin ($0.01 USDC) - the same official signal plus its offline-recomputable proof - no three-leg chain, one signal only.",
  "rails": {
    "available": [
      "base",
      "solana"
    ],
    "advertised": [
      "base"
    ],
    "optin_hint": "Send \"X-Payment-Network: solana\" (or ?rails=all) to receive every available rail in accepts.",
    "optin_header": "X-Payment-Network",
    "also_advertised_as": {
      "note": "This same 402 is offered twice: the v1 challenge in this body, and a v2 challenge in the PAYMENT-REQUIRED header. They are the SAME offer - identical price, asset and payTo - not two competing ones. Pay with whichever version your client speaks; you do not need both.",
      "rails": "The v2 challenge lists the Solana rail without an opt-in, while this v1 body does not. That is deliberate, not a discrepancy: a v1 network:\"solana\" entry makes some v1 clients reject the WHOLE accepts array, so v1 advertises it only on request. A v2 client matches on solana:5eykt4Us... and is unaffected.",
      "header": "PAYMENT-REQUIRED",
      "naming": "The v2 challenge uses CAIP-2 network ids (eip155:8453, solana:5eykt4Us...) where this v1 body uses the legacy short names (base, solana). Same chains, different identifier scheme - CDP couples the naming to the version, so it cannot be mixed.",
      "encoding": "base64 JSON",
      "x402_version": 2
    }
  },
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0x2d16a243ba9fAcC6AC85519d5efad2149DC4C6c3",
      "amount": "250000",
      "scheme": "exact",
      "network": "base",
      "mimeType": "application/json",
      "resource": "https://api.truthbear.co/gauge/japan-region",
      "extensions": {
        "bazaar": {
          "info": {
            "input": {
              "type": "http",
              "method": "GET"
            },
            "output": {
              "type": "json"
            }
          },
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "input": {
                "type": "object",
                "required": [
                  "type",
                  "method"
                ],
                "properties": {
                  "type": {
                    "const": "http"
                  },
                  "method": {
                    "enum": [
                      "GET"
                    ],
                    "type": "string"
                  }
                }
              },
              "output": {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "const": "json"
                  }
                }
              }
            }
          },
          "priceUsd": "$0.25",
          "discoverable": true,
          "outputSchema": {
            "type": "object",
            "required": [
              "legs",
              "provenance",
              "note"
            ],
            "properties": {
              "legs": {
                "type": "object",
                "description": "Keyed by signal_id; each value is the array described in LEG_ROW.",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "band": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "entity": {
                        "type": "string"
                      },
                      "current": {
                        "type": "object",
                        "description": "Metric keys vary by signal; units are suffixed in the key names."
                      },
                      "percentile": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "entity_name": {
                        "type": [
                          "string",
                          "null"
                        ]
                      },
                      "observed_at": {
                        "type": "string"
                      },
                      "record_hash": {
                        "type": [
                          "string",
                          "null"
                        ]
                      }
                    }
                  },
                  "description": "Latest stored reading per entity for this signal, as published by the source agency."
                }
              },
              "name": {
                "type": "string",
                "description": "Short human-readable name of the region this bundle covers."
              },
              "note": {
                "type": "string",
                "description": "Descriptive-only statement of what was restated and from whom."
              },
              "scope": {
                "type": "string",
                "description": "What this bundle covers, in one line."
              },
              "signals": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "The signal_id keys present in legs."
              },
              "provenance": {
                "type": "object",
                "description": "served_from, data_as_of, oldest_leg_as_of, age_hours_now, freshness."
              },
              "cross_check": {
                "type": "object",
                "description": "The same earthquakes as measured by two independent national agencies, side by side, with a machine-readable comparability block stating which fields may be compared and which may not. Nothing is adjudicated."
              },
              "entities_count": {
                "type": "integer",
                "description": "Total rows across every leg."
              }
            },
            "conditionalProperties": {
              "last_fact": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Most recent qualifying fact for this line and entity, attached centrally (may be absent when the line has no qualifying fact yet)"
              },
              "decision_points": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Swappable decision points for this entity, attached centrally: {count, points:[{tag,current,swappable,how}], note}. Present only when the entity has at least one swappable tag in the index, so bundles for entities without one omit it"
              },
              "leg_availability": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Per-leg degradation disclosure: which legs are present, which are degraded and why. Present only when at least one leg is degraded"
              },
              "record_hash_verifiable": {
                "type": [
                  "object",
                  "null"
                ],
                "description": "Whether this response can recompute its own record_hash offline. Present only when the payload carries a top-level record_hash; may be absent on list-shaped deliveries where verifiability is stated per row instead"
              }
            }
          },
          "routeTemplate": "/gauge/japan-region",
          "priceUsdNumber": 0.25
        }
      },
      "description": "Japan official readings in one call plus an independent cross-agency check: JMA seismic intensity (shindo), RSMC Tokyo typhoon analysis, Ministry of Finance JGB yields across seven tenors, and the Japan rows of BIS and FRED. The same earthquakes appear as JMA measured them and as USGS measured them, side by side - different agencies, different quantities, and we adjudicate nothing. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.",
      "outputSchema": {
        "input": {
          "type": "http",
          "method": "GET",
          "required": [],
          "properties": {},
          "queryParams": {},
          "discoverable": true
        },
        "output": {
          "type": "object",
          "required": [
            "legs",
            "provenance",
            "note"
          ],
          "properties": {
            "legs": {
              "type": "object",
              "description": "Keyed by signal_id; each value is the array described in LEG_ROW.",
              "additionalProperties": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "band": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "entity": {
                      "type": "string"
                    },
                    "current": {
                      "type": "object",
                      "description": "Metric keys vary by signal; units are suffixed in the key names."
                    },
                    "percentile": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "entity_name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "observed_at": {
                      "type": "string"
                    },
                    "record_hash": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                },
                "description": "Latest stored reading per entity for this signal, as published by the source agency."
              }
            },
            "name": {
              "type": "string",
              "description": "Short human-readable name of the region this bundle covers."
            },
            "note": {
              "type": "string",
              "description": "Descriptive-only statement of what was restated and from whom."
            },
            "scope": {
              "type": "string",
              "description": "What this bundle covers, in one line."
            },
            "signals": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "The signal_id keys present in legs."
            },
            "provenance": {
              "type": "object",
              "description": "served_from, data_as_of, oldest_leg_as_of, age_hours_now, freshness."
            },
            "cross_check": {
              "type": "object",
              "description": "The same earthquakes as measured by two independent national agencies, side by side, with a machine-readable comparability block stating which fields may be compared and which may not. Nothing is adjudicated."
            },
            "entities_count": {
              "type": "integer",
              "description": "Total rows across every leg."
            }
          },
          "conditionalProperties": {
            "last_fact": {
              "type": [
                "object",
                "null"
              ],
              "description": "Most recent qualifying fact for this line and entity, attached centrally (may be absent when the line has no qualifying fact yet)"
            },
            "decision_points": {
              "type": [
                "object",
                "null"
              ],
              "description": "Swappable decision points for this entity, attached centrally: {count, points:[{tag,current,swappable,how}], note}. Present only when the entity has at least one swappable tag in the index, so bundles for entities without one omit it"
            },
            "leg_availability": {
              "type": [
                "object",
                "null"
              ],
              "description": "Per-leg degradation disclosure: which legs are present, which are degraded and why. Present only when at least one leg is degraded"
            },
            "record_hash_verifiable": {
              "type": [
                "object",
                "null"
              ],
              "description": "Whether this response can recompute its own record_hash offline. Present only when the payload carries a top-level record_hash; may be absent on list-shaped deliveries where verifiability is stated per row instead"
            }
          }
        }
      },
      "maxAmountRequired": "250000",
      "maxTimeoutSeconds": 300
    }
  ],
  "client_hint": {
    "action": "This endpoint costs $0.25 USDC, above the x402 client default maxValue of $0.10. Raise your client maxValue to at least required_atomic; otherwise the payment is rejected locally inside your own client and never reaches this server, so you will see no error from us.",
    "reason": "price_above_default_client_max_value",
    "example": "wrapFetchWithPayment(fetch, account, BigInt(250000))  // atomic units, USDC 6dp",
    "required_usdc": "0.25",
    "required_atomic": "250000",
    "within_your_budget": [
      {
        "try": "/gauge?signal_id=hydrology.river-level&entity=07010000&format=thin",
        "gets": "the same official signal plus its offline-recomputable proof - no three-leg chain, one signal only",
        "path": "/gauge",
        "usdc": "0.01"
      }
    ],
    "default_client_max_atomic": "100000"
  },
  "x402Version": 1
}

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": "0x2d16a243ba9facc6ac85519d5efad2149dc4c6c3",
    "amount": "250000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  },
  {
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "extra": {
      "feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
    },
    "payTo": "8qEn3Y3GPXdQ28LHshPa4UYeD8V38Lq9b4jCRirQAY3n",
    "amount": "250000",
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET"
      },
      "output": {
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method"
          ],
          "properties": {
            "type": {
              "const": "http"
            },
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            }
          }
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "const": "json"
            }
          }
        }
      }
    },
    "priceUsd": "$0.25",
    "discoverable": true,
    "routeTemplate": "/gauge/japan-region",
    "priceUsdNumber": 0.25,
    "outputSchemaRef": "/manifest"
  }
}

Provenance

Seen in the source catalog

2026-09-07 08:52Z

Last indexed by Roundhouse

2026-09-24 11:30Z

Last enriched (probe, favicon, geo)

2026-09-24 04:45Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 402