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-tokenheader (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:
| Surface | What it is | Transport |
|---|---|---|
| JSON-RPC | The native node RPC for each chain (getBalance, eth_getBalance, bor_*, …), proxied verbatim. | HTTP POST |
| REST product | Higher-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 |
| Streaming | Subscription 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:
| Environment | Base URL |
|---|---|
| Production | https://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:
| Type | Meaning |
|---|---|
| Native upstream RPC | A 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 extension | A 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:
x-token: <key>header — preferred.Authorization: Bearer <key>header — standard Bearer scheme.?api-key=<key>query parameter — legacy.- Path form
/<chain>/<key>— works only fortri_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:
| HTTP | error | When it happens |
|---|---|---|
| 401 | unauthorized | Missing or invalid key |
| 401 | trial_expired / subscription_expired | Trial or subscription period ended |
| 403 | tier_insufficient | Method requires a higher tier |
| 403 | method_unknown | Method not part of that chain's product |
| 429 | rate_limited | Sustained RPS exceeded |
| 400 | invalid_params | Malformed request |
| 500 | internal_error | Server-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
| Page | What it covers |
|---|---|
| Getting Started | Get a key and make your first call. |
| Authentication | Every supported auth form and when to use each. |
| Rate Limits | Per-tier RPS budgets, burst, and rate-limit headers. |
| Errors | The full error envelope and typed error schemas. |
Solana
| Surface | Reference |
|---|---|
| JSON-RPC | Solana 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, Pro | Solana Firehose |
gRPC (Yellowstone) https://grpc.triport.io — native gRPC with server-side filters, Pro | Solana gRPC (Yellowstone) |
Shred stream wss://triport.io/ws/sol-preexec — pre-execution transactions, Pro | Solana Shred Stream |
Ethereum
| Surface | Reference |
|---|---|
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
| Surface | Reference |
|---|---|
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)
| Surface | Reference |
|---|---|
| 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 cursor | Wallet 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.
| ID | Network | chainId | JSON-RPC endpoint | REST | Streams | Guide |
|---|---|---|---|---|---|---|
sol | Solana | 101 | https://triport.io/sol | yes | yes | Guide |
eth | Ethereum | 1 | https://triport.io/eth | yes | yes | Guide |
polygon | Polygon | 137 | https://triport.io/polygon | yes | yes | Guide |
bsc | BNB Smart Chain | 56 | https://triport.io/rpc/bsc | — | — | Guide |
base | Base | 8453 | https://triport.io/r/{key}/rpc/base | — | yes | Guide |
tron | Tron | 728126428 | https://triport.io/rpc/tron | yes | — | Guide |
robinhood | Robinhood Chain | 4663 | https://triport.io/rpc/robinhood | — | yes | Guide |
stellar | Stellar | 102 | https://triport.io/rpc/stellar | yes | yes | Guide |
ton | TON | 103 | https://triport.io/rpc/ton | — | — | Guide |