{"tool":"tenders-awards","title":"TenderGraph Award Analysis","what":"Published contract award results matching a supplier, buyer, country, CPV or date range: each award with winners, their country and size, award and tender values with currency, decision and contract dates and the buyer. Plus an aggregate per currency (count, sum, median, sample size and date range); amounts are never added across currencies and notices without a value are counted as missing.","endpoint":"https://yruz.one/api/tenders/awards","methods":["GET with query parameters","POST with a JSON body (same fields)"],"price":{"model":"fixed","usdc":"0.02"},"params":[{"name":"q","required":false,"description":"keywords in the notice text, e.g. cloud software","example":null},{"name":"country","required":false,"description":"buyer country, ISO code (DE, DEU, RS, SRB ...)","example":"RS"},{"name":"cpv","required":false,"description":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","example":null},{"name":"buyer","required":false,"description":"contracting authority name contains","example":null},{"name":"supplier","required":false,"description":"winner name contains","example":null},{"name":"from","required":false,"description":"published from YYYY-MM-DD","example":null},{"name":"to","required":false,"description":"published to YYYY-MM-DD","example":null},{"name":"limit","required":false,"description":"awards, 1-50 (default 25)","example":"10"},{"name":"lang","required":false,"description":"language, 2 letters (default en)","example":null}],"valid_request":{"get":"https://yruz.one/api/tenders/awards?country=RS&limit=10","post":{"url":"https://yruz.one/api/tenders/awards","body":{"country":"RS","limit":"10"}}},"how_to_pay":["1. Send the request without payment: the answer is HTTP 402 with the exact price (x402 v2 in the PAYMENT-REQUIRED header, x402 v1 in the JSON body).","2. Sign one offer of \"accepts\" with an x402 client (USDC on Base eip155:8453 or on Solana mainnet; the facilitator pays the network fee).","3. Resend the identical request (same method, parameters and body) with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1).","4. The answer carries the receipt in PAYMENT-RESPONSE. Any changed parameter needs a new 402."],"response_shape":{"product":"string","result":{"product":"string","task":"string","task_version":"number","api_version":"string","data":{"filters":{"country":"string"},"total_matching":"number","returned":"number","aggregate":{"sample_size":"number","sample_published":{"from":"string","to":"string"},"total_value":{"by_currency":["…"],"notices_without_value":"number","value_field":"string","conversion":"string"},"notices_without_named_winner":"number","note":"string"},"awards":[{"id":"string","source":"string","source_record_id":"string","notice_type":"string","form_type":"string","stage":"string","published_on":"string","title":"string","buyer":{"…":"…"},"cpv":["…"],"contract_nature":["…"],"procedure_type":"string","procedure_id":"string","place_of_performance":["…"],"estimated_value":{"…":"…"},"lot_deadlines":["…"],"links":{"…":"…"},"award":{"…":"…"}}]},"provenance":[{"source":"string","name":"string","source_url":"string","record_urls":["string"],"retrieved_at":"string","retrieved_until":"string","served_from_cache":"boolean","licence":"string","attribution":"string"}],"data_as_of":"string","freshness_status":"string","coverage":"string","partial":"boolean","warnings":["string"],"usage":{"units":"number","unit":"string","records":"number","upstream_requests":"number","retries":"number","cache_hits":"number","runtime_ms":"number"}},"payment":{"payment_id":"string","transaction":"string"}},"refusals":{"400":"invalid input: the message names the field and the expected format; nothing is charged","402":"payment required, or the payment was refused (reason in \"error\"); nothing is charged","403/404":"not your item, or the asked item does not exist; nothing is charged","409/422":"not allowed right now (state or destination safety); nothing is charged","503":"a source or the payment rail is unavailable; nothing is charged, retry after Retry-After"},"mcp":{"server":"https://yruz.one/mcp/x402","payment":"params._meta[\"x402/payment\"] = PaymentPayload"},"related":{"tools":[{"tool":"tenders-search","url":"https://yruz.one/api/tenders/search","why":"find EU tenders","usd":"0.005","how":"https://yruz.one/api/instructions?tool=tenders-search"},{"tool":"tenders-deadlines","url":"https://yruz.one/api/tenders/deadlines","why":"calls closing soon","usd":"0.003","how":"https://yruz.one/api/instructions?tool=tenders-deadlines"},{"tool":"tenders-monitor","url":"https://yruz.one/api/tenders/monitor","why":"has a procedure changed","usd":"0.003","how":"https://yruz.one/api/instructions?tool=tenders-monitor"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"}}