የEthioTrade API

ለኢትዮጵያ የምንዛሬ ተመኖች ነፃ፣ የንባብ-ብቻ JSON እና CSV። በድረ-ገጹ ላይ ያሉት ተመሳሳይ ቁጥሮች፣ ከተመሳሳይ የገበያ ቀናት እና የጥራት ምልክቶች ጋር።

የAPI ቁልፍ ያግኙ

መሠረታዊ አድራሻethiotrade.org/api/v1

ማረጋገጫነፃ ቁልፍ፣ x-api-key header

የጥያቄ ገደብበቁልፍ 600/ደቂቃ

CORS እና ካሽክፍት CORS · እንደ መዳረሻው 5–15 ደቂቃ

GET

/remittance

JSONካሽ፦ 5–15 ደቂቃ

ወቅታዊ ተመን ባላቸው ተቋማት ሁሉ ለአንድ መጠን የሚቀበሉት ወይም የሚከፍሉት ብር፣ ምርጡ መጀመሪያ።

መለኪያዎች: /api/v1/remittance
መለኪያ	ግዴታ	የሚፈቀዱ ዋጋዎች	ነባሪ
amount	አዎ	a number greater than 0, up to 1,000,000,000	–
currency	አይ	USD, EUR, GBP, SAR, AED, CHF, CAD, CNY, JPY, SEK, NOK, DKK, AUD, KWD, QAR, INR, ZAR, KES, DJF	USD
direction	አይ	buy, sell	buy

curl -H "x-api-key: $ETHIOTRADE_API_KEY" \
  "https://ethiotrade.org/api/v1/remittance?currency=GBP&amount=500&direction=buy"

ምላሽ · 200

የቀጥታ ናሙና በመጫን ላይ…

ስህተቶች

400 የተሳሳተ መለኪያ · 401 የጎደለ ወይም ልክ ያልሆነ ቁልፍ · 404 ያልታወቀ slug · 429 ቀስ ይበሉ (Retry-After header) · 503 መረጃ ለጊዜው አይገኝም። ስህተቶች ሁልጊዜ መልዕክት ይመልሳሉ።

ምንጭ መጥቀስ

መረጃው በሚታይበት ቦታ ሁሉ “Rates: EthioTrade.org”ን ከአገናኝ ጋር ያሳዩ። የገበያ ቀኑ እንዲታይ ያድርጉ።

ድጋፍ

ስለ API ወይም ከፍ ያሉ ገደቦች ጥያቄዎች፦ [email protected]

ዝርዝሮች

ማረጋገጫ: እያንዳንዱ ጥያቄ በx-api-key ራስጌ ነፃ የAPI ቁልፍ ያስፈልገዋል። በኢሜልዎ ገብተው በዳሽቦርድዎ ቁልፎችን ይፍጠሩ። ትክክለኛ ቁልፍ የሌላቸው ጥያቄዎች 401 ያገኛሉ።
የጥያቄ ገደቦች: በአንድ የAPI ቁልፍ በደቂቃ 600 ጥያቄዎች። ገደቡን ሲያልፉ 429 ከRetry-After ራስጌ ጋር ይመለሳል። ገደቦቹ በእያንዳንዱ የአገልጋይ ቅጂ የሚቆጠሩ ግምታዊ ናቸው።
መሸጎጫ: የጥቁር ገበያ መረጃ፦ max-age 60 ሰከንድ፣ የጋራ መሸጎጫ 300 ሰከንድ። ሌላው ሁሉ፦ max-age 300 ሰከንድ፣ የጋራ መሸጎጫ 900 ሰከንድ። ምላሾች X-Robots-Tag: noindex ይይዛሉ።
CORS: እያንዳንዱ ምላሽ Access-Control-Allow-Origin: * ይልካል። በአሳሽ ኮድ ውስጥ ያለ ቁልፍ ለጎብኚዎችዎ ይታያል፤ ስለዚህ በተቻለ መጠን API ን ከአገልጋይዎ ይጥሩ።
የተለመዱ ዋጋዎች: currency፦ እንደ USD፣ EUR፣ GBP፣ SAR፣ AED ያለ የISO ኮድ (ፊደል መጠን አይለይም)። direction፦ buy (ተቋሙ ለውጭ ምንዛሬዎ የሚከፍለው) ወይም sell (የሚያስከፍልዎት)። period፦ 7d፣ 1m፣ 3m፣ 1y ወይም all።
ከውጭ የገባ ታሪክ: ቀጥታ ስብሰባ ከመጀመሩ በፊት የገቡ መረጃዎችን የሚያካትቱ የታሪክ ነጥቦች "imported": true ይይዛሉ።

የሚካተት መግብር

የዛሬ ተመኖችን በአንድ መስመር በድረ-ገጽዎ ላይ። ቁልፍ አያስፈልግም።

ገንዘብ

አቅጣጫ

USD መሸጥUSD መግዛት

ገጽታ

ብርሃንጨለማራስ-ሰር

ቋንቋ

Englishአማርኛ

<iframe
  src="https://ethiotrade.org/embed/rate?currency=USD&direction=buy&theme=light&lang=am"
  title="USD/ETB rates from EthioTrade.org"
  width="360" height="240" loading="lazy"
  style="border:0;border-radius:12px;max-width:100%"
></iframe>

ማንኛውም የሚደገፍ የገንዘብ ኮድ። የጥቁር ገበያ ተመን የሚታየው ለUSD ብቻ ነው። /embed/rate

መለኪያ

ግዴታ

የሚፈቀዱ ዋጋዎች

ነባሪ

amount

አዎ

a number greater than 0, up to 1,000,000,000

–

currency

አይ

USD, EUR, GBP, SAR, AED, CHF, CAD, CNY, JPY, SEK, NOK, DKK, AUD, KWD, QAR, INR, ZAR, KES, DJF

USD

direction

አይ

buy, sell

buy

ዝርዝሮች

ማረጋገጫ

እያንዳንዱ ጥያቄ በx-api-key ራስጌ ነፃ የAPI ቁልፍ ያስፈልገዋል። በኢሜልዎ ገብተው በዳሽቦርድዎ ቁልፎችን ይፍጠሩ። ትክክለኛ ቁልፍ የሌላቸው ጥያቄዎች 401 ያገኛሉ።

የጥያቄ ገደቦች

በአንድ የAPI ቁልፍ በደቂቃ 600 ጥያቄዎች። ገደቡን ሲያልፉ 429 ከRetry-After ራስጌ ጋር ይመለሳል። ገደቦቹ በእያንዳንዱ የአገልጋይ ቅጂ የሚቆጠሩ ግምታዊ ናቸው።

መሸጎጫ

የጥቁር ገበያ መረጃ፦ max-age 60 ሰከንድ፣ የጋራ መሸጎጫ 300 ሰከንድ። ሌላው ሁሉ፦ max-age 300 ሰከንድ፣ የጋራ መሸጎጫ 900 ሰከንድ። ምላሾች X-Robots-Tag: noindex ይይዛሉ።

CORS

እያንዳንዱ ምላሽ Access-Control-Allow-Origin: * ይልካል። በአሳሽ ኮድ ውስጥ ያለ ቁልፍ ለጎብኚዎችዎ ይታያል፤ ስለዚህ በተቻለ መጠን API ን ከአገልጋይዎ ይጥሩ።

የተለመዱ ዋጋዎች

currency፦ እንደ USD፣ EUR፣ GBP፣ SAR፣ AED ያለ የISO ኮድ (ፊደል መጠን አይለይም)። direction፦ buy (ተቋሙ ለውጭ ምንዛሬዎ የሚከፍለው) ወይም sell (የሚያስከፍልዎት)። period፦ 7d፣ 1m፣ 3m፣ 1y ወይም all።

ከውጭ የገባ ታሪክ

ቀጥታ ስብሰባ ከመጀመሩ በፊት የገቡ መረጃዎችን የሚያካትቱ የታሪክ ነጥቦች "imported": true ይይዛሉ።

<iframe src="https://ethiotrade.org/embed/rate?currency=USD&direction=buy&theme=light&lang=am" title="USD/ETB rates from EthioTrade.org" width="360" height="240" loading="lazy" style="border:0;border-radius:12px;max-width:100%" ></iframe>