---
title: "Networks"
description: "This guide explains how to retrieve and manage blockchain networks using the Fystack API."
url: https://docs.fystack.io/networks
last_updated: 2026-10-15
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.fystack.io/llms.txt
> Use it to discover all available pages before exploring further.

# Networks

Networks represent the blockchain networks supported by Fystack. You can retrieve information about available networks, including EVM and non-EVM chains, along with their configuration details and health status.

## Supported networks

The table below lists the mainnet networks currently supported by Fystack along with their `network_code` identifier. Use the `network_code` value when referencing a network in API requests, webhooks, or SDK calls.

| Network | Network code |
| --- | --- |
| Ethereum | `ETHEREUM_MAINNET` |
| Base | `BASE_MAINNET` |
| Solana | `SOL_MAINNET` |
| Polygon | `POLYGON_MAINNET` |
| BNB Smart Chain | `BSC_MAINNET` |
| Lisk | `LISK_MAINNET` |
| Bitcoin | `BTC_MAINNET` |
| Tron | `TRON_MAINNET` |

> **Info.** Need a network that is not listed here? Reach out to the Fystack team and we can prioritize adding it.

---

## Network information

Each network in Fystack contains comprehensive information about the blockchain:

### Network properties

- **Chain identification**: Unique chain ID and internal code for each network
- **Network type**: Support for both EVM and non-EVM networks
- **Native currency**: The native token for each network (e.g., ETH, SOL)
- **Block explorers**: Pre-configured explorer URLs for transactions, addresses, and tokens
- **Network status**: Real-time RPC health status and availability
- **Block configuration**: Confirmation requirements and block interval timing
- **Testnet support**: Clearly identified test networks for development

---

## Get networks

**Endpoint:** `GET /networks`

This endpoint allows you to retrieve available blockchain networks. This is a public endpoint that does not require authentication.

### Parameters

- `search` (string): Filter networks by name. For example, `?search=Base` will return networks matching "Base".

### Response

- `success` (boolean): Indicates whether the request was successful.
- `message` (string): A message describing the result of the operation.
- `code` (integer): A numeric code indicating the result status (0 for success).
- `data` (array): An array of network objects.
  - `id` (string): The UUID of the network.
  - `created_at` (string): Timestamp when the network was added to the system.
  - `updated_at` (string): Timestamp of the last network configuration update.
  - `name` (string): The display name of the network.
  - `description` (string): A brief description of the network.
  - `is_evm` (boolean): Whether this is an Ethereum Virtual Machine compatible network.
  - `chain_id` (integer): The unique chain identifier for the network.
  - `native_currency` (string): The symbol of the network's native currency.
  - `is_testnet` (boolean): Whether this is a test network.
  - `internal_code` (string): Internal identifier code for the network.
  - `explorer_tx` (string): URL template for transaction explorer links. Use `%s` as placeholder for transaction hash.
  - `explorer_address` (string): URL template for address explorer links. Use `%s` as placeholder for address.
  - `explorer_token` (string): URL template for token explorer links. Use `%s` as placeholder for token address.
  - `confirmation_blocks` (integer): Number of block confirmations required to consider a transaction final.
  - `block_interval_in_seconds` (integer): Average time between blocks in seconds.
  - `disabled` (boolean): Whether the network is currently disabled.
  - `logo_url` (string): URL to the network's logo image.
  - `is_rpc_active` (boolean): Whether the RPC endpoint is currently active.
  - `rpc_health_status` (string): Current health status of the RPC endpoint. Can be `healthy`, `degraded`, or `null`.
  - `pending_block_count` (integer): Number of pending blocks being processed.

> **Info.** This endpoint is public and does not require authentication. You can use it to retrieve network information without API credentials.

**Request** `GET /networks`

```bash
curl -X GET https://api.fystack.io/api/v1/networks
```

```bash
curl -X GET "https://api.fystack.io/api/v1/networks?search=Base"
```

```json
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": [
    {
      "id": "23d13c03-1f3c-4e2a-9aef-1771a244b7f6",
      "created_at": "2024-01-05T09:05:25.629202+07:00",
      "updated_at": "2025-07-18T12:34:07.91766+07:00",
      "name": "Sepolia Ethereum Testnet",
      "description": "Sepolia testnet",
      "is_evm": true,
      "chain_id": 11155111,
      "native_currency": "ETH",
      "is_testnet": true,
      "internal_code": "ETHER_SEPOLIA_TESTNET",
      "explorer_tx": "https://sepolia.etherscan.io/tx/%s",
      "explorer_address": "https://sepolia.etherscan.io/address/%s",
      "explorer_token": "https://sepolia.etherscan.io/token/%s",
      "confirmation_blocks": 1,
      "block_interval_in_seconds": 15,
      "disabled": false,
      "logo_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR-lzp6jMVVHdxHiK4q5Xy2FbJIrC-GPmTREA&s",
      "is_rpc_active": true,
      "rpc_health_status": "healthy",
      "pending_block_count": 8
    },
    {
      "id": "f8d7d8b9-3466-405c-a8c9-542366f95f39",
      "created_at": "2025-03-01T22:21:44.604716+07:00",
      "updated_at": "2025-08-03T21:47:21.917315+07:00",
      "name": "Base mainnet",
      "description": "Base mainnets",
      "is_evm": true,
      "chain_id": 8453,
      "native_currency": "ETH",
      "internal_code": "BASE_MAINNET",
      "explorer_tx": "https://basescan.org/tx/%s",
      "explorer_address": "https://basescan.org/address/%s",
      "explorer_token": "https://basescan.org/token/%s",
      "confirmation_blocks": 20,
      "block_interval_in_seconds": 2,
      "disabled": false,
      "logo_url": "https://avatars.githubusercontent.com/u/108554348?v=4",
      "is_rpc_active": false,
      "rpc_health_status": null,
      "pending_block_count": 25438
    }
  ]
}
```

---

## Rescan transaction

**Endpoint:** `POST /networks/rescan-transaction`

This endpoint allows you to manually trigger a rescan of a specific transaction on a network. This is useful for cases where a transaction is not indexed after a certain time due to RPC outages. You can manually trigger a rescan so the system can index the transaction.

> **Warning.** This endpoint requires a user access token and system admin permissions.

### Parameters

- `tx_hash` (string, required): The transaction hash to rescan.
- `network_id` (string, required): The UUID of the network where the transaction occurred.

### Response

- `success` (boolean): Indicates whether the rescan request was successful.
- `message` (string): A message describing the result of the operation.
- `code` (integer): A numeric code indicating the result status (0 for success).

**Request** `POST /networks/rescan-transaction`

```typescript
import { FystackSDK, Environment } from "@fystack/sdk"

const apiCredentials = {
  apiKey: process.env.API_KEY,
  apiSecret: process.env.API_SECRET
}

const sdk = new FystackSDK({
  credentials: apiCredentials,
  environment: Environment.Sandbox,
  logger: true
})

await sdk.rescanTransaction({
  txHash: 'a6ec569aa7db70433e9012eb456cd24156d33c1748825f0d868d2d4e2595cb06',
  networkId: 'c5725221-fa98-4d6c-a6ca-8c5cd65cd884'
})
```

```bash
curl -X POST https://api.fystack.io/api/v1/networks/rescan-transaction \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "tx_hash": "a6ec569aa7db70433e9012eb456cd24156d33c1748825f0d868d2d4e2595cb06",
    "network_id": "c5725221-fa98-4d6c-a6ca-8c5cd65cd884"
  }'
```

```json
{
  "success": true,
  "message": "success",
  "code": 0,
  "data": {
    "message": "Transaction block added to rescan queue successfully"
  }
}
```