Chains

List all available chains

get

Responses

200

Successful response

application/json

500

Internal server error

application/json

get

/chains

HTTPcURLJavaScriptPython

GET /api/v2/chains HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "chains": [
    {
      "id": 1,
      "name": "text",
      "url": "https://example.com",
      "iconUrl": "https://example.com"
    }
  ]
}

Add a new chain (Admin only)

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · min: 1 · max: 100Required

urlstring · uri | nullableRequired

iconUrlstring · uri | nullableRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/chains

HTTPcURLJavaScriptPython

POST /api/v2/chains HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "name": "text",
  "url": "https://example.com",
  "iconUrl": "https://example.com"
}

{
  "chain": {
    "id": 1,
    "name": "text",
    "url": "https://example.com",
    "iconUrl": "https://example.com"
  }
}

Edit an existing chain (Admin only)

put

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Body

application/json

namestring · min: 1 · max: 100Required

urlstring · uri | nullableRequired

iconUrlstring · uri | nullableRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

put

/chains/{id}

HTTPcURLJavaScriptPython

PUT /api/v2/chains/{id} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "name": "text",
  "url": "https://example.com",
  "iconUrl": "https://example.com"
}

{
  "chain": {
    "id": 1,
    "name": "text",
    "url": "https://example.com",
    "iconUrl": "https://example.com"
  }
}

Delete a chain (Admin only)

delete

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idintegerRequired

Responses

200

Successful response

application/json

Responseany

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

delete

/chains/{id}

HTTPcURLJavaScriptPython

DELETE /api/v2/chains/{id} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get current Base gas price

get

⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Responses

200

Successful response

application/json

500

Internal server error

application/json

get

/chains/base/gas-price

HTTPcURLJavaScriptPython

GET /api/v2/chains/base/gas-price HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "wei": 1,
  "level": "low",
  "updatedAt": "text"
}