Address

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
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
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
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
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
}

Last updated

Was this helpful?