web3_clientVersion

POSThttps://api.triport.io/

Returns the version string of the Ethereum node client serving your requests.

Ethereum—free · 10 RPS · basic 20 · pro 100 · business 250

web3_clientVersion returns a single string identifying the client software and version of the Ethereum node that handled the request. It takes no parameters and is one of the cheapest calls on the API, which makes it a convenient health/connectivity probe: a successful response confirms that your API key is valid, your tier is active, and the node is reachable.

The exact contents of the string are determined by the underlying node and may change over time, so treat it as an opaque diagnostic value rather than something to parse programmatically. It is available on the free tier and on every tier above it.

Parameters

This method takes no parameters. Send an empty params array.

_(none)_—optional

params must be an empty array [].

Response

Response fields

Field	Type	Description
`result`	string	The node client version string. Opaque; format is node-defined and may change.

Errors

Code	Meaning	When it happens
`-32001`	`trial_expired`	Your trial has ended; renew or upgrade to continue. Maps to HTTP 401.
`-32003`	`rate_limited`	You exceeded the per-second rate limit for your tier (10 RPS on free). Maps to HTTP 429; retry after a short backoff.

See errors.md for the full JSON-RPC error envelope and the complete list of tier error codes.

Examples

JavaScript (fetch)

JavaScript

const res = await fetch("https://api.triport.io/", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "web3_clientVersion",
    params: [],
  }),
});


const { result } = await res.json();
console.log(result); // e.g. "Geth/v1.14.0-stable/linux-amd64/go1.22.0"

TypeScript SDK (`@triport/sdk`)

TypeScript

import { Triport } from "@triport/sdk";


const client = new Triport({ apiKey: process.env.TRIPORT_API_KEY! });


const version: string = await client.eth.web3ClientVersion();
console.log(version);

Python (`triport-sdk`)

Python

import os
from triport import Triport


client = Triport(api_key=os.environ["TRIPORT_API_KEY"])


version = client.eth.web3_client_version()
print(version)  # e.g. "Geth/v1.14.0-stable/linux-amd64/go1.22.0"

Notes

No parameters and no required scope — this is the lightest Ethereum call and is well suited to liveness checks and CI smoke tests.
The version string is informational only; do not branch application logic on its contents.
Related: web3_sha3 (Keccak-256 hashing) and the net_* methods for network/peer status.

Request

cURLJavaScriptPython

curl https://api.triport.io/ \
  -H "Authorization: Bearer $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "web3_clientVersion",
    "params": []
  }'

const res = await fetch("https://api.triport.io/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer $TRIPORT_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "web3_clientVersion",
    "params": []
  }),
});
const data = await res.json();
console.log(data);

import requests


resp = requests.post(
    "https://api.triport.io/",
    headers={
        "Authorization": "Bearer $TRIPORT_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "web3_clientVersion",
        "params": [],
    },
)
data = resp.json()
print(data)

Response 200

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Geth/v1.14.0-stable/linux-amd64/go1.22.0"
}