{"definitionRoot":"b18ce7435f33cda178cc5995e17df48ecf2121250238811fa7b07fa28dfb5544","docsPath":"/docs/WEATHER_FORECAST_AT_POINT.json","errors":[{"code":null,"description":"The request field is invalid.","status":400},{"code":null,"description":"Payment Required - an x402 v2 offer in the PAYMENT-REQUIRED header and body.","status":402},{"code":null,"description":"The result could not be delivered.","status":422},{"code":null,"description":"The seller or the product quote path is not currently admitting this request.","status":503}],"examples":{"deliverable":null,"detail":"Concrete request/deliverable examples are omitted until real settled evidence supplies them; the no-fake-demand rule forbids inventing sample payloads. The envelope shapes above are exact.","request":null,"state":"OMITTED_UNTIL_REAL_EVIDENCE"},"family":"UTILITY","familyTitle":"Utility","freshness":{"evidenceCutoff":"Every delivered envelope states its own evidenceCutoff; requests may pin evidenceCutoff at or before quote time.","freshnessClass":"CURRENT_SNAPSHOT","latencyClass":"STANDARD","machineVersion":"df8b5c0c","outputDomainKind":null,"provenance":"The deliverable carries its own uncertainty statement; citations are opaque content hashes for the public evidence used."},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"latitude":{"description":"Latitude in decimal degrees (WGS 84, north positive), e.g. 39.7456. Rounded to 4 decimal places (the precision NWS names points with); the point must be in the contiguous United States, Alaska, Hawaii, Puerto Rico, the US Virgin Islands, Guam or the Northern Mariana Islands (coastal waters included), or it is refused without charge.","type":"number"},"longitude":{"description":"Longitude in decimal degrees (WGS 84, east positive), e.g. -97.0892. Rounded to 4 decimal places (the precision NWS names points with); the point must be in the contiguous United States, Alaska, Hawaii, Puerto Rico, the US Virgin Islands, Guam or the Northern Mariana Islands (coastal waters included), or it is refused without charge.","type":"number"}},"required":["latitude","longitude"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"method":"POST","operationId":"agenthubmachineweather_forecast_at_point","outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"citations":{"description":"Content hashes of Arbiter's archived official-record readings this deliverable was rendered from.","items":{},"type":"array"},"observedAt":{"description":"ISO-8601 instant of the newest official read behind this deliverable.","type":"string"},"program":{"description":"Program identity: {id, version, programRoot, registryRoot}.","type":"object"},"record":{"description":"Point forecast: {status: FOUND|NOT_FOUND|NO_FORECAST_GRID, point {latitude, longitude}, location {forecastOffice, gridId, gridX, gridY, timeZone, forecastZone, county, fireWeatherZone, radarStation, nearestPlace {city, state, distanceMeters, bearingDegrees}}, forecast {units, generatedAt, updateTime, validTimes, elevationMeters, periodCount, periodsOmitted, periods[{number, name, startTime, endTime, isDaytime, temperature, temperatureUnit, temperatureTrend, probabilityOfPrecipitationPercent, windSpeed, windDirection, shortForecast, detailedForecast}]}}; NOT_FOUND when NWS holds no forecast for the point, NO_FORECAST_GRID when it names no grid cell (location and forecast are then null). Period texts are {status: OK, value} or {status: WITHHELD_UNSAFE_TEXT, rawSha256}; the detailed forecast is cut at 600 characters (a cut ends with an ellipsis).","type":"object"},"source":{"description":"Attribution: {publisher, endpoints[], retrievedAt, rightsBasis: US_FEDERAL_PUBLIC_RECORD_SELF_OBSERVED, endorsement: NONE, notice} - notice: the record is derived by Arbiter from public-domain US National Weather Service data, is not an official NWS product, and claims no copyright in NWS material.","type":"object"},"subject":{"description":"What was looked up: {kind: NWS_POINT, latitude, longitude} (the requested point rounded to 4 decimal places, as sent to NWS) or {kind: NWS_ALERT_AREA, area}.","type":"object"},"uncertainty":{"description":"Plain-language limits of this record.","type":"string"}},"required":["program","subject","record","source","citations","observedAt","uncertainty"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"payment":{"admitted":true,"challengeHeader":"PAYMENT-REQUIRED","destination":{"address":"0x63aA5960943865e7d57FDdF0D899eE36B6D2046E","assetContracts":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85","0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392","0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","0x754704Bc059F8C67012fEd69BC8A327a5aafb603","0xaf88d065e77c8cC2239327C5EDb3A432268e5831","0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E","0x3600000000000000000000000000000000000000","0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"bindingVersion":"a2f250e514c4a05c34efc98c49a4f4ac01a67770884883d19ff3a6487972ed90","networks":["eip155:1","eip155:10","eip155:1329","eip155:137","eip155:143","eip155:42161","eip155:43114","eip155:5042","eip155:8453"],"resolvable":true,"source":"x402_seller_configuration.payTo"},"logicalPaymentHeader":"ARBITER-LOGICAL-PAYMENT-ID","payToSource":"the canonical RevenueWalletResolver binding (x402_seller_configuration.payTo); never an environment value and never a literal","paymentIdentifier":{"extension":"payment-identifier","semantics":"Retries carrying the same payment identifier return the cached delivery with the same receipt: no second settlement, no second work, no second delivery credit.","supported":true},"processingSemantics":"A 202 means verification or settlement is still in progress; retry the same call with the same payment and the same payment identifier.","protocol":"X402_V2","protocolVersion":2,"quoteHeader":"ARBITER-QUOTE-ID","scheme":"exact","signatureHeader":"PAYMENT-SIGNATURE"},"pricing":{"currency":"USD","floorUsd":0.001,"mode":"DYNAMIC_QUOTE","ownerCeilingUsd":null,"pricingClass":"CURRENT_UNIT","publicStartingPriceUsd":0.001},"productId":"WEATHER_FORECAST_AT_POINT","productVersion":"1.0.0","provenance":{"basis":"PUBLIC_RECORD","protocols":[],"sources":["US National Weather Service"]},"resourceUrl":"https://arbiterverse.com/api/x402/WEATHER_FORECAST_AT_POINT","schemaVersion":"1.0.0","summary":"The official US National Weather Service forecast for one US latitude/longitude: up to 14 twelve-hour periods with temperature, chance of precipitation, wind and NWS forecast text, plus the forecast office, grid cell, time zone and nearest place. Read from api.weather.gov after payment and cited to Arbiter's archived copy. Example request: {\"latitude\":39.7456,\"longitude\":-97.0892}. Covers the 50 states, Puerto Rico, the US Virgin Islands, Guam and the Northern Mariana Islands.","title":"US weather forecast for a point"}