{"openapi":"3.0.3","info":{"title":"Aurelius Node 02 - SoCal Pacific Gateway Oracle","version":"1.0.0","description":"Aurelius Node 02: Real-time SoCal Pacific Gateway Corridor ground-truth oracle (Ports of LA & Long Beach, San Pedro Bay, I-710 Corridor, Intermodal Drayage, EV Charging Grid). Provides 42-item telemetry matrix: container freight spot rates, rail spot rates, heavy haul drayage, chassis lease rates, EIA CA diesel rack benchmarks, structural steel/lumber pricing, & maritime vessel dwell telemetry. Returns JSON schema with real-time index metrics & instant $0.05 USDC settlement via Base x402 V2.","contact":{"name":"Aurelius Logistics Network","url":"https://aurelius-node-02-socal.onrender.com"}},"servers":[{"url":"https://aurelius-node-02-socal.onrender.com","description":"Base Mainnet Production Node 02"}],"components":{"schemas":{"SupplyItem":{"type":"object","properties":{"id":{"type":"string","example":"SC-14"},"item_key":{"type":"string","example":"socal_to_chicago_rail_spot_rate"},"category":{"type":"string","example":"intermodal"},"label":{"type":"string","example":"SoCal to Chicago Intermodal Container Spot Rate"},"current_value":{"type":"number","format":"float","example":3250},"unit_of_measure":{"type":"string","example":"USD/container"},"trend_direction":{"type":"string","example":"increasing"},"benchmark_baseline":{"type":"number","format":"float","example":2800},"hub_location":{"type":"string","example":"SoCal Hub"},"source_provider":{"type":"string","example":"Freightos / Cass"},"data_tier":{"type":"string","example":"daily_index"},"status":{"type":"string","example":"active"},"updated_at":{"type":"string","format":"date-time","example":"2026-08-01 12:00:00"}}},"SupplyResponse":{"type":"object","properties":{"node":{"type":"string","example":"Aurelius Node 02"},"region":{"type":"string","example":"SoCal Pacific Gateway Corridor"},"timestamp":{"type":"string","format":"date-time","example":"2026-08-01T12:00:00Z"},"item_count":{"type":"integer","example":42},"data":{"type":"array","items":{"$ref":"#/components/schemas/SupplyItem"}}},"example":{"node":"Aurelius Node 02","region":"SoCal Pacific Gateway Corridor","timestamp":"2026-08-01T12:00:00Z","item_count":42,"data":[{"id":"SC-14","item_key":"socal_to_chicago_rail_spot_rate","category":"intermodal","label":"SoCal to Chicago Intermodal Container Spot Rate","current_value":3250,"unit_of_measure":"USD/container","trend_direction":"increasing","benchmark_baseline":2800,"hub_location":"SoCal Hub","source_provider":"Freightos / Cass","data_tier":"daily_index","status":"active","updated_at":"2026-08-01 12:00:00"}]}},"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-02"},"timestamp":{"type":"string","format":"date-time","example":"2026-08-01T12:00:00.000Z"}}},"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 02 (SoCal Gateway).","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 for SoCal Gateway.","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 for Base Mainnet.","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, CDP Bazaar).","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"}}}},"/.well-known/llms.txt":{"get":{"summary":"Well-Known LLM Context Alias","description":"Standard RFC-compliant well-known alias for llms.txt discovery.","responses":{"200":{"description":"PlainText LLM context overview"}}}},"/api/v1/supply":{"get":{"summary":"SoCal Pacific Gateway Telemetry Query","description":"Paywalled ($0.05 USDC via x402 on Base Mainnet). Returns ground-truth intermodal container freight spot rates, heavy haul drayage, chassis leases, EIA CA diesel rack benchmarks, and maritime telemetry across Ports of LA & Long Beach, San Pedro Bay, and the I-710 Corridor.","x-bazaar":{"discoverable":true,"category":"Data","tags":["socal","pacific-gateway","port-of-los-angeles","port-of-long-beach","san-pedro-bay","i-710-corridor","intermodal-drayage","ev-charging-grid","container-freight","logistics","supply-chain","ground-truth-oracle","structural-steel-lumber","eia-ca-diesel-rack","maritime-telemetry","heavy-haul-drayage"]},"x-x402":{"amount":"50000","currency":"USDC","network":"eip155:8453"},"parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Filter telemetry by category (e.g. 'intermodal', 'drayage', 'energy')."},{"name":"hub","in":"query","required":false,"schema":{"type":"string"},"description":"Filter telemetry by hub location (e.g. 'SoCal Hub', 'Port of LA')."}],"responses":{"200":{"description":"Successful query returning SoCal regional telemetry 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"}}}}}}}}}