agentutility(7)$ man tariff-duty-scenario
/tariff-duty-scenario
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgefinanceCATEGORY
uncategorized
STATUS
● live
NAME
tariff-duty-scenario — calculates import duty what-if scenarios: current vs proposed duty and landed-cost deltas from caller-supplied values, rates, freight, in…
SYNOPSIS
POST https://x402.agentutility.ai/tariff-duty-scenario
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Calculates import duty what-if scenarios: current vs proposed duty and landed-cost deltas from caller-supplied values, rates, freight, insurance, quantity, origin, destination, and optional HTS code. Scenario math only: does not choose final HTS classification, act as customs broker, or file customs documents. Use it as a tariff duty scenario calculator, landed cost delta API, or HTS cost scenario tool.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| product_value | number | Commercial value of the goods before duty. | required |
| freight | number | Optional freight amount included in customs-value scenario. | optional |
| insurance | number | Optional insurance amount included in customs-value scenario. | optional |
| current_duty_rate_pct | number | Current duty rate percent, e.g. 7.5. | required |
| proposed_duty_rate_pct | number | Proposed or alternate duty rate percent. | required |
| quantity | number | Optional unit count for per-unit landed cost. | optional |
| currency | string | Currency code. Default USD. | optional |
| hts_code | string | Optional caller-supplied HTS code. | optional |
| country_of_origin | string | — | optional |
| destination_country | string | — | optional |
| product_description | string | — | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| customs_value | string | — |
| current | string | — |
| proposed | string | — |
| delta | string | — |
| boundary | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/tariff-duty-scenario \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the tariff-duty-scenario tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- edge-financetariffdutyscenariotariff-duty-scenario
- methods
- POST
- cluster
- edgefinance
- price
- $0.02 USDC per call
ADJACENT — other endpoints in edgefinance
| endpoint | description | price |
|---|---|---|
| bls-occupational-stats | BLS Public Data API — wages, employment levels, growth by series ID. | $0.02 |
| polymarket-kalshi-arbitrage | Scans for arbitrage between Polymarket and Kalshi prediction markets. | $0.02 |
| earnings-calendar | Finds a company's next earnings date and its recent earnings-related SEC filings. | $0.03 |
| earnings-calendar-api | Finds company earnings dates from SEC filings: 8-K Item 2.02, 10-Q, 10-K, NT filing signals, fiscal periods, and next-earnings cadence es… | $0.03 |
| earnings-call-transcribe | Earnings call transcriber. | $0.03 |
| earnings-transcript | Earnings call transcript generator. | $0.03 |
| fda-calendar | Tracks upcoming FDA Advisory Committee (AdComm) meetings, a catalyst calendar for biotech. | $0.03 |
| fda-calendar-api | Tracks FDA advisory committee meetings, monitoring upcoming and recent AdComm notices, docket ids, committee names, and meeting dates. | $0.03 |
SEE ALSO