xga.fyi

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.

PUT
/api/v1/bids/{id}

Path Parameters

idstring

Bid CUID

value?string

Updated bid value in wei

Match^[0-9]+$
quantity?number

Updated quantity

Range1 <= 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