We recommend leveraging the Go RPC client or alternatively using the REST API below to send bids. For those who prefer to use command-line tools, options like grpcurl, or BloomRPC are available. These tools require the protobuf definitions from the repository to interact with the RPC services.

Official Go RPC Client

For Go developers, leveraging the official Go RPC client is the recommended approach. Start by installing the mev-commit package:

❯_ terminal
go get github.com/primevprotocol/mev-commit

Then, incorporate the generated client into your Go application as follows:

import bidderapiv1 "github.com/primevprotocol/mev-commit/gen/go/rpc/bidderapi/v1"

conn, err := grpc.DialContext(

if err != nil {
    // Error handling logic here

bid := &pb.Bid{
    TxHashes: []string{
    Amount:      "1000000000", // Specify amount in wei
    BlockNumber: 123456,

rcv, err := bidderClient.SendBid(context.Background(), bid)
if err != nil {
    // Error handling logic here

for {
    pc, err := rcv.Recv()
    if err == io.EOF {
    if err != nil {
        // Error handling logic here
    fmt.Println("Received preconfirmation:", pc.String())

Custom Client Generation

Utilize the provided protobuf files to generate a client in your preferred programming language, enabling seamless integration with your existing codebase.


🚀 Ready to send bids? Just execute this command:

curl -X POST http://localhost:13523/v1/bidder/bid \
-d '{
  "txHash": <the hash of the transaction>,
  "amount": <amount in wei>,
  "blockNumber": <blocknumber>

🌐 Postman Power: Prefer a GUI? We’ve created a custom Postman request as an alterative way to send bids. Ensure you’ve got the Postman agent ready to go!

The REST API provides a straightforward way to submit bids using HTTP requests. For detailed usage instructions, refer to the Bidder API documentation.