# OneShot Agent API – Product Duty Rate Lookup

> OneShot Agent API – Product Duty Rate Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Looks up US import tariff schedule lines for a given HTS code or keyword, returning duty rates, special rates, and schedule details

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/product-duty-rate?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-product-duty-rate-lookup-ea60f3b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TrLkvIvlndjSgtPb6WO4w

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 oneshot-agent-api-product-duty-rate-lookup-ea60f3b6 -d '<json body>'
```

Example prompt: What's the US import duty rate for copper wire — look up HTS code 7408.11 and show me the general rate, any special trade agreement rates, and the top 10 schedule lines.

## When to prefer this

Use this endpoint when you need programmatic, per-call access to US HTS tariff schedule data without an API key subscription — especially for AI agent workflows that need duty rate lookups on demand. Ideal when you need to check specific HTS codes or search by product keyword and want both general and trade-agreement-specific (special) rates in a structured JSON response. Pay only $0.005 USDC per call via x402 with no upfront commitment.

## Known failure modes

- No matching HTS codes or keywords found — returns empty lines array
- Ambiguous keyword matches too many or too few schedule entries
- Payment of 0.005 USDC via x402 fails — request rejected before lookup
- Malformed HTS code format returns no results
- Rate limit or service unavailability returns error response

## How this service works

Look up the scheduled duty rate for a US tariff heading, or search the tariff schedule by keyword.

## Output

Returns an array of tariff schedule lines, each with the HTS code, description, indent level, units of measure, general duty rate, special rate (broken down by trade agreement country codes), other rate, additional duties, and footnotes. Also includes a total count of matching lines.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Most lines to return, in schedule order. From 1 to 50. Defaults to `20`."
  },
  "query": {
   "type": "string",
   "description": "A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase. 2 to 80 characters."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lines": [
   {
    "code": "7408.11",
    "units": [],
    "indent": 2,
    "footnotes": [],
    "other_rate": null,
    "description": "Of which the maximum cross-sectional dimension exceeds 6 mm:",
    "general_rate": null,
    "special_rate": null,
    "additional_duties": null
   },
   {
    "code": "7408.11.30.00",
    "units": [
     "kg"
    ],
    "indent": 3,
    "footnotes": [],
    "other_rate": "7%",
    "description": "With a maximum cross-sectional dimension over 9.5 mm",
    "general_rate": "1%",
    "special_rate": "Free (A,AU,BH,CL,CO,D,E,IL,JO,KR,MA,OM,P,PA,PE,S,SG)",
    "additional_duties": null
   }
  ],
  "total": 3
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-product-duty-rate-lookup-ea60f3b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)