# Networks

Blockchain network endpoints

## List supported networks

> Returns a minimal summary of all supported networks (id, code, name, native symbol, PoS flag, and status).

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Networks","description":"Blockchain network endpoints"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"NetworkMinimal":{"type":"object","required":["id","code","name","nativeSymbol","isPos","status"],"properties":{"id":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"nativeSymbol":{"type":"string"},"isPos":{"type":"boolean"},"status":{"type":"string","enum":["Stable","High Load","Low Load","Unstable"]}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/networks":{"get":{"tags":["Networks"],"summary":"List supported networks","description":"Returns a minimal summary of all supported networks (id, code, name, native symbol, PoS flag, and status).","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NetworkMinimal"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```

## Get single network

> Returns the same minimal summary as \`/networks\`, but for a single network identified by its code.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Networks","description":"Blockchain network endpoints"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"NetworkMinimal":{"type":"object","required":["id","code","name","nativeSymbol","isPos","status"],"properties":{"id":{"type":"integer"},"code":{"type":"string"},"name":{"type":"string"},"nativeSymbol":{"type":"string"},"isPos":{"type":"boolean"},"status":{"type":"string","enum":["Stable","High Load","Low Load","Unstable"]}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Route not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/networks/{code}":{"get":{"tags":["Networks"],"summary":"Get single network","description":"Returns the same minimal summary as `/networks`, but for a single network identified by its code.","parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"},"description":"Network code (e.g., ETH, SOL, DOT)"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkMinimal"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```

## Get network KPI

> Returns core infrastructure metrics for a single network — active nodes, validators, total blocks, and last update time.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Networks","description":"Blockchain network endpoints"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"NetworkKpi":{"type":"object","required":["activeNodes","activeValidators","totalBlocks","updatedAt"],"properties":{"activeNodes":{"type":"integer"},"activeValidators":{"type":"integer"},"totalBlocks":{"type":"integer"},"updatedAt":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Route not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/networks/{code}/kpi":{"get":{"tags":["Networks"],"summary":"Get network KPI","description":"Returns core infrastructure metrics for a single network — active nodes, validators, total blocks, and last update time.","parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"},"description":"Network code (e.g., ETH, SOL, DOT, ...)"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkKpi"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```

## Get network performance

> Returns performance metrics for a single network — TPS, fees, block time, status, and last update time.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Networks","description":"Blockchain network endpoints"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"NetworkPerformance":{"type":"object","required":["tps","avgFeeNative","avgFeeUsd","blockTimeS","status","updatedAt"],"properties":{"tps":{"type":"string"},"avgFeeNative":{"type":"string"},"avgFeeUsd":{"type":"string"},"blockTimeS":{"type":"string"},"status":{"type":"string","enum":["Stable","High Load","Low Load","Unstable"]},"updatedAt":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Route not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/networks/{code}/performance":{"get":{"tags":["Networks"],"summary":"Get network performance","description":"Returns performance metrics for a single network — TPS, fees, block time, status, and last update time.","parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"},"description":"Network code (e.g., ETH, SOL, DOT, ...)"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkPerformance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```

## Get network APR and staking data

> Returns economic metrics for a single network — validator APR, staking ratios, TVL, total supply, and last update time.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Networks","description":"Blockchain network endpoints"}],"servers":[{"url":"https://api.fortisx.fi/v1","description":"Demo host (replace with your own in production)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"schemas":{"NetworkApr":{"type":"object","required":["validatorApr","stakingRatio","stakingTvlNative","stakingTvlUsd","totalSupplyNative","totalSupplyUsd","source","updatedAt"],"properties":{"validatorApr":{"type":"string"},"stakingRatio":{"type":"string"},"stakingTvlNative":{"type":"string"},"stakingTvlUsd":{"type":"string"},"totalSupplyNative":{"type":"string"},"totalSupplyUsd":{"type":"string"},"source":{"type":"string"},"updatedAt":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Route not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalServerError":{"description":"Unexpected server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Service temporarily unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/networks/{code}/apr":{"get":{"tags":["Networks"],"summary":"Get network APR and staking data","description":"Returns economic metrics for a single network — validator APR, staking ratios, TVL, total supply, and last update time.","parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"},"description":"Network code (e.g., ETH, SOL, DOT, ...)"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NetworkApr"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```
