Create Bid

Creating a Bid

This guide explains how to create a Bid for an Order in the Optimize Everything API system.

📚 Full API Documentation: For all endpoints, see https://api.opteverything.com/docs

Prerequisites

• You have created an order (see Order Creation Guide)
• You have your authentication token
• You have a payment method nonce from your payment gateway
• You have a value function ID

Step 1: Create a Bid

This endpoint allows operators to submit a bid for a specific ride order.

Endpoint

POST /operator/bids

Description

Place a bid on a rider order.

• When an operator places a bid, the system immediately reserves (authorises) the operator’s payment method for the net bid amount (bid_amount minus the minimum value defined by the contract’s value function). The actual capture happens only after the trip is completed and the trip result is generated.
• Side-effects: creates a bid record, places a payment authorisation hold, and notifies the rider of the new bid.
• Possible errors: 401 (insufficient role), 400 (validation failure, e.g., order closed for bidding).

Market Maker variant

POST /market-maker/bids — Identical behaviour to /operator/bids but restricted to users with the MarketMaker role.