> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trlyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a bid

> Places a bid on a running auction for your organisation. The auction must be within its open interval, your organisation must be a participant, and the price must be in EUR (maximum €10,000,000). Multiple bids are allowed; your latest bid is used when determining the winner. Highest price wins; if prices tie, the earliest bid wins. Requires the `Create:bids` permission.



## OpenAPI

````yaml https://api.trlyr.com/auctions/docs/doc.json post /auctions/{auctionID}/bids
openapi: 3.1.0
info:
  description: >
    This API lets participating organisations browse energy auctions, submit
    bids, and track outcomes on the terralayr platform. 
     
    Each auction offers a virtual-asset delivery window (power, energy, and
    efficiency parameters) for a specific period. During the auction open
    interval, invited organisations can place bids priced in EUR. After the
    auction closes, the highest valid bid wins; if prices tie, the earliest bid
    wins. 
     
    Auction responses include a status for your organisation, such as
    `NOT_STARTED`, `RUNNING`, `WON`, `LOST`, `PENDING`, or `NO_BIDS_SUBMITTED`.
    When you win, the response includes the allocated virtual asset ID. 
     
    ### Authorization 
     
    All requests require a Bearer-type `Authorization` header in the form:
    `Authorization: Bearer <YOUR_TOKEN>`. 
     
    To retrieve a valid token, authenticate with username and password: 
     
    ``` 

    POST https://api.trlyr.com/auth/public/authenticate 

    ``` 
     
    with the following JSON body: 
     
    ``` 

    { 
        "username": "YOUR_USERNAME", 
        "password": "YOUR_PASSWORD" 
    } 

    ``` 
     
    Your username and password are the ones you created after receiving an
    invitation to join your organisation. 
     
    You should receive a JSON response body from which you can extract your
    token under `access_token`. 
     
    If you have any questions, don't hesitate to contact our account manager at
    the following address: support@trlyr.com. 
  title: terralayr Auctioneer API
  version: 1.0.0
servers:
  - description: Production API
    url: https://api.trlyr.com
  - description: Sandbox API
    url: https://api.sandbox.trlyr.com
security: []
tags:
  - description: >-
      Browse auctions your organisation participates in and inspect auction
      status.
    name: auctions
  - description: Submit and review bids on open auctions.
    name: bids
externalDocs:
  description: ''
  url: ''
paths:
  /auctions/{auctionID}/bids:
    post:
      tags:
        - bids
      summary: Submit a bid
      description: >-
        Places a bid on a running auction for your organisation. The auction
        must be within its open interval, your organisation must be a
        participant, and the price must be in EUR (maximum €10,000,000).
        Multiple bids are allowed; your latest bid is used when determining the
        winner. Highest price wins; if prices tie, the earliest bid wins.
        Requires the `Create:bids` permission.
      parameters:
        - description: Access token
          in: header
          name: Authorization
          required: true
          schema:
            default: Bearer <access token value>
            type: string
        - description: Auction ID
          in: path
          name: auctionID
          required: true
          schema:
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/pkg_models_http_public_v0_requests.BidRequestBody
              description: Bid price in EUR (major units, e.g. 1250.5)
              summary: bid
        description: Bid price in EUR (major units, e.g. 1250.5)
        required: true
      responses:
        '201':
          description: Created
        '400':
          description: >-
            Invalid request body, bid above maximum, or auction not open for
            bidding
        '404':
          description: Not Found
        '500':
          description: Internal Server Error
components:
  schemas:
    pkg_models_http_public_v0_requests.BidRequestBody:
      properties:
        price:
          type: number
      required:
        - price
      type: object

````