Tender API

POST /v1/tenders/{tender_id}/offers

Als zugelassener Verkäufer (Zugangsstatus approved oder shortlisted, sonst 403) ein indikatives Angebot abgeben. Ein Angebot deckt eine Technologie ab — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab — und nennt mindestens eine Erzeugungsanlage dieser Technologie. Lieferbeginn und Laufzeit liegen innerhalb der Ausschreibung. Die Frist für indikative Angebote ist ein Zieldatum: Auch danach nimmt die Plattform Angebote an. Ein Erzeugungsprofil (Werte in 5- bis 60-Minuten-Intervallen) wird im Angebots-Wizard der Plattform mit dem Angebot hochgeladen; ein über diese API abgegebenes Angebot trägt keines (production_profile_available bleibt false). Ohne Profil lassen sich Capture Rate, Effektivkosten und Verbrauchsmatching nicht bewerten. Baseload- und Pay-as-Indexed-Angebote brauchen kein Erzeugungsprofil. Einmal abgegeben, ist das Angebot für den Käufer sichtbar und unveränderlich; Änderungen erfolgen durch eine Revision. Erforderlicher Scope: tenders:offer

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/tenders/{tender_id}/offers
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

pricing_modelstring

Preismodell: fixed (Fixpreis) oder discount (Abschlag auf den EEX-Base-Future je Lieferzeitraum)

Value in"fixed" | "discount"
price_schedule?string

Wie der Energiepreis über die Laufzeit abgerechnet wird: flat (ein einheitlicher Preis, das mengengewichtete Mittel der Zeiträume, Voreinstellung) oder per_period (jeder Zeitraum zu seinem eigenen Preis)

Value in"flat" | "per_period"
price_per_mwh?number

Energiepreis in EUR/MWh (bis zu 4 Nachkommastellen) — Pflicht bei fixed mit flat. Bei discount und bei per_period errechnet die Plattform den Wert als mengengewichtetes Mittel

period_discounts?array<PeriodDiscount>

Bei discount Pflicht — ein Abschlag je Lieferzeitraum der Laufzeit. Für jeden Zeitraum muss ein EEX-Future notiert sein (OFFER_TERM_OUTSIDE_EEX_HORIZON, OFFER_PERIOD_DISCOUNT_MISSING)

year_prices?array<YearPrice>

Bei fixed mit per_period Pflicht — ein Preis je Kalenderjahr der Laufzeit (OFFER_YEAR_PRICE_MISSING)

price_per_gonumber

Preis je HKN in EUR/MWh, getrennt vom Energiepreis (bis zu 4 Nachkommastellen); Pflicht, 0 ist zulässig

technologystring

Eine Technologie je Angebot — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab

Value in"solar" | "wind"
start_datestring

Lieferbeginn (YYYY-MM-DD); nicht vor dem Lieferbeginn der Ausschreibung

Formatdate
contract_yearsinteger

Vertragslaufzeit in Jahren, innerhalb der Spanne der Ausschreibung

Range1 <= value <= 30
end_date?string

Genaues, einschließendes Enddatum bei abweichender Laufzeit; entfällt, wenn contract_years gilt

Formatdate
delivery_profilestring

Angebotenes Lieferprofil

Value in"baseload" | "pay_as_forecasted" | "pay_as_produced" | "shaped" | "pay_as_indexed" | "pay_as_consumed"
price_index?string

Abrechnungsindex bei Pay as Indexed

Value in"enwex_solar" | "enwex_wind"
volume_per_yearnumber

Angebotene Menge in MWh pro Jahr, über 0 (bis zu 3 Nachkommastellen)

capacity_mwnumber

Installierte Leistung, die das Angebot unterlegt, in MW, über 0

offer_message?string

Anmerkungen (bis zu 2.000 Zeichen)

asset_idsarray<string>

Erzeugungsanlagen der angebotenen Technologie, mindestens eine, höchstens 100 (OFFER_ASSETS_INVALID)

Response Body

curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/offers" \  -H "Content-Type: application/json" \  -d '{    "technology": "solar",    "start_date": "2027-01-01",    "contract_years": 10,    "delivery_profile": "pay_as_forecasted",    "volume_per_year": 31500,    "capacity_mw": 30,    "asset_ids": [      "ast_1w4y7z2c"    ]  }'
{
  "pricing_model": "fixed",
  "price_schedule": "flat",
  "price_per_mwh": 54.5,
  "period_discounts": [
    {
      "key": "cal-2027",
      "discount_percent": 36
    }
  ],
  "year_prices": [
    {
      "year": 2027,
      "price_per_mwh": 54.5
    }
  ],
  "price_per_go": 0.8,
  "id": "ten_off_8m2p6r9t",
  "tender_id": "ten_7g4k2m9p",
  "seller_company_id": "com_9k3m7p2r",
  "technology": "solar",
  "status": "submitted",
  "accepted_at": null,
  "start_date": "2027-01-01",
  "contract_years": 10,
  "end_date": null,
  "delivery_profile": "pay_as_forecasted",
  "price_index": null,
  "volume_per_year": 31500,
  "capacity_mw": 30,
  "discount_percent": null,
  "price_periods": [
    {
      "key": "cal-2027",
      "period_start": "2027-01-01",
      "period_end": "2027-12-31",
      "partial": false,
      "discount_percent": 36,
      "future_price": 85,
      "price_per_mwh": 54.4
    }
  ],
  "price_settlement_date": "2026-10-09",
  "offer_message": "Profil 2023–2025 ist die reale Einspeisung.",
  "assets": [
    {
      "id": "ast_1w4y7z2c",
      "name": "Solarpark Niederbayern",
      "mastr_number": "SEE931570002846",
      "technology": "solar",
      "capacity_mw": 30
    }
  ],
  "production_profile_available": true,
  "replaces_offer_id": null,
  "score": {
    "composite": 76,
    "rating": "recommended",
    "ko": false,
    "ko_criteria": [],
    "completeness": 1,
    "seller_completeness": 1,
    "criteria": [
      {
        "key": "capture",
        "value": 86,
        "score": 0,
        "missing": null
      }
    ]
  },
  "submitted_at": "2026-10-10T14:20:00Z",
  "created_at": "2026-10-10T14:20:00Z"
}

{
  "type": "https://api.otark.com/errors/tender_deadline_signing_before_offers",
  "title": "Geplanter PPA-Abschluss vor der Frist für indikative Angebote",
  "status": 400,
  "error": "TENDER_DEADLINE_SIGNING_BEFORE_OFFERS",
  "instance": "/v1/tenders/ten_7g4k2m9p"
}

{
  "type": "https://api.otark.com/errors/insufficient_scopes",
  "title": "Unzureichende Scopes des API-Schlüssels",
  "status": 401,
  "error": "INSUFFICIENT_SCOPES",
  "detail": "Missing scope: tenders:write. Please create a new API key with the required scopes."
}

{
  "type": "https://api.otark.com/errors/tender_recipient_restriction_not_allowed",
  "title": "Empfängerkreis lässt sich nicht einschränken",
  "status": 403,
  "error": "TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED"
}

{
  "type": "https://api.otark.com/errors/tender_not_found",
  "title": "Ausschreibung nicht gefunden",
  "status": 404,
  "error": "TENDER_NOT_FOUND",
  "instance": "/v1/tenders/ten_7g4k2m9p"
}

{
  "type": "https://api.otark.com/errors/tender_admission_deadline_passed",
  "title": "Frist für indikative Angebote abgelaufen",
  "status": 409,
  "error": "TENDER_ADMISSION_DEADLINE_PASSED"
}