Update bid
Update a bid's value, quantity, or gas parameters. Only the bid owner can update their bids. Bids can only be updated in PENDING or VALIDATED status.
Path Parameters
idstring
Bid CUID
value?string
Updated bid value in wei
Match
^[0-9]+$
quantity?number
Updated quantity
Range
1 <= value
gasFeeCap?string
Updated gas fee cap in wei
Match
^[0-9]+$
gasTipCap?string
Updated gas tip cap in wei
Match
^[0-9]+$
Response Body
curl -X PUT "http://localhost:3000/api/v1/bids/string" \
-H "Content-Type: application/json" \
-d '{}'
const body = JSON.stringify({})
fetch("http://localhost:3000/api/v1/bids/string", {
body
})
package main
import (
"fmt"
"net/http"
"io/ioutil"
"strings"
)
func main() {
url := "http://localhost:3000/api/v1/bids/string"
body := strings.NewReader(`{}`)
req, _ := http.NewRequest("PUT", url, body)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
import requests
url = "http://localhost:3000/api/v1/bids/string"
body = {}
response = requests.request("PUT", url, json = body, headers = {
"Content-Type": "application/json"
})
print(response.text)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import java.net.http.HttpRequest.BodyPublishers;
var body = BodyPublishers.ofString("""{}""");
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
.uri(URI.create("http://localhost:3000/api/v1/bids/string"))
.header("Content-Type", "application/json")
.PUT(body)
.build();
try {
HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
System.out.println("Status code: " + response.statusCode());
System.out.println("Response body: " + response.body());
} catch (Exception e) {
e.printStackTrace();
}
using System;
using System.Net.Http;
using System.Text;
var body = new StringContent("""
{}
""", Encoding.UTF8, "application/json");
var client = new HttpClient();
var response = await client.PutAsync("http://localhost:3000/api/v1/bids/string", body);
var responseBody = await response.Content.ReadAsStringAsync();
{
"id": "tz4a98xxat96iws9zmbrgj3a",
"slot": 1234567,
"entityId": "entity-123",
"value": "1000000000000000000",
"quantity": 100,
"gasFeeCap": "20000000000",
"gasTipCap": "2000000000",
"builderPublicKey": "0x1234567890abcdef...",
"status": "pending",
"submittedAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z",
"validatedAt": "2024-01-01T00:00:05.000Z",
"validFrom": "2024-01-01T00:00:00.000Z",
"validUntil": "2024-01-01T00:00:12.000Z",
"version": 1,
"nonce": "1234567890",
"metadata": {
"priority": "high",
"source": "api"
},
"isActive": true,
"isModifiable": true,
"hasExpired": false
}
Empty
Empty