{"uid":"cap_bN-Gpd7yNEw-9bAxNC-Pr","slug":"arbipulse-commodity-regional-arbitrage-47918f01","name":"ArbiPulse Commodity Regional Arbitrage","description":"Cross-regional price differentials for oil, gas, metals and grains, with transport-cost breakdown. For commodity and arbitrage agents.","url":"https://arbipulse.vercel.app/api/commodity","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"unit":{"type":"string","description":"bbl | mmbtu | ton | oz | bushel (default: auto)"},"regions":{"type":"string","description":"us,eu,asia,mena,latam (comma-separated, default: all major hubs)"},"commodity":{"type":"string","description":"oil | natural-gas | copper | gold | wheat | corn | soybeans | coffee | cocoa | cotton | lng | coal (default: natural-gas)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"commodity":"natural-gas","scan_time":"2026-06-06T12:00:00Z","futures_basis":{"carry_trade_angle":"Storage economics: if contango > storage + financing cost, buying spot and selling futures is profitable","front_month_vs_next":-0.15,"contango_or_backwardation":"contango"},"global_context":"LNG arbitrage between Henry Hub and Asian JKM represents one of the largest persistent cross-market spreads in commodities. Retail access via UNG (US gas ETF) / JNK hedges or gas producer equities.","key_arb_players":["Shell","TotalEnergies","BP","Vitol","Trafigura","Gunvor"],"pulse_suggestions":[],"seasonal_patterns":"US gas peaks Dec-Feb (heating) and July (cooling). European TTF typically highest Nov-Mar. Asian LNG peaks Jan for heating, Jun-Aug for cooling.","trade_flow_context":"US LNG exports at record levels. EU has replaced ~70% of Russian pipeline gas with LNG. JKM premium over TTF has compressed to lowest in 2 years.","price_differentials":[{"route":"US Gulf Coast → Northeast Asia (LNG)","viable":true,"net_arb_pct":219.3,"net_arb_usd":6.25,"other_costs_usd":1.2,"tariff_cost_usd":0,"blocking_factors":["Requires LNG tanker and liquefaction capacity","Locked by long-term contracts — spot LNG limited"],"gross_spread_pct":349.1,"gross_spread_usd":9.95,"opportunity_window":"3-6 months for spot LNG cargo setup","transport_cost_usd":2.5}],"retail_accessibility":"ETF/futures only","regional_price_matrix":[{"region":"US Gulf Coast","benchmark":"Henry Hub","price_usd":2.85,"price_unit":"$/MMBtu","data_freshness":"live","country_examples":["USA"]},{"region":"Northwest Europe","benchmark":"TTF Hub","price_usd":10.4,"price_unit":"$/MMBtu","data_freshness":"live","country_examples":["Netherlands","Germany","UK"]},{"region":"Northeast Asia","benchmark":"JKM Spot","price_usd":12.8,"price_unit":"$/MMBtu","data_freshness":"live","country_examples":["Japan","South Korea","China"]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dBEGxs8jWcH5BNgHOexDP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns cross-regional price differentials for commodities (oil, gas, metals, grains) with transport cost breakdowns to identify profitable arbitrage opportunities","exampleAgentPrompt":"Show me the cross-regional price differential for crude oil right now — I want to see which two regions have the biggest spread and what the transport cost breakdown looks like so I can judge whether the arbitrage is actually profitable.","exampleUseCases":null,"resultDescription":"Returns a structured breakdown of price differentials for a commodity across regions, including buy-side and sell-side region prices, the gross price spread, itemized transport costs (freight, tariffs, handling), and the estimated net arbitrage margin after transport.","failureModes":["Unsupported commodity type returns 400 with list of valid commodities","Invalid or unrecognized region pair returns 400","Payment not included or insufficient returns 402 Payment Required","Market data temporarily unavailable returns 503","Rate limit exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need commodity-specific arbitrage data that accounts for real-world transport costs between geographic regions — distinct from crypto CEX/DEX arbitrage endpoints. Best for physical commodity trading scenarios involving oil, gas, metals, or agricultural grains where shipping logistics materially affect profitability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:32:57.898Z","isFirstParty":false}