Explorer
Syncing—

Trade and Tariff DataService

trade-tariff-data

US import duty rates from the official Harmonized Tariff Schedule (US International Trade Commission). POST JSON {"hs_code": "8507.60"} (4 to 10 digits) to /v1/trade for every line under that code, or {"query": "lithium batteries"} for a keyword search; optional limit. Each line has hts_code, description, full_description (the heading path), general_rate (column 1), special_rate (preferential programs), column2_rate and units; statistical lines inherit rates from their 8-digit line (rates_from). Additional duties such as Section 301/232 and chapter 99 provisions are not applied. Live data.

Active Suppliers
1
of 1 ever configured
Service Info
Service ID
trade-tariff-data
Compute Units / Relay
100,000
Active Applications
1
Relay Mining EMA
1 relays
Service Metadata Cardsource: on-chain metadata (LCD)
{10 items
"schema":"pocket-service-card/v1"
"description":"US import duty rates from the official Harmonized Tariff Schedule (US International Trade Commission). POST JSON {"hs_code": "8507.60"} (4 to 10 digits) to /v1/..."
"rpc_types":[1 item
0:{4 items
"type":"REST"
"intent":"expected"
"backend_hint":"trade-tariff-data HTTP server on :8080; POST /v1/trade (POST / also reaches it through the relay), GET /v1/health + /v1/version."
"notes":"Every response is a JSON object; errors are JSON 4xx with an error field."
}
]
"apis":[1 item
0:"tariff-api"
]
"specs":[1 item
0:{4 items
"kind":"openapi"
"api":"tariff-api"
"url":"https://services.supnodes.com/specs/trade-tariff-data/openapi.json"
"notes":"Machine-readable OpenAPI 3.0.3 contract for this service, with example requests."
}
]
"access":"public"
"results":"variable"
"serving":{7 items
"backend":"Single-process Python 3 HTTP server, standard library only, behind a RelayMiner (rest backend). No auth toward the backend; callers cannot send headers. Calls t..."
"implementations":[1 item
0:"trade-tariff-data >= 1.0"
]
"docs":"https://services.supnodes.com/specs/trade-tariff-data/README.md"
"min_disk_gb":1
"min_ram_gb":1
"healthcheck":[3 items
0:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/version"
"method":"GET"
}
"expect":{2 items
"json_path":"$.service"
"matches":"^trade-tariff-data$"
}
"notes":"Identity probe: pins the backend to this service so a wrong backend cannot be staked under this id."
}
1:{4 items
"rpc_type":"REST"
"request":{2 items
"path":"/v1/health"
"method":"GET"
}
"expect":{2 items
"json_path":"$.status"
"matches":"^ok$"
}
"notes":"Readiness probe."
}
2:{4 items
"rpc_type":"REST"
"request":{3 items
"path":"/v1/trade"
"method":"POST"
"body":{1 item
"hs_code":"0101.21"
}
}
"expect":{2 items
"json_path":"$.lines[0].general_rate"
"matches":"^Free$"
}
"notes":"Functional probe: purebred breeding horses (duty free); one upstream call."
}
]
"notes":"Upstream is a public government API that may rate-limit. Gateway operators: configure as type passthrough with rpc_types ["rest"]."
}
"docs":"https://services.supnodes.com/specs/trade-tariff-data/README.md"
"updated":"2026-09-27"
}