{"openapi":"3.0.3","info":{"title":"Aurelius Node 01 - Texas Regional Supply Oracle","version":"1.0.0","description":"Aurelius Node 01: Real-time Texas Regional Corridor ground-truth oracle (DFW, Permian, Gulf Coast, Central TX). Provides 46-item supply matrix: structural steel, industrial copper/aluminum, OCTG casing, oilfield supply, piping, aggregates, concrete & green energy infrastructure. Includes EIA fuel rack benchmarks & spot hotshot freight rates. Returns JSON schema with stock levels, lat/lng, lead times, hazmat status, & instant $0.05 USDC settlement via Base x402 V2.","contact":{"name":"Aurelius Logistics Network","url":"https://aurelius-node-01.onrender.com"}},"servers":[{"url":"https://aurelius-node-01.onrender.com","description":"Base Mainnet Production Node 01"}],"components":{"schemas":{"SupplyItem":{"type":"object","properties":{"id":{"type":"integer","example":42},"item_name":{"type":"string","example":"OCTG Casing Pipe 7in L80 Seamless"},"category":{"type":"string","example":"Steel & Piping"},"stock_level":{"type":"number","example":1250},"unit_price_usd":{"type":"number","format":"float","example":42.5},"unit_of_measure":{"type":"string","example":"linear_foot"},"spec_grade":{"type":"string","example":"API 5CT L80"},"hub_name":{"type":"string","example":"Permian Basin Hub Alpha"},"city":{"type":"string","example":"Midland"},"state":{"type":"string","example":"TX"},"zip_code":{"type":"string","example":"79701"},"lat":{"type":"number","format":"float","example":31.9974},"lng":{"type":"number","format":"float","example":-102.0779},"weight_lbs_per_unit":{"type":"number","format":"float","example":26},"length_ft":{"type":"number","format":"float","example":40},"availability_type":{"type":"string","example":"Immediate Yard Stock"},"lead_time_hours":{"type":"number","example":4},"hazmat":{"type":"boolean","example":false},"min_order_qty":{"type":"number","example":100},"min_ticket_usd":{"type":"number","format":"float","example":50},"allows_hotshot":{"type":"boolean","example":true},"allows_customer_pickup":{"type":"boolean","example":true},"updated_at":{"type":"string","format":"date-time","example":"2026-07-29T14:30:00Z"}}},"SupplyResponse":{"type":"object","properties":{"node":{"type":"string","example":"Aurelius Node 01"},"region":{"type":"string","example":"Texas Regional Corridor"},"timestamp":{"type":"string","format":"date-time","example":"2026-07-29T14:30:00Z"},"item_count":{"type":"integer","example":46},"data":{"type":"array","items":{"$ref":"#/components/schemas/SupplyItem"}}},"example":{"node":"Aurelius Node 01","region":"Texas Regional Corridor","timestamp":"2026-07-29T14:30:00Z","item_count":46,"data":[{"id":42,"item_name":"OCTG Casing Pipe 7in L80 Seamless","category":"Steel & Piping","stock_level":1250,"unit_price_usd":42.5,"unit_of_measure":"linear_foot","spec_grade":"API 5CT L80","hub_name":"Permian Basin Hub Alpha","city":"Midland","state":"TX","zip_code":"79701","lat":31.9974,"lng":-102.0779,"weight_lbs_per_unit":26,"length_ft":40,"availability_type":"Immediate Yard Stock","lead_time_hours":4,"hazmat":false,"min_order_qty":100,"min_ticket_usd":50,"allows_hotshot":true,"allows_customer_pickup":true,"updated_at":"2026-07-29T14:30:00Z"}]}},"X402Challenge":{"type":"object","properties":{"x402Version":{"type":"integer","example":2},"resource":{"type":"object","properties":{"url":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string","example":"application/json"}}},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","example":"exact"},"network":{"type":"string","example":"eip155:8453"},"asset":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"amount":{"type":"string","example":"50000"},"payTo":{"type":"string","example":"0x239DE97929b20F27aa503B236d33420670Bf5Ad1"},"maxTimeoutSeconds":{"type":"integer","example":300}}}}}},"HealthResponse":{"type":"object","properties":{"status":{"type":"string","example":"ONLINE"},"node":{"type":"string","example":"Aurelius-01"},"timestamp":{"type":"string","format":"date-time","example":"2026-07-30T03:42:18.723Z"}}},"NodeRoot":{"type":"object","properties":{"message":{"type":"string"},"status":{"type":"string","example":"ONLINE"},"manifests":{"type":"array","items":{"type":"string"}},"health":{"type":"string","example":"/health"},"supply_endpoint":{"type":"string","example":"/api/v1/supply"}}}}},"paths":{"/":{"get":{"summary":"Node Root Discovery","description":"Returns operational status and manifest links for Node 01.","responses":{"200":{"description":"Node operational","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NodeRoot"}}}}}}},"/health":{"get":{"summary":"Health Check","description":"Returns node uptime and oracle sync status.","responses":{"200":{"description":"Node healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/.well-known/agent.json":{"get":{"summary":"Agent-to-Agent Manifest","description":"A2A discovery manifest outlining capabilities, documentation, and payment endpoints.","responses":{"200":{"description":"Agent manifest payload"}}}},"/.well-known/x402.json":{"get":{"summary":"x402 Payment Spec Manifest","description":"x402 facilitator declarations, USDC contract addresses, and pricing structure.","responses":{"200":{"description":"x402 spec manifest payload"}}}},"/openapi.json":{"get":{"summary":"Raw OpenAPI 3.0 Specification","description":"Machine-readable OpenAPI spec for AI agent frameworks (LangChain, AutoGPT, GPT Actions).","responses":{"200":{"description":"OpenAPI 3.0 JSON specification"}}}},"/swagger.json":{"get":{"summary":"Swagger JSON Specification Alias","description":"Alias endpoint serving the raw OpenAPI spec JSON.","responses":{"200":{"description":"OpenAPI 3.0 JSON specification"}}}},"/docs":{"get":{"summary":"Interactive Swagger UI Documentation","description":"Human-friendly interactive API documentation and testing portal.","responses":{"200":{"description":"Swagger UI HTML portal"}}}},"/robots.txt":{"get":{"summary":"Crawler Directives","description":"Provides web crawler and agent indexer scraping permissions.","responses":{"200":{"description":"PlainText robots.txt rules"}}}},"/llms.txt":{"get":{"summary":"LLM Context File","description":"Plaintext context file optimized for Large Language Model intake and tool discovery.","responses":{"200":{"description":"PlainText LLM context overview"}}}},"/api/v1/supply":{"get":{"summary":"Texas Regional Industrial Supply Query","description":"Paywalled ($0.05 USDC via x402 on Base Mainnet). Returns ground-truth industrial inventory, EIA fuel-adjusted rack pricing, and hotshot freight rates across DFW, Permian Basin, Gulf Coast, and Central TX.","x-bazaar":{"discoverable":true,"category":"Data","tags":["texas","permian-basin","dfw","logistics","supply-chain","freight","ground-truth-oracle","steel-pipe","copper-aluminum","lumber-aggregates","concrete-infrastructure","eia-fuel-rack","hotshot-freight","oilfield-utility","renewable-energy"]},"x-x402":{"amount":"50000","currency":"USDC","network":"eip155:8453"},"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Filter inventory by category (e.g. 'Metals / Steel', 'Fuel')."},{"name":"hub","in":"query","required":false,"schema":{"type":"string"},"description":"Filter inventory by logistics hub (e.g. 'DFW Inland Port Hub')."}],"responses":{"200":{"description":"Successful query returning Texas regional supply matrix with settlement receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplyResponse"}}}},"401":{"description":"Replay attack detected or expired/malformed nonce."},"402":{"description":"Payment Required. Returns x402 V2 challenge payload and Base Mainnet payment contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/X402Challenge"}}}}}}}}}