Deposit Data

Deposit Data related endpoints.

Retrieve partial deposit data for a validator

get

https://api.obol.techhttp://localhost:3000https://localhost:3000

/deposit_data/{lockHash}/{pubkey}

This endpoint returns all partial deposit data grouped by amount for a specific validator

Path parameters

lockHashstringRequired

The cluster lock hash

pubkeystringRequired

The validator public key (distributed_public_key)

Responses

200

The deposit data

application/json

Responseany of

404

Data is not found

500

An unknown error occurred

get

/deposit_data/{lockHash}/{pubkey}

HTTPcURLJavaScriptPython

GET /deposit_data/{lockHash}/{pubkey} HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "lock_hash": "",
  "pubkey": "0xFULL_1",
  "withdrawal_credentials": "0xWITHDRAW_1",
  "amounts": [
    {
      "amount": "32000000000",
      "partials": [
        {
          "partial_public_key": "0xPARTIAL_A",
          "partial_deposit_signature": "0xSIG_A1"
        }
      ]
    }
  ]
}

Retrieve partial deposit data for a validator

get

https://api.obol.techhttp://localhost:3000https://localhost:3000

/v1/deposit_data/{lockHash}/{pubkey}

This endpoint returns all partial deposit data grouped by amount for a specific validator

Path parameters

lockHashstringRequired

The cluster lock hash

pubkeystringRequired

The validator public key (distributed_public_key)

Responses

200

The deposit data

application/json

Responseany of

404

Data is not found

500

An unknown error occurred

get

/v1/deposit_data/{lockHash}/{pubkey}

HTTPcURLJavaScriptPython

GET /v1/deposit_data/{lockHash}/{pubkey} HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "lock_hash": "",
  "pubkey": "0xFULL_1",
  "withdrawal_credentials": "0xWITHDRAW_1",
  "amounts": [
    {
      "amount": "32000000000",
      "partials": [
        {
          "partial_public_key": "0xPARTIAL_A",
          "partial_deposit_signature": "0xSIG_A1"
        }
      ]
    }
  ]
}

Push partial deposit data

post

https://api.obol.techhttp://localhost:3000https://localhost:3000

/deposit_data/partial_deposits/{lockHash}/{share_index}

This endpoint saves partial deposit data signed by an operator

Path parameters

lockHashstringRequired

The lock hash of the cluster

share_indexnumberRequired

The share index (operator index + 1)

Body

application/json

Responses

201

Deposit data saved successfully

400

Invalid request format | Conflicting withdrawal address. Delete the existing deposits first. | Validator is already initialised.

401

Invalid deposit signature

404

Data or validator not found

500

An unknown error occurred

post

/deposit_data/partial_deposits/{lockHash}/{share_index}

HTTPcURLJavaScriptPython

POST /deposit_data/partial_deposits/{lockHash}/{share_index} HTTP/1.1
Host: api.obol.tech
Content-Type: application/json
Accept: */*
Content-Length: 279

{
  "partial_deposit_data": [
    {
      "pubkey": "0x8b69c67720c909423d7edc5d3a7554e1d1e50f6d7d5f8d18548d68daf424e536afba8b31fbd15df1970ba4af4a7d944c",
      "withdrawal_credentials": "0x010000000000000000000000abcdef1234567890abcdef1234567890abcdef12",
      "amount": "32000000000",
      "signature": "0x1234..."
    }
  ]
}

No content

Push partial deposit data

post

https://api.obol.techhttp://localhost:3000https://localhost:3000

/v1/deposit_data/partial_deposits/{lockHash}/{share_index}

This endpoint saves partial deposit data signed by an operator

Path parameters

lockHashstringRequired

The lock hash of the cluster

share_indexnumberRequired

The share index (operator index + 1)

Body

application/json

Responses

201

Deposit data saved successfully

400

Invalid request format | Conflicting withdrawal address. Delete the existing deposits first. | Validator is already initialised.

401

Invalid deposit signature

404

Data or validator not found

500

An unknown error occurred

post

/v1/deposit_data/partial_deposits/{lockHash}/{share_index}

HTTPcURLJavaScriptPython

POST /v1/deposit_data/partial_deposits/{lockHash}/{share_index} HTTP/1.1
Host: api.obol.tech
Content-Type: application/json
Accept: */*
Content-Length: 279

{
  "partial_deposit_data": [
    {
      "pubkey": "0x8b69c67720c909423d7edc5d3a7554e1d1e50f6d7d5f8d18548d68daf424e536afba8b31fbd15df1970ba4af4a7d944c",
      "withdrawal_credentials": "0x010000000000000000000000abcdef1234567890abcdef1234567890abcdef12",
      "amount": "32000000000",
      "signature": "0x1234..."
    }
  ]
}

No content