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.

{
  "hint": {
    "miss": "missing_parameter",
    "usage": "/shadow/region-plus?loc=<value>&topic=<value>",
    "missing_params": [
      "loc",
      "topic"
    ],
    "example_request": "/shadow/region-plus?loc=us-stlouis&topic=coin"
  },
  "error": "Missing required query parameter(s): loc, topic. A request you can run right now: GET /shadow/region-plus?loc=us-stlouis&topic=coin\nX-PAYMENT header is required. This endpoint costs $0.35 USDC, above the x402 client default maxValue of $0.10 — raise maxValue to at least 350000 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 ($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": "350000",
      "scheme": "exact",
      "network": "base",
      "mimeType": "application/json",
      "resource": "https://api.truthbear.co/shadow/region-plus",
      "extensions": {
        "bazaar": {
          "info": {
            "input": {
              "type": "http",
              "method": "GET",
              "queryParams": {
                "loc": "required - location key; see the /gauge/region listing for valid values",
                "topic": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
              }
            },
            "output": {
              "type": "json"
            }
          },
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "input": {
                "type": "object",
                "required": [
                  "type",
                  "method",
                  "queryParams"
                ],
                "properties": {
                  "type": {
                    "const": "http"
                  },
                  "method": {
                    "enum": [
                      "GET"
                    ],
                    "type": "string"
                  },
                  "queryParams": {
                    "type": "object",
                    "required": [
                      "loc",
                      "topic"
                    ],
                    "properties": {
                      "loc": {
                        "type": "string",
                        "examples": [
                          "us-stlouis",
                          "us-memphis",
                          "us-losangeles",
                          "us-fresno",
                          "us-phoenix",
                          "us-denver"
                        ],
                        "description": "required - location key; see the /gauge/region listing for valid values",
                        "x-accepted-values": {
                          "all": "https://api.truthbear.co/schemas/shadow-region-plus.input.json",
                          "shown": 6,
                          "total": 12
                        }
                      },
                      "topic": {
                        "type": "string",
                        "examples": [
                          "coin"
                        ],
                        "description": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
                      }
                    },
                    "additionalProperties": false
                  }
                }
              },
              "output": {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "const": "json"
                  }
                }
              }
            }
          },
          "priceUsd": "$0.35",
          "discoverable": true,
          "outputSchema": {
            "type": "object",
            "required": [
              "official",
              "unverified",
              "separation"
            ],
            "properties": {
              "official": {
                "type": "object",
                "required": [
                  "nature",
                  "legs"
                ],
                "properties": {
                  "legs": {
                    "type": "object",
                    "description": "CORE DELIVERY: per-leg readings, keyed by leg name (e.g. drought/heat/crop-vhi); each value carries signal_id/current/observed_at/data_age_hours/record_hash"
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Human-readable name of the object"
                  },
                  "note": {
                    "type": "string",
                    "description": "Conditional - endpoint-specific honest disclosure (limits, granularity, disclaimer); some endpoints omit it"
                  },
                  "grade": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Honest data-grade disclosure (e.g. \"screening-level, not decision-grade\")"
                  },
                  "scope": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Honest statement of scope and limits: monitoring is not forecasting, intelligence is not instruction, and the boundary of what is verifiable"
                  },
                  "nature": {
                    "type": "string",
                    "description": "Neutrality statement: GAUGE supplies observations and trend description only - no judgement, no prediction, no recommendation"
                  },
                  "location": {
                    "type": "string",
                    "description": "The location key of this bundle - the ?loc= you passed in"
                  },
                  "_citation": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Offline-verifiable citation: {statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url} - the trust root for zero-trust self-verification"
                  },
                  "provenance": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Data lineage: {served_from, data_as_of, oldest_leg_as_of, data_age_hours (frozen age, reference only), age_hours_now (age computed at request time - the real basis for freshness), freshness(fresh|recent|stale), freshness_basis (the cadence and threshold used for this row, as a string), dead_source (optional: upstream frozen or discontinued), data_lineage:[{signal,traceable_to,uncertainty,record_hash,...}], validation_status}. Freshness is cadence-aware, so monthly/quarterly/annual official lines are not misjudged against a 24h rule; the same basis is used by free /gauge/coverage. Buyers can trace back to the official source"
                  },
                  "data_timespans": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "description": "Per-leg observation time and hours elapsed since"
                  },
                  "decision_points": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "{count, points:[{tag,current,swappable,how}], note} - decision points you can re-run with a swapped tag (one swapped tag = one call); leave it alone and the original context is the default, at no extra charge"
                  },
                  "cross_line_narrative": {
                    "type": "string",
                    "description": "Cross-line comparison narrative (purely descriptive; no judgement, no prediction)"
                  }
                },
                "additionalProperties": true,
                "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"
                  }
                }
              },
              "separation": {
                "type": "object",
                "description": "{rule, why} - machine-readable statement of the isolation guarantee, so a buyer never has to infer it from prose"
              },
              "unverified": {
                "type": "object",
                "description": "UNVERIFIED half, structurally separated: public-channel chatter from the last 48h plus a non-reproducible LLM trend summary. Never merged into the authoritative half and never part of its hash"
              }
            }
          },
          "routeTemplate": "/shadow/region-plus",
          "priceUsdNumber": 0.35
        }
      },
      "description": "[3-LEG+CHATTER] A full three-leg regional bundle with per-leg proof, PLUS the unverified public-channel chatter for a topic from the last 48h - two separate top-level keys, never merged. The unverified half is stored apart with an update-forbidding trigger and is not part of any official hash, so the authoritative half stays offline-recomputable. Nothing posted in the window -> 422 no_charge, not billed (check GET /shadow/catalog first, free). $0.35 per call.",
      "outputSchema": {
        "input": {
          "type": "http",
          "method": "GET",
          "example": {
            "loc": "us-stlouis",
            "topic": "coin"
          },
          "required": [
            "loc",
            "topic"
          ],
          "properties": {
            "loc": {
              "type": "string",
              "examples": [
                "us-stlouis",
                "us-memphis",
                "us-losangeles",
                "us-fresno",
                "us-phoenix",
                "us-denver"
              ],
              "description": "required - location key; see the /gauge/region listing for valid values",
              "x-accepted-values": {
                "all": "https://api.truthbear.co/schemas/shadow-region-plus.input.json",
                "shown": 6,
                "total": 12
              }
            },
            "topic": {
              "type": "string",
              "examples": [
                "coin"
              ],
              "description": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
            }
          },
          "queryParams": {
            "loc": "required - location key; see the /gauge/region listing for valid values",
            "topic": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
          },
          "discoverable": true,
          "exampleRequest": "/shadow/region-plus?loc=us-stlouis&topic=coin"
        },
        "output": {
          "type": "object",
          "required": [
            "official",
            "unverified",
            "separation"
          ],
          "properties": {
            "official": {
              "type": "object",
              "required": [
                "nature",
                "legs"
              ],
              "properties": {
                "legs": {
                  "type": "object",
                  "description": "CORE DELIVERY: per-leg readings, keyed by leg name (e.g. drought/heat/crop-vhi); each value carries signal_id/current/observed_at/data_age_hours/record_hash"
                },
                "name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Human-readable name of the object"
                },
                "note": {
                  "type": "string",
                  "description": "Conditional - endpoint-specific honest disclosure (limits, granularity, disclaimer); some endpoints omit it"
                },
                "grade": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Honest data-grade disclosure (e.g. \"screening-level, not decision-grade\")"
                },
                "scope": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Honest statement of scope and limits: monitoring is not forecasting, intelligence is not instruction, and the boundary of what is verifiable"
                },
                "nature": {
                  "type": "string",
                  "description": "Neutrality statement: GAUGE supplies observations and trend description only - no judgement, no prediction, no recommendation"
                },
                "location": {
                  "type": "string",
                  "description": "The location key of this bundle - the ?loc= you passed in"
                },
                "_citation": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "Offline-verifiable citation: {statement_type, not_advice:bool, claim, fact, source, record_hash, signature(Ed25519), key_id, issuer_DID(did:key), verify_url} - the trust root for zero-trust self-verification"
                },
                "provenance": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "Data lineage: {served_from, data_as_of, oldest_leg_as_of, data_age_hours (frozen age, reference only), age_hours_now (age computed at request time - the real basis for freshness), freshness(fresh|recent|stale), freshness_basis (the cadence and threshold used for this row, as a string), dead_source (optional: upstream frozen or discontinued), data_lineage:[{signal,traceable_to,uncertainty,record_hash,...}], validation_status}. Freshness is cadence-aware, so monthly/quarterly/annual official lines are not misjudged against a 24h rule; the same basis is used by free /gauge/coverage. Buyers can trace back to the official source"
                },
                "data_timespans": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "description": "Per-leg observation time and hours elapsed since"
                },
                "decision_points": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "{count, points:[{tag,current,swappable,how}], note} - decision points you can re-run with a swapped tag (one swapped tag = one call); leave it alone and the original context is the default, at no extra charge"
                },
                "cross_line_narrative": {
                  "type": "string",
                  "description": "Cross-line comparison narrative (purely descriptive; no judgement, no prediction)"
                }
              },
              "additionalProperties": true,
              "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"
                }
              }
            },
            "separation": {
              "type": "object",
              "description": "{rule, why} - machine-readable statement of the isolation guarantee, so a buyer never has to infer it from prose"
            },
            "unverified": {
              "type": "object",
              "description": "UNVERIFIED half, structurally separated: public-channel chatter from the last 48h plus a non-reproducible LLM trend summary. Never merged into the authoritative half and never part of its hash"
            }
          }
        }
      },
      "maxAmountRequired": "350000",
      "maxTimeoutSeconds": 300
    }
  ],
  "client_hint": {
    "action": "This endpoint costs $0.35 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(350000))  // atomic units, USDC 6dp",
    "required_usdc": "0.35",
    "required_atomic": "350000",
    "within_your_budget": [
      {
        "try": "/gauge?signal_id=hydrology.river-level&entity=07010000",
        "gets": "the same official signal plus its offline-recomputable proof - no three-leg chain, one signal only",
        "path": "/gauge",
        "usdc": "0.01"
      },
      {
        "try": "/shadow/signal-plus?signal_id=hydrology.river-level&entity=07010000&topic=coin",
        "gets": "that same signal and proof plus 48h unverified public-channel chatter, kept in a separate key",
        "path": "/shadow/signal-plus",
        "usdc": "0.09"
      }
    ],
    "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": "350000",
    "scheme": "exact",
    "network": "eip155:8453",
    "maxTimeoutSeconds": 300
  },
  {
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "extra": {
      "feePayer": "D6ZhtNQ5nT9ZnTHUbqXZsTx5MH2rPFiBBggX4hY1WePM"
    },
    "payTo": "8qEn3Y3GPXdQ28LHshPa4UYeD8V38Lq9b4jCRirQAY3n",
    "amount": "350000",
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "type": "http",
        "method": "GET",
        "example": {
          "loc": "us-stlouis",
          "topic": "tariff"
        },
        "queryParams": {
          "loc": "required - location key; see the /gauge/region listing for valid values",
          "topic": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
        },
        "exampleRequest": "/shadow/region-plus?loc=us-stlouis&topic=tariff"
      },
      "output": {
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "queryParams"
          ],
          "properties": {
            "type": {
              "const": "http"
            },
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "type": "object",
              "required": [
                "loc",
                "topic"
              ],
              "properties": {
                "loc": {
                  "type": "string",
                  "examples": [
                    "us-stlouis",
                    "us-memphis",
                    "us-losangeles",
                    "us-fresno",
                    "us-phoenix",
                    "us-denver"
                  ],
                  "description": "required - location key; see the /gauge/region listing for valid values",
                  "x-accepted-values": {
                    "all": "https://api.truthbear.co/schemas/shadow-region-plus.input.json",
                    "shown": 6,
                    "total": 12
                  }
                },
                "topic": {
                  "type": "string",
                  "examples": [
                    "tariff"
                  ],
                  "description": "required - chatter topic id; free in-stock list at GET /shadow/catalog"
                }
              },
              "additionalProperties": false
            }
          }
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "const": "json"
            }
          }
        }
      }
    },
    "priceUsd": "$0.35",
    "discoverable": true,
    "routeTemplate": "/shadow/region-plus",
    "priceUsdNumber": 0.35,
    "outputSchemaRef": "/manifest"
  }
}

Provenance

Seen in the source catalog

2026-08-26 03:02Z

Last indexed by Roundhouse

2026-08-27 18:40Z

Last enriched (probe, favicon, geo)

2026-09-23 21:15Z

x402 version

2

Max timeout

300s

Liveness probe

HTTP 400