# TariffWatch HTS Duty Rate Lookup

> TariffWatch HTS Duty Rate Lookup is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the base MFN duty rate and an estimated combined effective tariff rate (including Section 301/232/IEEPA add-ons) for a given HTS tariff line code

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/tariffwatch/status
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tariffwatch-hts-duty-rate-lookup-c1a276ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__WQESvXdyZehaqZk5ucQ9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tariffwatch-hts-duty-rate-lookup-c1a276ce
```

Example prompt: What is the current base MFN duty rate and estimated combined effective tariff rate — including any Section 301, 232, or IEEPA add-ons — for HTS code 6109.10.00?

## When to prefer this

Use this endpoint when you need the current US import duty rate — both the base MFN rate and the estimated total effective rate including Section 301 (China), Section 232 (steel/aluminum), and IEEPA add-ons — for a specific HTS tariff line. Prefer this over general trade databases when you need a combined effective rate estimate in a single API call. Best suited for compliance tools, import cost calculators, product pricing models, and trade intelligence applications that need current US tariff data per HTS code.

## Known failure modes

- Invalid or unrecognized HTS code returns an error or empty result
- HTS code not tracked by the service returns no entity data
- Omitting the id parameter returns a list of tracked entities rather than a specific rate
- Network or payment failure (x402) prevents the call from completing
- Recently enacted tariff changes may not yet be reflected in the combined estimate

## How this service works

Current US import duty rate for any HTS code (entityId like 'hts:6109.10.00'): the base (MFN) rate AND an estimated combined effective rate including Chapter-99 Section 301/232/IEEPA add-ons — the landed-duty answer a supply-chain agent needs. The combined figure is a labeled estimate and excludes product/country exclusions. Or 'hts:release' for the current HTS revision.

## Output

Returns a JSON object containing the HTS entity details including the base MFN duty rate, a labeled estimate of the combined effective rate (base plus applicable Chapter-99 Section 301, Section 232, and IEEPA surcharges), and the HTS line metadata. Note: the combined figure is an estimate and excludes product- or country-specific exclusions. When queried for 'hts:release', returns the current HTS revision information.

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "id": {
       "type": "string",
       "description": "entityId to look up; omit to list tracked entities"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "entity": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "entity": {
   "state": {
    "baseRate": "16.5%",
    "sectoralPrograms": [
     {
      "code": "9903.88.15",
      "additional": 7.5
     }
    ],
    "effectiveRateEstimate": "24%"
   },
   "entityId": "hts:6109.10.00"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tariffwatch-hts-duty-rate-lookup-c1a276ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)