API Overview

Triport is a single multi-chain RPC platform for every network in the registry — JSON-RPC, a REST product layer, and streaming where mounted, all behind one base URL and one API key.

Network
Any network in the registry
Authentication
x-token header (recommended); see Authentication for all forms
Tier / rate limit
Any tier (free 7-day trial works); see Rate Limits

What Triport is

Triport is a multi-chain RPC platform. You send standard requests to a single base URL; Triport authenticates your key, routes the request to the right network backend, enforces your tier's rate limits, and returns the upstream result unchanged. You integrate against one API surface instead of wiring up a separate provider per chain.

The generated registry summary below is authoritative.

Across the registered networks Triport exposes three kinds of surface:

SurfaceWhat it isTransport
JSON-RPCThe native node RPC for each chain (getBalance, eth_getBalance, bor_*, …), proxied verbatim.HTTP POST
REST productHigher-level, opinionated endpoints layered on top of the raw RPC: Solana wallet history, cross-chain wallet identity, research and watch, the Ethereum beacon and MEV routes, the Polygon Heimdall proxy.HTTP GET/POST
StreamingSubscription channels — JSON-RPC Pub/Sub, Solana gRPC (Yellowstone), the Solana shred stream and a high-throughput WebSocket bridge.gRPC / WSS

Base URLs

All requests go to a single base URL:

EnvironmentBase URL
Productionhttps://triport.io

Each network's canonical JSON-RPC endpoint is listed in the generated table below.

A minimal first request (Solana getBalance against production):

curl https://triport.io/sol \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBalance",
    "params": ["vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"]
  }'

If you have never called Triport before, start with Getting Started — it takes you from zero to a verified response in under five minutes.

Method types

Every reference page carries a Type field so you always know what you are calling — a chain method, a Triport add-on, or a Triport product surface:

TypeMeaning
Native upstream RPCA standard chain JSON-RPC method for any network in the registry. Triport authenticates, rate-limits, and routes it to an upstream node, then returns the upstream result unchanged.
Triport extensionA provider-specific method that is not part of the base chain RPC — e.g. Solana DAS (getAsset*, searchAssets, getTokenAccounts), getPriorityFeeEstimate, and bundle submission (sendBundle, Flashbots eth_sendBundle).
Triport product (REST API)A Triport-built REST surface under /v1/… (Solana wallet history, cross-chain wallet identity, research and watch) — indexed product endpoints, not raw chain RPC.

Console / dashboard-management endpoints are tagged Triport Console API.

For how a request actually flows end-to-end — edge, auth, routing, upstream node, response — and an honest account of what Triport operates versus routes to, see Architecture & trust model.

Authentication, briefly

Send your API key (it looks like tri_live_…). Triport accepts it in several forms, tried in this priority order:

  1. x-token: <key> header — preferred.
  2. Authorization: Bearer <key> header — standard Bearer scheme.
  3. ?api-key=<key> query parameter — legacy.
  4. Path form /<chain>/<key> — works only for tri_live_* API keys.

Full details and when to use each are on the Authentication page.

Rate limits, briefly

Triport rate-limits by sustained requests-per-second, scoped to your tier and the request's category, with a global burst multiplier of 2×. There is no daily quota — only the per-second budget. Tiers range from the free 7-day trial through basic, pro, business, and custom enterprise; higher tiers unlock more RPS and multi-region routing.

Rate-limit state is reported on responses via X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-RateLimit-Category. When you exceed your budget you get HTTP 429 with a Retry-After header. See Rate Limits for the per-tier numbers and burst behavior.

Errors, briefly

Every error comes back as a JSON envelope with a machine-readable error code, a human message, and a request_id for support. The codes you will see most:

HTTPerrorWhen it happens
401unauthorizedMissing or invalid key
401trial_expired / subscription_expiredTrial or subscription period ended
403tier_insufficientMethod requires a higher tier
403method_unknownMethod not part of that chain's product
429rate_limitedSustained RPS exceeded
400invalid_paramsMalformed request
500internal_errorServer-side failure

All of these are plain HTTP errors: the gate decides them before the request reaches the RPC layer, so there is no JSON-RPC error object to branch on — use the HTTP status and the error field. JSON-RPC error objects come from the upstream node (such as -32602 for invalid params). See the Errors page for the full envelope and typed error schemas.

Surface reference — where to go next

Guides

PageWhat it covers
Getting StartedGet a key and make your first call.
AuthenticationEvery supported auth form and when to use each.
Rate LimitsPer-tier RPS budgets, burst, and rate-limit headers.
ErrorsThe full error envelope and typed error schemas.

Solana

SurfaceReference
JSON-RPCSolana JSON-RPC
REST product (wallet history, transfers, identity)Solana REST
Pub/Sub WebSocket wss://triport.io/ws/sol (accountSubscribe, logsSubscribe, programSubscribe, …)Solana Pub/Sub WS
Firehose (WebSocket) wss://triport.io/ws/sol-stream — every non-vote transaction, no filters, ProSolana Firehose
gRPC (Yellowstone) https://grpc.triport.io — native gRPC with server-side filters, ProSolana gRPC (Yellowstone)
Shred stream wss://triport.io/ws/sol-preexec — pre-execution transactions, ProSolana Shred Stream

Ethereum

SurfaceReference
JSON-RPC (eth_*)Ethereum JSON-RPC
REST product (beacon proxy and events, MEV builder and private-transaction routes)Ethereum REST
Pub/Sub WebSocket (newHeads, logs, newPendingTransactions, syncing)Ethereum WS

Polygon

SurfaceReference
JSON-RPC (eth_* + bor_*)Polygon JSON-RPC
REST product (Heimdall consensus-layer proxy)Polygon REST
Pub/Sub WebSocket (newHeads, logs, newPendingTransactions, syncing)Polygon WS

Wallet Identity (cross-chain)

SurfaceReference
REST product — one profile per EVM address across every mounted network + Tron (names, balances, deployer, labels)Wallet Identity
Batch profiles with filters (up to 100/500 addresses per call)Batch · Filters
Event subscriptions — deployments, bridges, fresh wallets; webhook / WebSocket / REST cursorWallet watch

Available from the Business tier (wallet_identity category, 30 rps; Enterprise 150 rps).

Client libraries

Every surface is plain HTTP/WSS. Call it with curl, fetch, or any standard JSON-RPC or WebSocket client pointed at the endpoint, with your key in the x-token header. See Getting Started for copy-paste examples.

Notes

  • Every registered network shares one key, one error envelope, and one rate-limit model.
  • Raw JSON-RPC results are passed through unchanged from the upstream node, so existing chain tooling and method docs continue to apply.

9 networks are supported today: Solana, Ethereum, Polygon, BNB Smart Chain, Base, Tron, Robinhood Chain, Stellar, and TON.

IDNetworkchainIdJSON-RPC endpointRESTStreamsGuide
solSolana101https://triport.io/solyesyesGuide
ethEthereum1https://triport.io/ethyesyesGuide
polygonPolygon137https://triport.io/polygonyesyesGuide
bscBNB Smart Chain56https://triport.io/rpc/bsc——Guide
baseBase8453https://triport.io/r/{key}/rpc/base—yesGuide
tronTron728126428https://triport.io/rpc/tronyes—Guide
robinhoodRobinhood Chain4663https://triport.io/rpc/robinhood—yesGuide
stellarStellar102https://triport.io/rpc/stellaryesyesGuide
tonTON103https://triport.io/rpc/ton——Guide