{"openapi":"3.1.0","info":{"title":"NBU Data API: official Ukrainian rates for AI agents","version":"0.1.0","description":"Official National Bank of Ukraine open data as clean JSON, paid per call in USDC via x402 v2 (Base Sepolia (testnet)). Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU."},"servers":[{"url":"https://nbu-test.navistri.com"}],"externalDocs":{"description":"llms.txt","url":"https://nbu-test.navistri.com/llms.txt"},"paths":{"/v1/rates":{"get":{"operationId":"rates","summary":"Official NBU hryvnia exchange rates on a date","description":"Official National Bank of Ukraine (NBU) exchange rates of the hryvnia (UAH) on a date: 40+ currencies, gold, silver and SDR, with English names. Call it when you need the legally official UAH rate for Ukrainian accounting, tax, invoices or customs, or to convert to/from UAH on a given date. Params: date (YYYY-MM-DD, default today in Kyiv), currency (ISO code, optional; omit for all).","tags":["paid"],"parameters":[{"name":"date","in":"query","required":false,"description":"Date the rate applies to, YYYY-MM-DD, from 1996-09-02 to tomorrow (Kyiv). Default: today.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-09"},{"name":"currency","in":"query","required":false,"description":"ISO 4217 code such as USD, EUR, PLN, XAU. Omit to get every published currency.","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"},"example":"USD"}],"x-x402":{"version":2,"scheme":"exact","price":"$0.001","network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","payTo":"0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef"},"responses":{"200":{"description":"Data. The PAYMENT-RESPONSE header carries the settlement receipt.","headers":{"PAYMENT-RESPONSE":{"description":"base64 JSON settlement receipt (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["date","base","count","rates"],"properties":{"date":{"type":"string","format":"date"},"base":{"const":"UAH"},"count":{"type":"number"},"rates":{"type":"array","items":{"type":"object","required":["currency","rate","units","ratePerUnit"],"properties":{"currency":{"type":"string","description":"ISO 4217 alphabetic code"},"numericCode":{"type":["number","null"]},"name":{"type":["string","null"],"description":"English name"},"nameUk":{"type":["string","null"],"description":"Ukrainian name"},"rate":{"type":"number","description":"UAH per `units` units of the currency"},"units":{"type":"number"},"ratePerUnit":{"type":"number","description":"UAH per 1 unit of the currency"},"setOn":{"type":["string","null"],"description":"Date the NBU set the rate"},"specialConditions":{"type":["boolean","null"],"description":"USD only: rate set under special conditions"}}}}}},"meta":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"object"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"upstreamUrl":{"type":"string"},"terms":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}}}}},"example":{"data":{"date":"2026-10-09","base":"UAH","count":1,"rates":[{"currency":"USD","numericCode":840,"name":"US Dollar","nameUk":"Долар США","rate":44.8526,"units":1,"ratePerUnit":44.8526,"setOn":"2026-10-08","specialConditions":false}]},"meta":{"endpoint":"GET /v1/rates","params":{"date":"2026-10-09","currency":"USD"},"source":"National Bank of Ukraine open data (bank.gov.ua)","sourceUrl":"https://bank.gov.ua/ua/open-data/api-dev","upstreamUrl":"https://bank.gov.ua/...","terms":"Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.","retrievedAt":"2026-10-12T12:00:00.000Z","cached":false}}}}},"400":{"description":"Invalid parameters (free, returned before any payment)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_request","message":"date must be a calendar date in YYYY-MM-DD format","field":"date"}}}},"402":{"description":"Payment required: $0.001 USDC on Base Sepolia (testnet) via x402 v2.","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON payment requirements (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No NBU data for these parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No official NBU rate for XYZ on 2026-10-09."}}}},"502":{"description":"NBU unavailable or returned an invalid response (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"upstream_unavailable","message":"NBU did not answer in time"}}}},"503":{"description":"Payments temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"payments_unavailable","message":"Payment facilitator unreachable, try again shortly."}}}}}}},"/v1/rates/history":{"get":{"operationId":"ratesHistory","summary":"Daily official NBU rate history for one currency","description":"Daily official NBU exchange-rate series of one currency against the hryvnia (UAH) for a period of up to 366 days, plus min, max and % change. Call it to chart or analyse UAH moves, compute averages for Ukrainian reporting, or check a rate across several dates in one paid call. Params: currency (default USD), from and to (YYYY-MM-DD; default the last 31 days).","tags":["paid"],"parameters":[{"name":"currency","in":"query","required":false,"description":"ISO 4217 code. Default: USD.","schema":{"type":"string","pattern":"^[A-Za-z]{3}$"},"example":"EUR"},{"name":"from","in":"query","required":false,"description":"First date, YYYY-MM-DD. Default: 30 days before `to`.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-09-01"},{"name":"to","in":"query","required":false,"description":"Last date, YYYY-MM-DD, at most 366 days after `from`. Default: today (Kyiv).","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-09-30"}],"x-x402":{"version":2,"scheme":"exact","price":"$0.003","network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","payTo":"0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef"},"responses":{"200":{"description":"Data. The PAYMENT-RESPONSE header carries the settlement receipt.","headers":{"PAYMENT-RESPONSE":{"description":"base64 JSON settlement receipt (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["currency","from","to","base","points","stats"],"properties":{"currency":{"type":"string"},"name":{"type":["string","null"]},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"base":{"const":"UAH"},"points":{"type":"array","items":{"type":"object","required":["date","rate","units","ratePerUnit"],"properties":{"date":{"type":"string","format":"date"},"rate":{"type":"number"},"units":{"type":"number"},"ratePerUnit":{"type":"number"}}}},"stats":{"type":"object","properties":{"count":{"type":"number"},"first":{"type":"object","required":["date","rate","units","ratePerUnit"],"properties":{"date":{"type":"string","format":"date"},"rate":{"type":"number"},"units":{"type":"number"},"ratePerUnit":{"type":"number"}}},"last":{"type":"object","required":["date","rate","units","ratePerUnit"],"properties":{"date":{"type":"string","format":"date"},"rate":{"type":"number"},"units":{"type":"number"},"ratePerUnit":{"type":"number"}}},"min":{"type":"object","properties":{"date":{"type":"string","format":"date"},"ratePerUnit":{"type":"number"}}},"max":{"type":"object","properties":{"date":{"type":"string","format":"date"},"ratePerUnit":{"type":"number"}}},"change":{"type":"number"},"changePct":{"type":"number"}}}}},"meta":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"object"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"upstreamUrl":{"type":"string"},"terms":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}}}}},"example":{"data":{"currency":"EUR","name":"Euro","from":"2026-09-01","to":"2026-09-30","base":"UAH","points":[{"date":"2026-09-01","rate":51.6369,"units":1,"ratePerUnit":51.6369},{"date":"2026-09-02","rate":51.5357,"units":1,"ratePerUnit":51.5357},{"date":"2026-09-30","rate":50.9278,"units":1,"ratePerUnit":50.9278}],"stats":{"count":30,"first":{"date":"2026-09-01","rate":51.6369,"units":1,"ratePerUnit":51.6369},"last":{"date":"2026-09-30","rate":50.9278,"units":1,"ratePerUnit":50.9278},"min":{"date":"2026-09-30","ratePerUnit":50.9278},"max":{"date":"2026-09-10","ratePerUnit":51.9905},"change":-0.7091,"changePct":-1.3732}},"meta":{"endpoint":"GET /v1/rates/history","params":{"currency":"EUR","from":"2026-09-01","to":"2026-09-30"},"source":"National Bank of Ukraine open data (bank.gov.ua)","sourceUrl":"https://bank.gov.ua/ua/open-data/api-dev","upstreamUrl":"https://bank.gov.ua/...","terms":"Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.","retrievedAt":"2026-10-12T12:00:00.000Z","cached":false}}}}},"400":{"description":"Invalid parameters (free, returned before any payment)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_request","message":"date must be a calendar date in YYYY-MM-DD format","field":"date"}}}},"402":{"description":"Payment required: $0.003 USDC on Base Sepolia (testnet) via x402 v2.","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON payment requirements (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No NBU data for these parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No official NBU rate for XYZ on 2026-10-09."}}}},"502":{"description":"NBU unavailable or returned an invalid response (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"upstream_unavailable","message":"NBU did not answer in time"}}}},"503":{"description":"Payments temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"payments_unavailable","message":"Payment facilitator unreachable, try again shortly."}}}}}}},"/v1/key-rate":{"get":{"operationId":"keyRate","summary":"NBU key policy rate and overnight rates on a date","description":"National Bank of Ukraine key policy rate (облікова ставка) on a date, with the overnight deposit and overnight loan rates and every policy-rate change in the previous ~13 months. Call it for Ukrainian loan or deposit maths, late-payment penalties tied to the NBU rate, macro briefs, or to see when the rate last moved. Param: date (YYYY-MM-DD, default today in Kyiv).","tags":["paid"],"parameters":[{"name":"date","in":"query","required":false,"description":"Date, YYYY-MM-DD, from 1992-06-25. Default: today (Kyiv).","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-12"}],"x-x402":{"version":2,"scheme":"exact","price":"$0.001","network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","payTo":"0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef"},"responses":{"200":{"description":"Data. The PAYMENT-RESPONSE header carries the settlement receipt.","headers":{"PAYMENT-RESPONSE":{"description":"base64 JSON settlement receipt (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["date","asOf","policyRatePct","policyRateChanges"],"properties":{"date":{"type":"string","format":"date"},"asOf":{"type":"string","format":"date"},"policyRatePct":{"type":"number"},"overnightDepositRatePct":{"type":["number","null"]},"overnightLoanRatePct":{"type":["number","null"]},"policyRateEffectiveFrom":{"type":["string","null"]},"lookbackFrom":{"type":"string","format":"date"},"policyRateChanges":{"type":"array","items":{"type":"object","properties":{"effectiveFrom":{"type":"string","format":"date"},"ratePct":{"type":"number"},"previousRatePct":{"type":"number"}}}}}},"meta":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"object"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"upstreamUrl":{"type":"string"},"terms":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}}}}},"example":{"data":{"date":"2026-10-12","asOf":"2026-10-12","policyRatePct":16,"overnightDepositRatePct":16,"overnightLoanRatePct":20,"policyRateEffectiveFrom":"2026-09-18","lookbackFrom":"2025-09-07","policyRateChanges":[{"effectiveFrom":"2026-09-18","ratePct":16,"previousRatePct":15.5},{"effectiveFrom":"2026-07-31","ratePct":15.5,"previousRatePct":15},{"effectiveFrom":"2026-01-30","ratePct":15,"previousRatePct":15.5}]},"meta":{"endpoint":"GET /v1/key-rate","params":{"date":"2026-10-12"},"source":"National Bank of Ukraine open data (bank.gov.ua)","sourceUrl":"https://bank.gov.ua/ua/open-data/api-dev","upstreamUrl":"https://bank.gov.ua/...","terms":"Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.","retrievedAt":"2026-10-12T12:00:00.000Z","cached":false}}}}},"400":{"description":"Invalid parameters (free, returned before any payment)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_request","message":"date must be a calendar date in YYYY-MM-DD format","field":"date"}}}},"402":{"description":"Payment required: $0.001 USDC on Base Sepolia (testnet) via x402 v2.","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON payment requirements (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No NBU data for these parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No official NBU rate for XYZ on 2026-10-09."}}}},"502":{"description":"NBU unavailable or returned an invalid response (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"upstream_unavailable","message":"NBU did not answer in time"}}}},"503":{"description":"Payments temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"payments_unavailable","message":"Payment facilitator unreachable, try again shortly."}}}}}}},"/v1/inflation":{"get":{"operationId":"inflation","summary":"Ukraine consumer price inflation (headline and core) for a month","description":"Ukraine consumer price inflation for a month: headline and core CPI as % month-on-month, year-on-year, since December and period average, from the national total (State Statistics Service data republished by the NBU). Call it to index UAH amounts, write a macro brief, or compare Ukrainian inflation. Param: month (YYYY-MM; omit for the latest published month).","tags":["paid"],"parameters":[{"name":"month","in":"query","required":false,"description":"Reporting month, YYYY-MM, from 2007-01 to last month. Omit for the latest published month.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"example":"2026-08"}],"x-x402":{"version":2,"scheme":"exact","price":"$0.002","network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","payTo":"0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef"},"responses":{"200":{"description":"Data. The PAYMENT-RESPONSE header carries the settlement receipt.","headers":{"PAYMENT-RESPONSE":{"description":"base64 JSON settlement receipt (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["month","headline"],"properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"headline":{"type":"object","properties":{"monthOverMonthPct":{"type":["number","null"],"description":"% change vs previous month"},"yearOverYearPct":{"type":["number","null"],"description":"% change vs same month a year earlier"},"yearToDatePct":{"type":["number","null"],"description":"% change vs December of the previous year"},"periodAverageYoYPct":{"type":["number","null"],"description":"% change of Jan..month vs the same period a year earlier"}}},"core":{"anyOf":[{"type":"object","properties":{"monthOverMonthPct":{"type":["number","null"],"description":"% change vs previous month"},"yearOverYearPct":{"type":["number","null"],"description":"% change vs same month a year earlier"},"yearToDatePct":{"type":["number","null"],"description":"% change vs December of the previous year"},"periodAverageYoYPct":{"type":["number","null"],"description":"% change of Jan..month vs the same period a year earlier"}}},{"type":"null"}]},"producer":{"type":"string"}}},"meta":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"object"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"upstreamUrl":{"type":"string"},"terms":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}}}}},"example":{"data":{"month":"2026-08","headline":{"monthOverMonthPct":0.1,"yearOverYearPct":8.1,"yearToDatePct":6.1,"periodAverageYoYPct":7.8},"core":{"monthOverMonthPct":0.5,"yearOverYearPct":8.1,"yearToDatePct":5.6,"periodAverageYoYPct":7.6},"producer":"State Statistics Service of Ukraine (republished by the NBU)"},"meta":{"endpoint":"GET /v1/inflation","params":{"month":"2026-08"},"source":"National Bank of Ukraine open data (bank.gov.ua)","sourceUrl":"https://bank.gov.ua/ua/open-data/api-dev","upstreamUrl":"https://bank.gov.ua/...","terms":"Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.","retrievedAt":"2026-10-12T12:00:00.000Z","cached":false}}}}},"400":{"description":"Invalid parameters (free, returned before any payment)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_request","message":"date must be a calendar date in YYYY-MM-DD format","field":"date"}}}},"402":{"description":"Payment required: $0.002 USDC on Base Sepolia (testnet) via x402 v2.","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON payment requirements (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No NBU data for these parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No official NBU rate for XYZ on 2026-10-09."}}}},"502":{"description":"NBU unavailable or returned an invalid response (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"upstream_unavailable","message":"NBU did not answer in time"}}}},"503":{"description":"Payments temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"payments_unavailable","message":"Payment facilitator unreachable, try again shortly."}}}}}}},"/v1/ovdp/auctions":{"get":{"operationId":"ovdpAuctions","summary":"Ukrainian government bond (OVDP) primary auction results","description":"Results of Ukrainian domestic government bond (OVDP) primary auctions held by the Ministry of Finance, as published by the NBU: ISIN, maturity, cut-off and average yield, bid-to-cover, volumes and funds raised. Call it for UAH yield-curve points, sovereign debt monitoring or fixed-income briefs. Param: date (YYYY-MM-DD auction date; omit for the latest auction).","tags":["paid"],"parameters":[{"name":"date","in":"query","required":false,"description":"Auction date, YYYY-MM-DD, from 2012-01-01. Omit for the latest auction. Auctions are usually on Tuesdays.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"example":"2026-10-06"}],"x-x402":{"version":2,"scheme":"exact","price":"$0.002","network":"eip155:84532","asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","payTo":"0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef"},"responses":{"200":{"description":"Data. The PAYMENT-RESPONSE header carries the settlement receipt.","headers":{"PAYMENT-RESPONSE":{"description":"base64 JSON settlement receipt (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["auctionDate","placements"],"properties":{"auctionDate":{"type":"string","format":"date"},"placements":{"type":"array","items":{"type":"object","properties":{"auctionNumber":{"type":["string","null"]},"isin":{"type":["string","null"]},"currency":{"type":["string","null"]},"settlementDate":{"type":["string","null"]},"maturityDate":{"type":["string","null"]},"tenorDays":{"type":["number","null"]},"bucket":{"type":["string","null"]},"cutoffYieldPct":{"type":["number","null"]},"averageYieldPct":{"type":["number","null"]},"lowestBidYieldPct":{"type":["number","null"]},"highestBidYieldPct":{"type":["number","null"]},"bidToCover":{"type":["number","null"]},"bidsReceived":{"type":["number","null"],"description":"Bids received, in issue currency"},"soldTotal":{"type":["number","null"],"description":"Volume sold at nominal, in issue currency"},"soldNonCompetitive":{"type":["number","null"]},"fundsRaised":{"type":["number","null"],"description":"Funds raised for the State Budget, in issue currency"},"placementLimitPcs":{"type":["number","null"]},"acceptedBidsPcs":{"type":["number","null"]}}}}}},"meta":{"type":"object","properties":{"endpoint":{"type":"string"},"params":{"type":"object"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"upstreamUrl":{"type":"string"},"terms":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"}}}}},"example":{"data":{"auctionDate":"2026-10-06","placements":[{"auctionNumber":"111","isin":"UA4000239115","currency":"UAH","settlementDate":"2026-10-07","maturityDate":"2027-09-15","tenorDays":343,"bucket":"1y","cutoffYieldPct":15.15,"averageYieldPct":15.14,"lowestBidYieldPct":15.1,"highestBidYieldPct":15.18,"bidToCover":2.6,"bidsReceived":2629226000,"soldTotal":1000000000,"soldNonCompetitive":300000000,"fundsRaised":1008821071.37,"placementLimitPcs":1000000,"acceptedBidsPcs":1000000}]},"meta":{"endpoint":"GET /v1/ovdp/auctions","params":{"date":"2026-10-06"},"source":"National Bank of Ukraine open data (bank.gov.ua)","sourceUrl":"https://bank.gov.ua/ua/open-data/api-dev","upstreamUrl":"https://bank.gov.ua/...","terms":"Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.","retrievedAt":"2026-10-12T12:00:00.000Z","cached":false}}}}},"400":{"description":"Invalid parameters (free, returned before any payment)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid_request","message":"date must be a calendar date in YYYY-MM-DD format","field":"date"}}}},"402":{"description":"Payment required: $0.002 USDC on Base Sepolia (testnet) via x402 v2.","headers":{"PAYMENT-REQUIRED":{"description":"base64 JSON payment requirements (x402 v2)","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"No NBU data for these parameters (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found","message":"No official NBU rate for XYZ on 2026-10-09."}}}},"502":{"description":"NBU unavailable or returned an invalid response (not charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"upstream_unavailable","message":"NBU did not answer in time"}}}},"503":{"description":"Payments temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"payments_unavailable","message":"Payment facilitator unreachable, try again shortly."}}}}}}},"/health":{"get":{"operationId":"health","summary":"Service status (free)","tags":["free"],"responses":{"200":{"description":"OK"}}}},"/llms.txt":{"get":{"operationId":"llmsTxt","summary":"Agent-oriented overview (free)","tags":["free"],"responses":{"200":{"description":"text/markdown"}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}}}},"x-input-schemas":{"rates":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","description":"Date the rate applies to, YYYY-MM-DD, from 1996-09-02 to tomorrow (Kyiv). Default: today.","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"currency":{"type":"string","description":"ISO 4217 code such as USD, EUR, PLN, XAU. Omit to get every published currency.","pattern":"^[A-Za-z]{3}$"}},"required":[]},"rates-history":{"type":"object","additionalProperties":false,"properties":{"currency":{"type":"string","description":"ISO 4217 code. Default: USD.","pattern":"^[A-Za-z]{3}$"},"from":{"type":"string","description":"First date, YYYY-MM-DD. Default: 30 days before `to`.","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","description":"Last date, YYYY-MM-DD, at most 366 days after `from`. Default: today (Kyiv).","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":[]},"key-rate":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","description":"Date, YYYY-MM-DD, from 1992-06-25. Default: today (Kyiv).","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":[]},"inflation":{"type":"object","additionalProperties":false,"properties":{"month":{"type":"string","description":"Reporting month, YYYY-MM, from 2007-01 to last month. Omit for the latest published month.","pattern":"^\\d{4}-\\d{2}$"}},"required":[]},"ovdp-auctions":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","description":"Auction date, YYYY-MM-DD, from 2012-01-01. Omit for the latest auction. Auctions are usually on Tuesdays.","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":[]}}}}