{"uid":"cap_eTEORQNXfUz376D50j93D","slug":"datanexusai-trade-partners-lookup-1467bb1a","name":"DataNexusAI Trade Partners Lookup","description":"Public data API for SEBRA payments, PTP road accidents, Hearthstone cards, EU agri-food prices, and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). Docs and discovery endpoints are free.\n\nMachine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.\n\nHuman docs: `/docs` and `/api/`.","url":"https://api.datanexusai.org/api/v1/trade/partners?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["reporter","product"],"properties":{"flow":{"type":"string","description":"import|export|both (default both)."},"sort":{"type":"string","description":"value|quantity|share."},"limit":{"type":"integer","example":20},"period":{"type":"string","example":"2025","description":"Period filter."},"date_to":{"type":"string","description":"End."},"product":{"type":"string","example":"1001","description":"Product code."},"reporter":{"type":"string","example":"BG","description":"Reporter country."},"date_from":{"type":"string","description":"Start."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_giGl3vka8Y0lg3CiaRWa8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns trade partner data (import/export flows, values, quantities, and shares) for a given reporter country and product code, optionally filtered by period and flow direction.","exampleAgentPrompt":"Show me the top 20 trade partners for Bulgaria (BG) importing product code 1001 in 2025, sorted by value — I want to see both imports and exports.","exampleUseCases":[{"title":"Agricultural import sourcing research","prompt":"Which countries does Bulgaria import wheat (product code 1001) from in 2025? Show me the top 10 partners sorted by trade value, imports only."},{"title":"Export market share analysis","prompt":"Give me Bulgaria's export partners for product 1001 in 2024, sorted by market share, and limit it to the top 20 destinations."},{"title":"Bilateral trade trend monitoring","prompt":"Pull the trade partner data for reporter country BG and product code 1001 from January 2023 to December 2024, showing both imports and exports sorted by quantity."}],"resultDescription":"Returns a list of trade partner countries with associated trade metrics including flow direction (import/export), trade value, quantity, and market share for the specified reporter country and product code, filtered by any provided period or date range.","failureModes":["Missing required 'reporter' or 'product' query parameters returns a 400 error","Invalid country code or product code returns empty results or a 404","Payment not provided or insufficient USDC balance triggers an x402 payment-required response","Invalid flow value (not import/export/both) may return an error or default to 'both'","Date range with no available data returns an empty result set","Unsupported sort field returns an error or defaults to a fallback ordering"],"whenToPreferThis":"Use this endpoint when you need structured bilateral trade flow data for a specific reporter country and product code, especially when filtering by period, flow direction, or ranking partners by value, quantity, or share. Prefer this over general web search when you need machine-readable, analytics-ready trade partner data payable via USDC micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:57:55.115Z","isFirstParty":false,"canonicalSlug":"datanexusai-trade-partners-lookup-1467bb1a"}