Skip to main content
POST
/
v1
/
subscribe
Subscribe
curl --request POST \
  --url https://api.example.com/v1/subscribe \
  --header 'Content-Type: application/json' \
  --data '
{
  "topics": [
    "peer_connected",
    "validator_opted_in"
  ]
}
'
{
  "result": {
    "topic": "peer_connected",
    "value": {
      "ethAddress": "0x123...",
      "type": "provider"
    }
  },
  "error": {
    "code": 123,
    "message": "<string>",
    "details": [
      {
        "@type": "<string>"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.primev.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
topics
string[]

List of topics to subscribe to. Available topics:

  • peer_connected: Emitted when a peer connects to the network
  • peer_disconnected: Emitted when a peer disconnects from the network
  • validator_opted_in: Emitted before an upcoming L1 block proposer has opted in to the mev-commit protocol
  • epoch_validators_opted_in: Emitted at the beginning of an epoch, specifying any slots where the L1 validator is opted-in to mev-commit
  • provider_slashed: Emitted when the provider node is slashed.
  • commitment_store_failed: Emitted when the commitment storing transaction fails.
  • commitment_open_failed: Emitted when the commitment opening transaction fails.
Example:
["peer_connected", "validator_opted_in"]

Response

A successful response.(streaming responses)

​
result
Notification represents a notification message sent to subscribers · object
​
error
object