Trade Freight Rates

{
  "benchmark": {
    "90day_avg_usd": 2550,
    "vs_90day_pct": "+12%"
  },
  "current_rate": {
    "trend": "rising",
    "unit": "per 40ft container",
    "usd_per_unit": 2850
  },
  "lane": "Shanghai → Los Angeles",
  "mode": "ocean",
  "route_status": {
    "active_disruptions": [
      "Red Sea diversions"
    ],
    "congestion_level": "medium"
  },
  "top_carriers": [
    {
      "name": "Maersk",
      "reliability_score": "8.2/10"
    }
  ],
  "transit_time": {
    "days_max": 16,
    "days_min": 14,
    "typical": "14-16 days"
  }
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://tradepulse.theaslangroupllc.com/api/trade/freight-rates?container_type=20ft+%7C+40ft+%7C+40hc+%7C+lcl+%28default%3A+40ft%29&destination=%28required%29+destination+port+city+or+country+%E2%80%94+e.g.+Los+Angeles%2C+Hamburg%2C+Sydney&lang=en+%7C+es+%7C+fr+%7C+de+%7C+ja+%7C+pt+%7C+zh+%7C+ko+%7C+ar+%28default%3A+en%29&mode=ocean+%7C+air+%7C+both+%28default%3A+ocean%29&origin=%28required%29+origin+port+city+or+country+%E2%80%94+e.g.+Shanghai%2C+Rotterdam%2C+Los+Angeles'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://tradepulse.theaslangroupllc.com/api/trade/freight-rates?container_type=20ft+%7C+40ft+%7C+40hc+%7C+lcl+%28default%3A+40ft%29&destination=%28required%29+destination+port+city+or+country+%E2%80%94+e.g.+Los+Angeles%2C+Hamburg%2C+Sydney&lang=en+%7C+es+%7C+fr+%7C+de+%7C+ja+%7C+pt+%7C+zh+%7C+ko+%7C+ar+%28default%3A+en%29&mode=ocean+%7C+air+%7C+both+%28default%3A+ocean%29&origin=%28required%29+origin+port+city+or+country+%E2%80%94+e.g.+Shanghai%2C+Rotterdam%2C+Los+Angeles' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.1 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.1" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.1 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ftradepulse.theaslangroupllc.com%2Fapi%2Ftrade%2Ffreight-rates
const res = await pay("https://tradepulse.theaslangroupllc.com/api/trade/freight-rates?container_type=20ft+%7C+40ft+%7C+40hc+%7C+lcl+%28default%3A+40ft%29&destination=%28required%29+destination+port+city+or+country+%E2%80%94+e.g.+Los+Angeles%2C+Hamburg%2C+Sydney&lang=en+%7C+es+%7C+fr+%7C+de+%7C+ja+%7C+pt+%7C+zh+%7C+ko+%7C+ar+%28default%3A+en%29&mode=ocean+%7C+air+%7C+both+%28default%3A+ocean%29&origin=%28required%29+origin+port+city+or+country+%E2%80%94+e.g.+Shanghai%2C+Rotterdam%2C+Los+Angeles");
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.1 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.1"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://tradepulse.theaslangroupllc.com/api/trade/freight-rates?container_type=20ft+%7C+40ft+%7C+40hc+%7C+lcl+%28default%3A+40ft%29&destination=%28required%29+destination+port+city+or+country+%E2%80%94+e.g.+Los+Angeles%2C+Hamburg%2C+Sydney&lang=en+%7C+es+%7C+fr+%7C+de+%7C+ja+%7C+pt+%7C+zh+%7C+ko+%7C+ar+%28default%3A+en%29&mode=ocean+%7C+air+%7C+both+%28default%3A+ocean%29&origin=%28required%29+origin+port+city+or+country+%E2%80%94+e.g.+Shanghai%2C+Rotterdam%2C+Los+Angeles")
    print(res.status_code, res.text)