{"uid":"cap_Yxufh8cCdk6DlmdSEAU_r","slug":"comtrade-annual-imports-total-31f1623d","name":"Comtrade Annual Imports Total","description":"Total annual merchandise imports (all commodities, all partners) for a reporter country in 2023; q = numeric reporter code (e.g. 842=USA, 156=China, 392=Japan). Query: ?q= Returns JSON.","url":"https://clonecho.builda.company/x402/s/comtrade-annual-imports-total","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HFIrPBp91hoByBxipTWIs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the total annual merchandise import value (all commodities, all partners) for a given reporter country in 2023, identified by numeric UN Comtrade country code.","exampleAgentPrompt":"What were the total merchandise imports for the USA in 2023? Use the Comtrade annual imports endpoint with country code 842.","exampleUseCases":null,"resultDescription":"A JSON object containing the total annual merchandise import value (all commodities, all partner countries) for the requested reporter country in 2023, keyed by the numeric UN Comtrade country code provided.","failureModes":["Invalid or unrecognized numeric country code returns an error or empty result","Country code not found in Comtrade 2023 dataset returns null or empty data","Missing q parameter causes a bad request error","Non-numeric value for q parameter causes a parse or validation error","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need a single aggregated total of all merchandise imports for a specific country in 2023, across all commodities and all trade partners, identified by the UN Comtrade numeric reporter code. Prefer this over more granular trade endpoints when you only need the top-line import figure rather than commodity- or partner-level breakdowns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:05:28.706Z","isFirstParty":false}