# Pools

Staking pools and validators data

## List staking pools

> Returns a paginated list of staking pools with filtering and sorting options.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Pools","description":"Staking pools and validators data"}],"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":{"PoolsResponse":{"type":"object","required":["total","limit","offset","items"],"properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Pool"}}}},"Pool":{"type":"object","required":["id","networkCode","providerSlug","name","aprPct","feePct","verified","updatedAt"],"properties":{"id":{"type":"integer"},"networkCode":{"type":"string"},"providerSlug":{"type":"string"},"name":{"type":"string"},"avatarUrl":{"type":"string"},"stakeNative":{"type":"string"},"stakeUsd":{"type":"string"},"shareRatio":{"type":"string"},"aprPct":{"type":"string"},"feePct":{"type":"string"},"verified":{"type":"boolean"},"tvlUpdatedAt":{"type":"string"},"aprUpdatedAt":{"type":"string"},"feeUpdatedAt":{"type":"string"},"lastSeenAt":{"type":"string"},"updatedAt":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"BadRequestInvalidParam":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"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":{"/pools":{"get":{"tags":["Pools"],"summary":"List staking pools","description":"Returns a paginated list of staking pools with filtering and sorting options.","parameters":[{"in":"query","name":"network","schema":{"type":"string"},"description":"Filter by network code (e.g., SOL)"},{"in":"query","name":"providerSlug","schema":{"type":"string"},"description":"Filter by provider slug"},{"in":"query","name":"name","schema":{"type":"string"},"description":"Filter by pool name (case-insensitive substring match)"},{"in":"query","name":"sortBy","schema":{"type":"string","enum":["aprPct","stakeUsd","shareRatio","feePct"],"default":"aprPct"},"description":"Field to sort by"},{"in":"query","name":"sortDir","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"description":"Sort direction"},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Number of records to return"},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"Number of records to skip"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolsResponse"}}}},"400":{"$ref":"#/components/responses/BadRequestInvalidParam"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```

## Get staking pool by ID

> Returns detailed information about a single staking pool.

```json
{"openapi":"3.0.3","info":{"title":"Fortisx Public API","version":"1.0.0"},"tags":[{"name":"Pools","description":"Staking pools and validators data"}],"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":{"PoolDetailed":{"allOf":[{"$ref":"#/components/schemas/Pool"},{"type":"object","properties":{"description":{"type":"string"},"website":{"type":"string"},"delegatorsCount":{"type":"integer"}}}]},"Pool":{"type":"object","required":["id","networkCode","providerSlug","name","aprPct","feePct","verified","updatedAt"],"properties":{"id":{"type":"integer"},"networkCode":{"type":"string"},"providerSlug":{"type":"string"},"name":{"type":"string"},"avatarUrl":{"type":"string"},"stakeNative":{"type":"string"},"stakeUsd":{"type":"string"},"shareRatio":{"type":"string"},"aprPct":{"type":"string"},"feePct":{"type":"string"},"verified":{"type":"boolean"},"tvlUpdatedAt":{"type":"string"},"aprUpdatedAt":{"type":"string"},"feeUpdatedAt":{"type":"string"},"lastSeenAt":{"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":{"/pools/{id}":{"get":{"tags":["Pools"],"summary":"Get staking pool by ID","description":"Returns detailed information about a single staking pool.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"},"description":"Pool ID"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PoolDetailed"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```