{"uid":"cap_JwIUyRN7QX1SKewt5Rcn_","slug":"us-trade-flow-statistics-by-hs-code-aaa23e94","name":"US Trade Flow Statistics by HS Code","description":"X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.","url":"https://x402helper.xyz/89e509/trade/flow?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","required":["hs6"],"properties":{"hs6":{"type":"string","default":null,"description":"HS or HTS code, 2 to 10 digits, dots optional"},"year":{"type":"integer","default":null,"description":"Calendar year, defaults to recent"},"partner":{"type":"string","default":null,"description":"Optional Census partner country code to filter by"},"direction":{"enum":["imports","exports"],"type":"string","default":null}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0195","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0195/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0195","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0195","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hRP38hPfl8DAOFHX4pp_V","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0195","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns US import/export trade flow statistics for a given HS/HTS tariff code, optionally filtered by year, partner country, and direction.","exampleAgentPrompt":"Can you pull US import statistics for HS code 8471.30 for 2023, filtered to imports from China?","exampleUseCases":[{"title":"Tariff research for product sourcing","prompt":"I need to know how much of HS code 6203.42 — men's cotton trousers — the US imported in 2022, and which countries it came from. Can you look that up?"},{"title":"Export market analysis for a commodity","prompt":"Pull US export data for HTS code 1001.99 — wheat — for 2023 so I can see total export volumes."},{"title":"Bilateral trade monitoring for compliance","prompt":"What were total US imports from Mexico for HS code 8708.29 in 2022? I want to check our supplier country's trade volume."}],"resultDescription":"A JSON object with a 'success' boolean and a 'result' object containing trade flow statistics such as import or export volumes, values, and partner breakdowns for the specified HS/HTS code, year, and direction.","failureModes":["Invalid or malformed HS code returns an error or empty result","Unsupported year range may return null or no data","Unknown partner country code may be ignored or cause an error","Missing required 'hs6' parameter returns a validation error","Payment failure via x402 protocol blocks the request entirely"],"whenToPreferThis":"Use this endpoint when you need structured US trade flow data (imports or exports) for a specific HS or HTS tariff code, optionally narrowed by year and partner country. It is suitable for trade research, compliance checks, sourcing analysis, and market intelligence tasks where Census-level commodity trade statistics are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:19.899Z","isFirstParty":false,"canonicalSlug":"us-trade-flow-statistics-by-hs-code-aaa23e94"}