# Agent Data API – US Import Tariff Lookup

> Agent Data API – US Import Tariff Lookup is a paid API for AI agents from x402-agent-api-production.up.railway.app, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-13).

Looks up US import tariff rates (HTS codes, general/special/column 2 duty rates) for a product keyword or HTS code, billed per call in USDC via x402.

## Facts

- Endpoint: GET https://x402-agent-api-production.up.railway.app/tariffs/%7Bquery%7D?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-api-us-import-tariff-lookup-7c312880
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UZaZNjKscJyxPlZ1pqhQg

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 agent-data-api-us-import-tariff-lookup-7c312880
```

Example prompt: What are the US import tariff rates for yoga mats — give me the HTS code, general rate, and any special rates that apply?

## When to prefer this

Use this endpoint when you need programmatic, per-call access to US import tariff data (HTS codes and duty rates) for specific products or codes, especially in agent workflows where you pay only for what you query. Prefer it over static tariff databases when freshness and pay-as-you-go pricing (via x402 USDC micropayments) matter, and when you need structured JSON output for downstream computation.

## Known failure modes

- Unrecognized product keyword returns empty results array
- Invalid or non-existent HTS code returns no matches
- Payment failure (402) if USDC balance is insufficient for x402 micropayment
- Network timeout on the Railway-hosted service
- Limit parameter out of range (must be 1–50) returns a validation error

## How this service works

SEC and supplement safety data, pay per call in USDC via x402.

## Output

Returns an array of matching tariff records, each containing the HTS code, product description, general duty rate, column 2 rate, and special rates (e.g. free under various trade agreements such as AU, CA, etc.).

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "Product keyword or HTS code, e.g. yoga mat or 9506.91"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "9506.91",
  "results": [
   {
    "hts_code": "9506.91.00",
    "description": "Articles and equipment for general physical exercise",
    "column2_rate": "40%",
    "general_rate": "4.6%",
    "special_rates": "Free (A,AU,...)"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-api-us-import-tariff-lookup-7c312880/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-api-production.up.railway.app](https://www.zero.xyz/host/x402-agent-api-production.up.railway.app/llms.txt)
