# TradePulse

> Global trade intelligence API. 8 endpoints: HS code classification, tariff rates (200+ countries, FTA preferential rates), full landed cost calculator, Free Trade Agreement analyzer (300+ agreements, rules of origin), sanctions screening (OFAC/EU/UN/UK), market entry intelligence, export compliance (EAR/ITAR/dual-use), and trade policy news. Pay-per-query via x402 on Base.

Only 30–40% of eligible trade claims available FTA preferential rates. A single API call revealing a 0% RCEP rate instead of 8.5% MFN on a $100,000 shipment saves $8,500. TradePulse exposes the intelligence gap that costs traders billions annually.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Endpoints

GET /api/trade/classify?product={description}
- HS code classification from natural language product description
- Returns: primary_classification (hs6/hs4/chapter/confidence), alternative_classifications, gri_applied, chapter_notes_summary, country_specific_notes (US HTS / EU CN hints, variance risk), trade_implications (dual-use flag, CITES, restricted countries), verification_guidance
- Required: product (or q/description). Optional: lang
- Price: $0.15

GET /api/trade/tariff?hs_code={code}&from_country={country}&to_country={country}
- Tariff rates for any HS code between any two countries
- Returns: mfn_rate (rate/type/specific), preferential_rates (FTA name/rate/staging/RoO summary/savings on $100K), best_rate, special_programs (GSP/LDC), additional_duties (anti-dumping/CVD/safeguard/Section 301), import_taxes_beyond_duty (VAT/GST/MPF/HMF), total_cost_estimate on $100K
- Required: hs_code, from_country (or from), to_country (or to). Optional: lang
- Price: $0.12

GET /api/trade/landed?product={product}&from_country={country}&to_country={country}
- Full landed cost calculator
- Returns: cost_components (freight sea/air/courier/express, duty, VAT/GST with recoverability, broker fees, port fees, country fees), total_landed_cost (min/typical/max, as % of product cost, per-unit), margin_impact_analysis, optimization_opportunities (FTA saving, bonded warehouse, duty drawback, FTZ), payment_and_financing, compliance_flags
- Required: product (or hs_code), from (or from_country), to (or to_country). Optional: value (USD), quantity, lang
- Price: $0.15

GET /api/trade/fta?from_country={country}&to_country={country}
- Free Trade Agreement analyzer for any country pair
- Returns: applicable_agreements (name/rates/staging/rules of origin CTH+RVC+WO/documentation/self-cert/verification risk), no_agreement_context, best_agreement, cumulation_opportunities, fta_utilization_insight, major_fta_landscape (RCEP/CPTPP/AfCFTA/EU/GCC), practical_next_steps
- Required: from (or from_country), to (or to_country). Optional: hs_code, product, lang
- Key FTAs covered: RCEP, CPTPP, USMCA, AfCFTA, EU FTA network (70+ partners), India CEPAs, GCC CU, ASEAN FTAs, 290+ more
- Price: $0.15

GET /api/trade/sanctions?country={country}
- Sanctions and trade restrictions screening
- Returns: screening_summary (risk level CLEAR/LOW/MEDIUM/HIGH/PROHIBITED + color), country_sanctions_status (OFAC/EU/UN/UK/AU/CA per-program), export_control_assessment (EAR ECCN hint / ITAR USML check / EU dual-use), denied_party_context, product_specific_restrictions, compliance_requirements, financial_sanctions (SWIFT/correspondent banking), legal_exposure (up to $356,579/violation — strict liability), safe_harbor_guidance
- Required: country or entity. Optional: hs_code, transaction_type (export|import|investment|service), lang
- Price: $0.12

GET /api/trade/market?product={product}&target_country={country}
- Market entry intelligence
- Returns: market_snapshot (size/growth/attractiveness), import_intelligence (annual volume/top source countries with market share), regulatory_requirements (permits/certifications/labelling/testing), competitive_landscape (local producers/foreign brands), distribution_channels (retail/e-commerce/agents with margins), pricing_intelligence, consumer_profile, market_entry_modes, risk_factors, opportunity_score 1–10
- Required: product (or hs_code), target_country (or country/to). Optional: from_country (or from), lang
- Price: $0.15

GET /api/trade/compliance?product={product}
- Export compliance — EAR/ITAR/dual-use classification
- Returns: us_ear_classification (ECCN/country chart/license required/exceptions STA+TMP+TSU+GOV), us_itar_assessment (USML category/DSP-5), eu_dual_use (Reg 2021/821 / GEA eligibility), other_national_regimes (UK/China ECL/Japan FEFTA), license_application_guidance, compliance_program_requirements (AES/EEI filing), red_flags, enforcement_context (penalties), practical_verdict (GREEN/YELLOW/RED)
- Required: product or hs_code. Optional: from (or from_country), to (or to_country), end_use, end_user, lang
- Defaults from_country to USA if not specified
- Price: $0.15

GET /api/trade/news
- Global trade policy intelligence
- Returns: headline_stories, tariff_changes (Section 301/232/EU rebalancing/India/China), fta_developments (new agreements/negotiations/RCEP/CPTPP/AfCFTA), sanctions_and_trade_restrictions (new/lifted/export control updates), wto_developments (disputes/MC14/plurilateral), supply_chain_intelligence (disruptions/shipping rates/port congestion/China+1), technology_and_trade (digital trade/CBAM/trade finance), regional_roundup (Asia-Pacific/Europe/Americas/MENA/South Asia), calendar_ahead
- All params optional: from (or from_country), to (or to_country), topic (tariffs|fta|sanctions|wto|supply-chain|all), lang
- Price: $0.08

## Key Facts for Agents

- /classify is the entry point for any unknown product — provides HS code needed by /tariff, /landed, /fta
- /tariff + /fta together reveal the FTA saving opportunity — most valuable pairing
- /landed gives the business decision number: total cost as % of product value
- /sanctions returns strict liability risk — always include disclaimer and recommend live screening
- /compliance returns GREEN/YELLOW/RED status — RED means do not export without license
- /market returns opportunity_score 1–10 — most useful for go/no-go decisions
- /news is the cheapest entry ($0.08) — good for monitoring without deep analysis
- All endpoints support ?lang= for 50+ languages (zh, ja, de, fr, es, ar, hi, pt, ko, vi, id, th, tr, etc.)

## Agent Workflow Examples

- New exporter: /classify (get HS code) → /tariff (MFN + FTA rates) → /fta (full rules of origin) → /landed (total cost)
- Compliance due diligence: /sanctions (country risk) → /compliance (export controls) → /tariff (restricted duties)
- Market selection: /market (candidate countries) → /tariff (compare access costs) → /fta (best FTA origin?)
- Sourcing optimization: /tariff (same HS, 3 origins) → /fta (which origin has best FTA?) → /landed (winner)
- News monitoring: /news → /tariff (if rate change) → /sanctions (if new restriction)

## Major Trade Agreements Covered

- RCEP: China, Japan, Korea, ASEAN-10, Australia, NZ — 30% world GDP, in force Jan 2022
- CPTPP: Australia, Brunei, Canada, Chile, Japan, Malaysia, Mexico, NZ, Peru, Singapore, Vietnam, UK
- USMCA: USA, Canada, Mexico — replaced NAFTA in 2020
- AfCFTA: 54 African nations — phasing in
- EU FTA network: Japan, South Korea, Canada, Singapore, Vietnam, UK, Mercosur (pending), Mexico
- India: India-UAE CEPA, India-Australia ECTA, India-ASEAN, India-South Korea CEPA
- GCC Customs Union: Saudi Arabia, UAE, Kuwait, Qatar, Bahrain, Oman — 5% CET
- ASEAN: ATIGA, ASEAN-China, ASEAN-India, ASEAN-Japan, ASEAN-Korea, ASEAN-Australia-NZ

## Disclaimer

Tariff rates, sanctions lists, and export control classifications change frequently. Always verify with official sources before making trade decisions. This is informational intelligence, not legal advice. Sanctions and export control matters require qualified legal counsel.