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.

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

Get networks

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

Optional parameters

Name
search
Type
string
Description
Filter networks by name. For example, ?search=Base will return networks matching "Base".

Response

Name
success
Type
boolean
Description
Indicates whether the request was successful.
Name
message
Type
string
Description
A message describing the result of the operation.
Name
code
Type
integer
Description
A numeric code indicating the result status (0 for success).
Name
data
Type
array
Description
An array of network objects.

Name: id
Type: string
Description: The UUID of the network.

Name: created_at
Type: string
Description: Timestamp when the network was added to the system.

Name: updated_at
Type: string
Description: Timestamp of the last network configuration update.

Name: name
Type: string
Description: The display name of the network.

Name: description
Type: string
Description: A brief description of the network.

Name: is_evm
Type: boolean
Description: Whether this is an Ethereum Virtual Machine compatible network.

Name: chain_id
Type: integer
Description: The unique chain identifier for the network.

Name: native_currency
Type: string
Description: The symbol of the network's native currency.

Name: is_testnet
Type: boolean
Description: Whether this is a test network.

Name: internal_code
Type: string
Description: Internal identifier code for the network.

Name: explorer_tx
Type: string
Description: URL template for transaction explorer links. Use %s as placeholder for transaction hash.

Name: explorer_address
Type: string
Description: URL template for address explorer links. Use %s as placeholder for address.

Name: explorer_token
Type: string
Description: URL template for token explorer links. Use %s as placeholder for token address.

Name: confirmation_blocks
Type: integer
Description: Number of block confirmations required to consider a transaction final.

Name: block_interval_in_seconds
Type: integer
Description: Average time between blocks in seconds.

Name: disabled
Type: boolean
Description: Whether the network is currently disabled.

Name: logo_url
Type: string
Description: URL to the network's logo image.

Name: is_rpc_active
Type: boolean
Description: Whether the RPC endpoint is currently active.

Name: rpc_health_status
Type: string
Description: Current health status of the RPC endpoint. Can be healthy, degraded, or null.

Name: pending_block_range_count
Type: integer
Description: Number of pending block ranges being processed.

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

Request

GET

/networks

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

Response

{
  "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_range_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_range_count": 25438
    }
  ]
}

POST/networks/rescan-transaction

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.

This endpoint requires authentication. You must include valid API credentials in the request headers.

Required parameters

Name
tx_hash
Type
string
Description
The transaction hash to rescan.
Name
network_id
Type
string
Description
The UUID of the network where the transaction occurred.

Response

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

Request

POST

/networks/rescan-transaction

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'
})

Response

{
  "success": true,
  "message": "Transaction rescan initiated successfully",
  "code": 0
}