Search…
⌃K

API Routes

Jump to:

GET /staking/avalanche/{chain}/validators

List all of the user's Avalanche validators.

Parameters

Name
In
Type
Required
Description
chain
path
string
yes
The validator's chain: "mainnet" or "fuji".
Authorization
header
string
yes
The authentication token.
Sample request
curl -X GET https://api.bloq.com/staking/avalanche/fuji/validators \
-H 'Authorization: Bearer <AUTH_TOKEN>'

Response

Status
Description
200
The list was retrieved.
403
The authorization token is invalid.
Property
Type
Description
(root)
array
The validator data.
[].auth
object
The auth data of the instance.
[].auth.pass
string
Password to connect to the validator instance.
[].auth.type
string
Type of authentication. Will be basic.
[].auth.user
string
User to connect to the validator instance.
[].chain
string
The validator chain
[].createdAt
string
The validator creation date.
[].id
string
The validator Id.
[].avalancheNodeId
string
The Avalanche Node ID.
[].user
string
The user Id.
[].updatedAt
string
The validator update date.
[].region
string
The validator region.
Sample response
[
{
"auth": {
"type": "basic",
"user": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"pass": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"chain": "mainnet",
"createdAt": "2022-08-23T20:21:17.725Z",
"id": "node-0000000-0000-0000-0000-000000000000",
"avalancheNodeId": "NodeID-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"user": "user-00000000-0000-0000-0000-000000000000",
"updatedAt": "2022-08-24T10:04:16.142Z",
"region": "us-east-2"
}
]

POST /staking/avalanche/{chain}/validators

Create a new Avalanche validator.

Request

Name
In
Type
Required
Description
chain
path
path
yes
The validator chain: "mainnet" or "fuji".
Authorization
header
string
yes
The authentication token.
Sample request
curl -X POST https://api.bloq.com/staking/avalanche/mainnet/validators \
-H 'Authorization: Bearer <AUTH_TOKEN>'

Response

Status
Description
200
The validator was created.
403
The authorization token is invalid.
Property
Type
Description
(root)
object
The validator data.
.auth
object
The auth data of the instance.
.auth.pass
string
Password to connect to the validator instance.
.auth.type
string
Type of authentication. Should be basic
.auth.user
string
User to connect to the validator instance.
.chain
string
The validator chain
.createdAt
string
The validator creation date.
.id
string
The validator Id.
.user
string
The user Id.
.region
string
The validator region.
Sample responses
Successful response:
{
"auth": {
"type": "basic",
"user": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"pass": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"chain": "mainnet",
"createdAt": "2022-08-23T20:21:17.725Z",
"id": "node-00000000-0000-0000-0000-000000000000",
"user": "user-00000000-0000-0000-0000-000000000000",
"region": "us-east-2"
}

Error responses

All error responses are JSON objects that loosely follow the RFC 7807 specification.
{
"status": 403,
"title": "Forbidden",
"detail": "The authorization token is expired."
}