Parafi Solana API
ParaFi validator, rewards, stake, and Solana network endpoints.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/parafi-solana-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.0.3
info:
title: ParaFi Tech Avalanche Solana API
version: 1.1.0
description: Public read-only API for ParaFi validator data, Solana rewards and network metrics, Ethereum network stats, Avalanche validator data, and market prices. Designed for dashboards, agents, and programmatic integrations.
termsOfService: https://parafi.tech/terms
contact:
name: ParaFi Tech
url: https://parafi.tech
email: info@parafi.tech
license:
name: MIT
servers:
- url: https://parafi.tech
description: Production
- url: http://localhost:3000
description: Local development
tags:
- name: Solana
description: ParaFi validator, rewards, stake, and Solana network endpoints.
paths:
/api/solana/validator-apy:
get:
tags:
- Solana
summary: Get validator APY/APR with MEV contribution and status
operationId: getSolanaValidatorApy
parameters:
- name: epoch
in: query
required: false
schema:
type: integer
minimum: 0
description: 'Override epoch for calculation (default: current)'
- name: force
in: query
required: false
schema:
type: boolean
default: false
description: Bypass cache if true
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/APYData'
'500':
description: Failed to fetch APY data
/api/solana/network-validators:
get:
tags:
- Solana
summary: Network-wide validator counts and RPC nodes
operationId: getSolanaNetworkValidators
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
description: Bypass cache if true
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/NetworkValidatorsData'
'500':
description: Failed to fetch validator data
/api/solana/supply:
get:
tags:
- Solana
summary: Solana supply metrics
operationId: getSolanaSupply
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
description: Bypass cache if true
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/NetworkSupplyData'
'500':
description: Failed to fetch supply data
/api/solana/simple-rewards/epoch/{epochNumber}:
get:
tags:
- Solana
summary: Delegator rewards for an epoch (supports 'current')
operationId: getSolanaSimpleRewardsByEpoch
parameters:
- name: epochNumber
in: path
required: true
schema:
type: string
pattern: ^(\d+|current)$
description: Epoch number or 'current'
- name: page
in: query
schema:
type: integer
minimum: 1
maximum: 1000
default: 1
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 500
default: 100
- name: sortBy
in: query
schema:
type: string
enum:
- rewards
- staker
- validator
- stake
- stakeAmount
default: rewards
- name: sortOrder
in: query
schema:
type: string
enum:
- asc
- desc
default: desc
- name: minReward
in: query
schema:
type: number
- name: maxReward
in: query
schema:
type: number
- name: validatorVoteAccount
in: query
schema:
type: string
description: Solana vote account public key
- name: includeInactive
in: query
schema:
type: boolean
default: false
- name: force
in: query
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleRewardsEpochResponse'
'400':
description: Validation error
'500':
description: Internal server error
/api/solana/network-apy:
get:
tags:
- Solana
summary: Network-wide average APY across all validators
operationId: getSolanaNetworkApy
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/NetworkAPYData'
examples:
example:
value:
apy: 7.45
inflationAPY: 6.8
mevAPY: 0.65
averageCommission: 7.2
stakingRatio: 65.4
lastUpdated: '2025-01-28T12:00:00.000Z'
cacheSource: redis
'500':
description: Failed to fetch network APY
/api/solana/validator-active-stake:
get:
tags:
- Solana
summary: Validator active stake, commission, vote status
operationId: getSolanaValidatorActiveStake
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ActiveStakeData'
examples:
example:
value:
activeStake: 5200000000000
activeStakeInSol: 5200.0
commission: 0
lastVote: 312000000
epochVoteAccount: true
delinquent: false
lastUpdated: '2025-01-28T12:00:00.000Z'
cacheSource: redis
'500':
description: Failed to fetch active stake
/api/solana/validator-stake:
get:
tags:
- Solana
summary: Total stake breakdown with delegator counts
operationId: getSolanaValidatorStake
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/TotalStakeData'
examples:
example:
value:
totalStake: 5500000000000
totalStakeInSol: 5500.0
totalStakeAccounts: 150
activeStakeAccounts: 145
delegatorCount: 120
activeStake: 5200000000000
inactiveStake: 300000000000
lastUpdated: '2025-01-28T12:00:00.000Z'
cacheSource: redis
'500':
description: Failed to fetch stake data
/api/solana/validator-delegators:
get:
tags:
- Solana
summary: List all delegators with stake amounts
operationId: getSolanaValidatorDelegators
description: Returns the current stake-account level delegator list for the ParaFi validator, along with aggregate totals such as active stake accounts and delegator count.
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/DelegatorsData'
examples:
example:
value:
delegators:
- stakeAccount: ExampleStakeAccount111111111111111111111111111
stakerAuthority: ExampleStaker1111111111111111111111111111111111
activeStake: '125000000000'
totalStake: 5500000000000
totalStakeInSol: 5500
totalStakeAccounts: 150
activeStakeAccounts: 145
delegatorCount: 120
lastUpdated: '2025-01-28T12:00:00.000Z'
cacheSource: redis
'500':
description: Failed to fetch delegator data
/api/solana/rewards/staker/{address}:
get:
tags:
- Solana
summary: Reward history for a specific staker address
operationId: getSolanaStakerRewards
description: Use this route to retrieve reward history and summary information for a wallet or staker authority across epochs.
parameters:
- name: address
in: path
required: true
schema:
type: string
description: Staker wallet address
- name: page
in: query
schema:
type: integer
minimum: 1
default: 1
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 500
default: 100
- name: startEpoch
in: query
schema:
type: integer
- name: endEpoch
in: query
schema:
type: integer
- name: stakeAccount
in: query
schema:
type: string
description: Filter by specific stake account
- name: force
in: query
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
stakerProfile:
type: object
rewards:
type: array
items:
type: object
summary:
type: object
examples:
example:
value:
stakerProfile:
address: ExampleStaker1111111111111111111111111111111111
rewards:
- epoch: 750
stakeAccount: ExampleStakeAccount111111111111111111111111111
totalRewardsActual: '123456789'
summary:
totalRewards: '123456789'
epochsTracked: 1
'400':
description: Invalid address
'500':
description: Internal server error
/api/solana/rewards/validator/{voteAccount}:
get:
tags:
- Solana
summary: Reward distribution for all delegators of a validator
operationId: getSolanaValidatorRewards
parameters:
- name: voteAccount
in: path
required: true
schema:
type: string
description: Validator vote account address
- name: page
in: query
schema:
type: integer
minimum: 1
default: 1
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 500
default: 100
- name: startEpoch
in: query
schema:
type: integer
- name: endEpoch
in: query
schema:
type: integer
- name: force
in: query
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
validatorInfo:
type: object
rewardsDistribution:
type: array
items:
type: object
performanceMetrics:
type: object
summary:
type: object
'400':
description: Invalid vote account
'500':
description: Internal server error
/api/solana/rewards/epoch/{epochNumber}:
get:
tags:
- Solana
summary: All delegator rewards for a specific epoch
operationId: getSolanaEpochRewards
parameters:
- name: epochNumber
in: path
required: true
schema:
type: string
pattern: ^(\d+|current)$
description: Epoch number or 'current'
- name: page
in: query
schema:
type: integer
minimum: 1
default: 1
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 500
default: 100
- name: sortBy
in: query
schema:
type: string
enum:
- rewards
- staker
- validator
- stake
- stakeAmount
default: rewards
- name: sortOrder
in: query
schema:
type: string
enum:
- asc
- desc
default: desc
- name: validatorVoteAccount
in: query
schema:
type: string
description: Filter by validator
- name: includeInactive
in: query
schema:
type: boolean
default: false
- name: force
in: query
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/SimpleRewardsEpochResponse'
'400':
description: Validation error
'500':
description: Internal server error
/api/solana/mev-rewards:
get:
tags:
- Solana
summary: MEV rewards from Jito for a range of epochs
operationId: getSolanaMevRewards
parameters:
- name: startEpoch
in: query
required: true
schema:
type: integer
- name: endEpoch
in: query
required: true
schema:
type: integer
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
epochs:
type: array
items:
type: object
rewards:
type: object
metadata:
type: object
'400':
description: Missing startEpoch or endEpoch
'500':
description: Internal server error
/api/solana/compute-units:
get:
tags:
- Solana
summary: Current block compute units utilization
operationId: getSolanaComputeUnits
parameters:
- name: slot
in: query
required: false
schema:
type: integer
description: 'Specific slot (default: latest)'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ComputeUnitsData'
examples:
example:
value:
slot: 312000000
computeUnitsConsumed: 35000000
computeUnitsTotal: 48000000
utilizationPercentage: 72.9
timestamp: '2025-01-28T12:00:00.000Z'
'500':
description: Failed to fetch compute units
/api/solana/compute-units/history:
get:
tags:
- Solana
summary: Historical compute units utilization time series
operationId: getSolanaComputeUnitsHistory
parameters:
- name: interval
in: query
schema:
type: integer
enum:
- 1
- 5
- 15
- 60
description: Rollup interval in minutes
- name: window
in: query
schema:
type: integer
maximum: 1440
description: Number of data points
responses:
'200':
description: Array of [timestamp, utilization] tuples
content:
application/json:
schema:
type: array
items:
type: array
items:
type: number
minItems: 2
maxItems: 2
/api/solana/leader-slots:
get:
tags:
- Solana
summary: Leader slot statistics (blocks produced, missed, skip rate)
operationId: getSolanaLeaderSlots
parameters:
- name: epoch
in: query
required: false
schema:
type: integer
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/LeaderSlotsData'
examples:
example:
value:
totalLeaderSlots: 48
blocksProduced: 47
blocksMissed: 1
skipRate: 2.08
epoch: 750
lastUpdated: '2025-01-28T12:00:00.000Z'
/api/solana/sidecar-stats:
get:
tags:
- Solana
summary: Real-time network performance (TPS, block time, compute units)
operationId: getSolanaSidecarStats
parameters:
- name: count
in: query
schema:
type: integer
minimum: 1
maximum: 200
description: Number of data points
- name: smooth
in: query
schema:
type: integer
minimum: 1
maximum: 25
description: Smoothing window
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
series:
type: array
items:
type: object
latest:
type: object
cacheSource:
type: string
/api/solana/network-stats/history:
get:
tags:
- Solana
summary: Historical network performance (TPS, block time, compute utilization)
operationId: getSolanaNetworkStatsHistory
parameters:
- name: granularity
in: query
schema:
type: string
enum:
- hourly
- daily
- name: days
in: query
schema:
type: integer
maximum: 365
- name: hours
in: query
schema:
type: integer
maximum: 168
- name: startDate
in: query
schema:
type: string
format: date-time
- name: endDate
in: query
schema:
type: string
format: date-time
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
granularity:
type: string
startDate:
type: string
endDate:
type: string
count:
type: integer
data:
type: array
items:
type: object
/api/solana/delegators:
get:
tags:
- Solana
summary: All delegators with stake amounts and account details
operationId: getSolanaDelegators
parameters:
- name: force
in: query
required: false
schema:
type: boolean
default: false
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/DelegatorsData'
'500':
description: Failed to fetch delegators
components:
schemas:
LeaderSlotsData:
type: object
properties:
totalLeaderSlots:
type: integer
blocksProduced:
type: integer
blocksMissed:
type: integer
skipRate:
type: number
epoch:
type: integer
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
required:
- totalLeaderSlots
- blocksProduced
- blocksMissed
- skipRate
- epoch
NetworkSupplyData:
type: object
properties:
circulating:
type: integer
description: Lamports
nonCirculating:
type: integer
description: Lamports
total:
type: integer
description: Lamports
circulatingSOL:
type: number
nonCirculatingSOL:
type: number
totalSOL:
type: number
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- circulating
- nonCirculating
- total
- circulatingSOL
- nonCirculatingSOL
- totalSOL
- lastUpdated
SimpleRewardsEpochResponse:
type: object
properties:
epochInfo:
type: object
properties:
epoch:
type: integer
totalParticipants:
type: integer
totalRewardsDistributed:
type: string
totalStakeActive:
type: string
averageRewardPerParticipant:
type: string
uniqueValidators:
type: integer
uniqueStakers:
type: integer
rewardConsistency:
type: integer
rewardsData:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/RewardEntry'
pagination:
$ref: '#/components/schemas/Pagination'
statistics:
type: object
properties:
totalRewards:
type: string
totalStake:
type: string
averageReward:
type: string
medianReward:
type: string
rewardDistribution:
type: array
items:
type: number
topStakers:
type: array
items:
type: object
topValidators:
type: array
items:
type: object
dataQuality:
type: object
properties:
totalSnapshots:
type: integer
completeData:
type: integer
preliminaryData:
type: integer
dataCompletenessPercentage:
type: integer
mevDataTiming:
type: object
properties:
percentageWithMev:
type: integer
recordsWithMev:
type: integer
pendingMevRecords:
type: integer
estimatedNextMevUpdate:
type: string
format: date-time
validationAccuracy:
type: integer
summary:
type: object
properties:
calculationMethod:
type: string
enum:
- balance_difference
cacheSource:
type: string
enum:
- fresh
- redis
lastUpdated:
type: string
format: date-time
ActiveStakeData:
type: object
properties:
activeStake:
type: integer
description: Lamports
activeStakeInSol:
type: number
commission:
type: integer
lastVote:
type: integer
epochVoteAccount:
type: boolean
delinquent:
type: boolean
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- activeStake
- activeStakeInSol
- commission
- lastVote
- epochVoteAccount
- delinquent
- lastUpdated
NetworkValidatorsData:
type: object
properties:
activeValidators:
type: integer
totalValidators:
type: integer
delinquentValidators:
type: integer
activePercentage:
type: number
rpcNodes:
type: integer
totalNodes:
type: integer
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- activeValidators
- totalValidators
- delinquentValidators
- activePercentage
- rpcNodes
- totalNodes
- lastUpdated
TotalStakeData:
type: object
properties:
totalStake:
type: integer
description: Lamports
totalStakeInSol:
type: number
totalStakeAccounts:
type: integer
activeStakeAccounts:
type: integer
delegatorCount:
type: integer
activeStake:
type: integer
inactiveStake:
type: integer
delegatedStake:
type: integer
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- totalStake
- totalStakeInSol
- totalStakeAccounts
- activeStakeAccounts
- delegatorCount
- lastUpdated
APYData:
type: object
properties:
apy:
type: number
apr:
type: number
epoch:
type: integer
hasMevData:
type: boolean
inflationRewards:
type: number
mevRewards:
type: number
totalRewards:
type: number
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
dataSource:
type: string
enum:
- calculated
- estimated
mevDataAge:
type: string
enum:
- current
- previous
- fallback
required:
- apy
- apr
- epoch
- hasMevData
- inflationRewards
- mevRewards
- totalRewards
- lastUpdated
- dataSource
DelegatorsData:
type: object
properties:
delegators:
type: array
items:
type: object
totalStake:
type: integer
totalStakeInSol:
type: number
totalStakeAccounts:
type: integer
activeStakeAccounts:
type: integer
delegatorCount:
type: integer
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- delegators
- totalStake
- delegatorCount
- lastUpdated
Pagination:
type: object
properties:
page:
type: integer
limit:
type: integer
totalPages:
type: integer
totalCount:
type: integer
hasNext:
type: boolean
hasPrev:
type: boolean
ComputeUnitsData:
type: object
properties:
slot:
type: integer
computeUnitsConsumed:
type: integer
computeUnitsTotal:
type: integer
utilizationPercentage:
type: number
timestamp:
type: string
format: date-time
required:
- slot
- computeUnitsConsumed
- computeUnitsTotal
- utilizationPercentage
RewardEntry:
type: object
properties:
stakeAccount:
type: string
stakerAuthority:
type: string
validatorVoteAccount:
type: string
totalRewardsActual:
type: string
inflationRewards:
type: string
nullable: true
mevRewards:
type: string
nullable: true
mevAvailabilityStatus:
type: string
enum:
- available
- pending
dataCompleteness:
type: string
dataStatus:
type: object
properties:
balanceDataComplete:
type: boolean
inflationDataComplete:
type: boolean
mevDataComplete:
type: boolean
validation:
type: object
properties:
balanceMatchesRPC:
type: boolean
calculationAccuracy:
type: string
confidenceScore:
type: integer
dataFreshnessScore:
type: integer
activeStake:
type: string
delegatedStake:
type: string
activationEpoch:
type: integer
deactivationEpoch:
type: integer
nullable: true
calculationMethod:
type: string
enum:
- balance_difference
NetworkAPYData:
type: object
properties:
apy:
type: number
inflationAPY:
type: number
mevAPY:
type: number
averageCommission:
type: number
stakingRatio:
type: number
lastUpdated:
type: string
format: date-time
cacheSource:
type: string
enum:
- redis
- fresh
isStale:
type: boolean
required:
- apy
- inflationAPY
- mevAPY
- averageCommission
- stakingRatio
- lastUpdated
externalDocs:
description: Agent guide and integration entrypoints
url: https://parafi.tech/skill.md