{"uid":"cap_t_pT8HWCMKGomyTu2Rslb","slug":"datanexusai-trade-balance-api-7000cb0d","name":"DataNexusAI Trade Balance API","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/balance?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":["country","commodity"],"properties":{"country":{"type":"string","example":"BG","description":"Reporter (or reporter=)."},"date_to":{"type":"string","description":"End period."},"partner":{"type":"string","description":"Partner (default WORLD)."},"commodity":{"type":"string","example":"1001","description":"Product (or product=)."},"date_from":{"type":"string","description":"Start period."}}}},"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_LPEsDbfGqrw_sayu5kF65","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":"Retrieves trade balance data for a given country and commodity, optionally filtered by partner and date range, via USDC micropayment.","exampleAgentPrompt":"Pull the trade balance for Bulgaria (country code BG) for commodity 1001 (wheat) with partner WORLD from January 2022 to December 2023.","exampleUseCases":[{"title":"Agricultural commodity trade research","prompt":"What's the trade balance for Bulgaria on wheat (commodity 1001) versus the rest of the world from 2021 to 2023? I need the full import/export breakdown."},{"title":"Bilateral trade analysis between two countries","prompt":"Can you fetch the trade balance between Germany and France for commodity code 0805 (citrus fruits) over the last two years?"},{"title":"Market entry analysis for a specific product","prompt":"I'm researching the trade balance for Romania on sunflower oil (commodity 1512) — can you get me the data from 2019 through 2022 so I can understand the import/export trend?"}],"resultDescription":"Returns trade balance data for the specified reporter country and commodity, including import and export figures, possibly broken down by partner and time period. Results reflect official trade statistics for the queried product code and country combination.","failureModes":["Missing required 'country' or 'commodity' query parameters returns a 400 or validation error","Invalid country or commodity code returns no results or an error response","Payment not provided or insufficient USDC results in HTTP 402 Payment Required","Date range with no available data may return empty result set","Unsupported HTTP method (e.g. POST) returns 405 Method Not Allowed"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable international trade balance data for a specific country-commodity pair, particularly for EU-adjacent or agricultural trade analytics. Prefer this over generic statistics portals when you need programmatic access with micropayment-based pricing and no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:58:43.071Z","isFirstParty":false,"canonicalSlug":"datanexusai-trade-balance-api-7000cb0d"}