Trade and Tariff Data

government

Serving

HTS tariff classification and duty rates for supply-chain and customs agents. POST /v1/trade with an {hs_code} and get the classification and duty references as one JSON object. Deterministic per tariff schedule. Pay per request in USDC; no account, no API key.

Endpoint: POST https://agent.pocket.network/v1/trade-tariff-data/v1/trade
Price per call: $0.005 USD
Networks payable on: Base (eip155:8453), Tempo (eip155:4217)
Protocol: rest

Calling it

The first call returns 402 Payment Required with the terms. Sign for those terms and retry the same request with the payment attached.

Example request

A real, working call — the request the service card verifies against.

curl -X POST https://agent.pocket.network/v1/trade-tariff-data/v1/trade \
  -H 'content-type: application/json' \
  -d '{"hs_code":"0101.21"}'

Example response

The response this call returned, captured 2026-09-21 23:49:45 UTC.

{
  "portal": {
    "provenance": "third-party-supplier",
    "serviceId": "trade-tariff-data",
    "schemaCheck": "unchecked"
  },
  "data": {
    "hs_code": "0101.21",
    "references": [
      {
        "package_id": "USCOURTS-nynd-1_25-cv-00168",
        "title": "State of West Virginia et al v. James et al",
        "date_issued": "2026-08-31"
      },
      {
        "package_id": "SERIALSET-09755_00_00-002-0102-0000",
        "title": "White River, Missouri and Arkansas. Letter from the Secretary of War, transmitting ... a letter from the Chief of Engineers, United States Army, dated March 30, 1932, submitting a report, together with accompanying papers and illustrations, containing a general plan for the improvement of White River, Mo. and Ark ... March 30, 1932. -- Referred to the Committee on Rivers and Harbors. June 10, 1933. -- Ordered to be printed with illustrations;U.S. Congressional Serial Set No. 9755 - House Documents, Vol. 7",
        "date_issued": "1933-06-10"
      },
      {
        "package_id": "SERIALSET-08602_00_00-002-0321-0000",
        "title": "Publications of the United States Naval Observatory. Second Series. Volume XI;U.S. Congressional Serial Set No. 8602 - House Documents, Vol. 41",
        "date_issued": "1926-01-01"
      }
    ],
    "count": 3,
    "coverage_note": "v1 = govinfo references mentioning the HS code. Full HTS rate table lookup requires USITC's API (SPA-gated, verified live 2026-09-16) - adapter pending. No fabricated rates.",
    "as_of": "2026-09-21",
    "source": "api.govinfo.gov (public domain)"
  }
}

Try it

Make one real paid call from your own wallet — about $0.005 on Base (eip155:8453). The wallet signs; nothing here holds a key. You'll see exactly what the service answers.

No browser wallet found. Install MetaMask, Rabby, or Coinbase Wallet to try a call here.

EndpointRequest body

Supported methods

Methods the registry lists for this service. The portal forwards any call as sent; the supplier decides what it answers, and a delivered answer is settled.

Methods Trade and Tariff Data accepts, and whether each reads or writes.
Method	Effect
`GET /v1/health`	read
`GET /v1/version`	read
`POST /v1/trade`	read

Schemas

Published by the service itself. The example above is generated from these.

Request schema

{
  "type": "object",
  "description": "A tariff line to classify.",
  "properties": {
    "hs_code": {
      "type": "string",
      "description": "HTS/HS code, e.g. 0101.21."
    }
  },
  "required": [
    "hs_code"
  ]
}

Response schema

{
  "type": "object",
  "description": "For POST /v1/trade, a JSON object with the classification and a `references` array of duty data. The exact shape is the service's own and is not pinned here; errors return a JSON object with an `error` field, and the GET routes return their own small JSON documents."
}