Address | Obol Docs

Retrieve obol techne credentials of an address

get

/v1/address/techne/{address}

This endpoint is used to retrieve obol techne credentials an address owns

Path parameters

addressstringRequired

The address to check the techne credentials for.

Responses

200

The address techne credentials object

application/json

Responseany of

400

The Address provided is not valid

500

An unknown error occurred

get

/v1/address/techne/{address}

GET /v1/address/techne/{address} HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "base": [
    "text"
  ],
  "bronze": [
    "text"
  ],
  "silver": [
    "text"
  ],
  "gold": [
    "text"
  ]
}

Retrieve badges for an address

get

/v1/address/badges/{address}

This endpoint is used to retrieve the badges an address owns

Path parameters

addressstringRequired

The address to check the techne credentials for.

Responses

200

The address techne credentials object

application/json

Responseany of

400

The Address provided is not valid

500

An unknown error occurred

get

/v1/address/badges/{address}

GET /v1/address/badges/{address} HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "badges": [
    "text"
  ]
}

Retrieve operators on a given network

get

/v1/address/network/{network}

This endpoint fetches a number of operators for a given network.

Path parameters

networkstringRequired

The network to retrieve operators on

Example: {"summary":"Ethereum Mainnet","value":"mainnet"}

Query parameters

pageintegerRequired

The page number to retrieve.

Default: 0

limitintegerRequired

The number of operators to return.

Default: 100

sortBystringOptional

numerical field to sort by

Default: active_validators_count

sortOrderstringOptional

order of sorting the field

Default: desc

detailsstringRequired

The flag to populate operators information.

Default: false

Responses

200

A paged list of Operators on this network

application/json

Responseany of

400

Network not spported

500

An unknown error occurred

get

/v1/address/network/{network}

GET /v1/address/network/{network}?page=0&limit=100&details=false HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "operators": [
    "text"
  ],
  "total_count": 2,
  "total_pages": 4
}

Retrieve a list operators on a given network

get

/v1/address/search/{network}

This endpoint is used to search for operators that match a substring of their address.

Path parameters

networkstringRequired

The network to retrieve operators on

Example: {"summary":"Ethereum Mainnet","value":"mainnet"}

Query parameters

partialAddressstringRequired

A substring of the address of Operator.

pageintegerRequired

The page number to retrieve.

Default: 0

limitintegerRequired

The number of operators to return.

Default: 100

Responses

200

A paged list of Operators on this network

application/json

Responseany of

404

Operators not found

500

An unknown error occurred

get

/v1/address/search/{network}

GET /v1/address/search/{network}?partialAddress=text&page=0&limit=100 HTTP/1.1
Host: api.obol.tech
Accept: */*

{
  "operators": [
    "text"
  ],
  "total_count": 2,
  "total_pages": 4
}