{"uid":"cap_V7KKu28obNh7reQnrN4i9","slug":"citiview-us-trade-data-api-af4fe528","name":"Citiview US Trade Data API","description":"US imports and exports from official Census trade data: by product (HS code) the top partner countries with value, share and year-to-date; by country the trade balance and top products; or US totals, for the latest month or any month.","url":"https://agents.citiviewgroup.com/v1/trade?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","properties":{"hs":{"type":"string","description":"2, 4 or 6-digit HS code, e.g. 8703 cars"},"flow":{"type":"string","description":"imports (default) or exports"},"limit":{"type":"integer"},"month":{"type":"string","description":"YYYY-MM, default latest"},"country":{"type":"string","description":"Partner country name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DDKMamB574iCvIH6zg_0Y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","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 statistics from official Census data, including top partner countries by HS product code, trade balance by country, and US totals for any month.","exampleAgentPrompt":"What are the top countries the US imported cars from last month — give me the values and each country's share of total US car imports, using HS code 8703?","exampleUseCases":[{"title":"Top import sources for a product","prompt":"Show me the top 10 countries the US imported solar panels from in 2024-09, with their trade values and percentage share — the HS code for solar panels is 8541."},{"title":"US trade balance with a specific country","prompt":"What is the US trade balance with Vietnam — how much do we import versus export, and what are the top product categories traded with them?"},{"title":"National export totals for a given month","prompt":"What were the total US exports for January 2024, and which countries received the most?"}],"resultDescription":"Returns structured trade data including partner country names, trade flow direction (imports/exports), USD values, percentage shares of total trade, year-to-date figures, top HS product codes, and trade balance figures — scoped to the queried product, country, or US totals for the specified or latest available month.","failureModes":["Invalid or unsupported HS code returns empty or error response","Requested month data not yet published by Census returns null or latest available","Unrecognized country name may return no results — use standard English country names","Missing required 'type' or 'method' fields in input object causes validation error","Limit parameter set too high may result in truncated or slow response"],"whenToPreferThis":"Use this endpoint when you need authoritative US import/export statistics sourced from official US Census Bureau trade data, especially when querying by specific HS product codes, bilateral country trade balances, or national monthly totals. Prefer this over general web search or LLM knowledge for precise, up-to-date trade values and partner country rankings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:46:57.472Z","isFirstParty":false,"canonicalSlug":"citiview-us-trade-data-api-af4fe528"}