Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Obol DV Migrate API
description: '## What is this API?
This API is for creating and managing Distributed Validators. This API works in tandem with Obol''s Distributed Validator Launchpad, a dapp designed to allow people to authenticate their counterparties and agree to the terms of a Distributed Validator Cluster. This API will be made more easy for code-only interaction in the coming quarters with the release of the Obol-SDK.
Read more about Obol and how to use the launchpad on our docs site.
For enquiries:'
version: v1.0.0-local
contact:
name: Obol Labs
url: https://obol.tech
email: support@obol.tech
servers:
- url: https://api.obol.tech
description: Production environment
- url: http://localhost:3000
description: Local development server
- url: https://localhost:3000
description: HTTPS Local development server
tags:
- name: DV Migrate
paths:
/v1/migrate/{network}:
get:
description: It shows data of validators status
operationId: MigrateController_getValidatorsMigrateStatus_v1
parameters:
- name: network
required: true
in: path
description: The network to retrieve clusters on
examples:
mainnet:
summary: Ethereum Mainnet
value: mainnet
hoodi:
summary: Hoodi Test Network
value: hoodi
sepolia:
summary: Sepolia Test Network
value: sepolia
schema:
type: string
- name: limit
required: true
in: query
description: The number of validators to return.
schema:
type: integer
default: 50
- name: page
required: true
in: query
description: The page number to retrieve.
schema:
type: integer
default: 0
- name: withdrawalAddress
required: true
in: query
description: Withdrawal address of target validators.
schema:
type: string
- name: targetPubKey
required: true
in: query
description: The `pubkey` of target validator.
schema:
type: string
responses:
'200':
description: The migration status data
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/MigrationStateResponse'
'404':
description: Data is not found
'500':
description: An unknown error occurred
summary: Retrieve validators migrate status
tags:
- DV Migrate
components:
schemas:
ValidatorDetails:
type: object
properties:
pubkey:
type: string
example: '12345'
status:
type: string
example: fully_migrated
effective_balance:
type: string
example: '32000000000'
description: Effective balance in gwei
lock_hash:
type: string
example: '0xd2880980169ee4a0000f23feb8fad9a6c70f38312956fe67aa89e118f5b0e048'
required:
- pubkey
- status
- effective_balance
- lock_hash
MigrationStateResponse:
type: object
properties:
validators:
type: array
items:
$ref: '#/components/schemas/ValidatorDetails'
required:
- validators
securitySchemes:
bearer:
scheme: bearer
bearerFormat: JWT
type: http