# Shipping & Logistics Calc

Dimensional weight, CBM, box and pallet packing, container load, landed cost and unit-price maths.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://shipping-calc.x402tookit.com/openapi.json
- x402 manifest: https://shipping-calc.x402tookit.com/.well-known/x402
- Catalog (free): https://shipping-calc.x402tookit.com/catalog
- Health (free): https://shipping-calc.x402tookit.com/health
- Uptime (free): https://shipping-calc.x402tookit.com/uptime

## Endpoints (8)

### GET /box-packing — $0.02
How many identical boxes fit inside a larger box or crate: best of six orientations in a simple grid, with utilization.
Params: outerLength: number, outerWidth: number, outerHeight: number, itemLength: number, itemWidth: number, itemHeight: number, unit?: string, upright?: string
Example: https://shipping-calc.x402tookit.com/box-packing?outerLength=24&outerWidth=18&outerHeight=12&itemLength=5&itemWidth=4&itemHeight=3&unit=in

### GET /cbm — $0.02
Cubic metres (CBM) and cubic feet of cartons, air volumetric weight (1:6000) and sea chargeable volume.
Params: length: number, width: number, height: number, unit?: string, cartons?: integer, grossWeightKg?: number
Example: https://shipping-calc.x402tookit.com/cbm?length=60&width=40&height=40&unit=cm&cartons=100&grossWeightKg=12

### GET /container-load — $0.02
Cartons per 20GP, 40GP or 40HC container by grid packing and payload limit, with CBM used and what limits the load.
Params: length: number, width: number, height: number, unit?: string, container?: string, cartonWeightKg?: number, maxPayloadKg?: number, upright?: string
Example: https://shipping-calc.x402tookit.com/container-load?length=60&width=40&height=40&unit=cm&container=40HC&cartonWeightKg=12

### GET /dim-weight — $0.02
Dimensional weight and billable weight for a parcel from its size and actual weight, with an overridable carrier divisor.
Params: length: number, width: number, height: number, weight: number, unit?: string, divisor?: number, roundDims?: string
Example: https://shipping-calc.x402tookit.com/dim-weight?length=12&width=12&height=12&weight=5&unit=in

### GET /freight-density — $0.02
Cargo density in kg/m3 and lb/ft3, stowage factor, and whether air (1:6000) or sea freight bills on weight or volume.
Params: weightKg: number, length: number, width: number, height: number, unit?: string
Example: https://shipping-calc.x402tookit.com/freight-density?weightKg=120&length=120&width=80&height=100&unit=cm

### GET /landed-cost — $0.02
Per-unit landed cost from unit price, freight, insurance, duty (FOB or CIF basis), VAT/tax and fees.
Params: unitCost: number, units: integer, freight?: number, insurance?: number, dutyPct?: number, taxPct?: number, otherFees?: number, dutyBasis?: string
Example: https://shipping-calc.x402tookit.com/landed-cost?unitCost=4.5&units=1000&freight=800&insurance=30&dutyPct=6.5&taxPct=20&otherFees=150

### GET /pallet-stack — $0.02
Cartons per pallet layer and per pallet within a height limit: GMA 48x40, Euro 120x80 or ISO, with weight check.
Params: length: number, width: number, height: number, unit?: string, pallet?: string, maxHeightCm?: number, cartonWeightKg?: number, maxWeightKg?: number, allowOverhang?: string
Example: https://shipping-calc.x402tookit.com/pallet-stack?length=40&width=30&height=25&unit=cm&pallet=euro&cartonWeightKg=8

### GET /unit-price — $0.02
Compare package sizes by price per 100 g, 100 ml or per item across mixed units, ranked with savings.
Params: items: string
Example: https://shipping-calc.x402tookit.com/unit-price?items=%5B%7B%22name%22%3A%22Small%22%2C%22price%22%3A4%2C%22amount%22%3A16%2C%22unit%22%3A%22oz%22%7D%2C%7B%22name%22%3A%22Large%22%2C%22price%22%3A3.8%2C%22amount%22%3A1%2C%22unit%22%3A%22lb%22%7D%2C%7B%22name%22%3A%22Bulk%22%2C%22price%22%3A7%2C%22amount%22%3A500%2C%22unit%22%3A%22g%22%7D%5D

## Terms

Logistics arithmetic computed locally from the inputs given, provided as is. Carrier divisors, container dimensions and weight limits vary by carrier, line and year: every endpoint lets you override them and states the assumption used. Packing counts are simple grid layouts, a lower bound on what a skilled packer achieves. Not a carrier quote, customs or tax advice.