Beta

Flow Staking API

by Find Labs 1Supported chain 15 REST Paths 2Plans

Starting at $49.00

Get Started

1Supported chain 15REST Paths 2Plans

Starting at $49.00

Get Started

Back to Marketplace

This add-on is currently in Beta

Feel free to test it, we would appreciate feedback to address any errors that may occur

Supported Chains

Published on Sep 4, 2025

Support Website Support Email

Gain access to real-time data on all staking activity on the Flow blockchain.

Get access to real-time data on all staking activity on the Flow blockchain.

With the Flow Staking API you can access:

Account token transfers
Account transactions
Delegator information
Epoch statistics
Epoch nodes
Role-based node aggregates
Role-based node counts
Role-based node groupings
Token transfers by address
Node events
Paid rewards
Staking rewards
Tokenomics data
Transactions by address

REST Paths

Download OpenAPI Spec

GET /staking/v1/account/{address}/ft/transfer

Documentation

Fetches all fungible token transfers for a specific account address

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/ft/transfer \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/ft/transfer",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/ft/transfer")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/account/{address}/transaction

Retrieves account transactions for a specific address.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/transaction \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/transaction",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/account/0x097bafa4e0b48eef/transaction")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/delegator

The query will return results that match either the node_id or the delegator_ids.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/delegator \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/delegator",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/delegator")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/epoch/stats

This endpoint provides statistical information for each epoch, including APY rates, staking totals, and validator counts.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/stats \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/stats",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/stats")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/epoch/{epoch}/nodes

This endpoint retrieves detailed information on nodes active within a specified epoch, including staking details and node metadata.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/nodes \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/nodes",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/nodes")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/epoch/{epoch}/role/{role}/nodes/aggregate

Retrieves aggregated node counts grouped by epoch and role, with optional filters.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/aggregate \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/aggregate",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/aggregate")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/epoch/{epoch}/role/{role}/nodes/count

Retrieves the count of nodes in the specified epoch and role, optionally filtered by address part.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/count \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/count",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/count")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/epoch/{epoch}/role/{role}/nodes/grouped

Retrieves node counts grouped by organization for the specified epoch and role.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/grouped \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/grouped",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/epoch/189/role/verification/nodes/grouped")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/ft_transfer/{address}

Retrieve fungible token transfers within a specified date range, filtered by address.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/ft_transfer/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/ft_transfer/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/ft_transfer/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/node/{node_id}/event

Retrieve events within a specified date range, filtered by node ID and event types. The event types are passed as a comma-separated string.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/node/21b21ad1ddb5e3002cc6a3faa55e23d70db014ee229c213f7a43769789125536/event?start_date=2025-01-01&end_date=2025-02-01&events=A.8624b52f9ddcd04a.FlowIDTableStaking.RewardsPaid \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/node/21b21ad1ddb5e3002cc6a3faa55e23d70db014ee229c213f7a43769789125536/event?start_date=2025-01-01&end_date=2025-02-01&events=A.8624b52f9ddcd04a.FlowIDTableStaking.RewardsPaid",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/node/21b21ad1ddb5e3002cc6a3faa55e23d70db014ee229c213f7a43769789125536/event?start_date=2025-01-01&end_date=2025-02-01&events=A.8624b52f9ddcd04a.FlowIDTableStaking.RewardsPaid")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/rewards/paid

This endpoint retrieves information on rewards that have already been paid out.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/paid \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/paid",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/paid")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/rewards/staking

This endpoint retrieves information on staking rewards, providing details such as amounts, associated nodes, and timestamps.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/staking \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/staking",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/rewards/staking")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/tokenomics

This endpoint retrieves detailed tokenomics metrics.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/tokenomics \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/tokenomics",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/tokenomics")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/transaction/address/{address}

Retrieve transactions within a specified date range, filtered by address.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/address/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/address/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/address/0x097bafa4e0b48eef?start_date=2025-01-01&end_date=2025-04-01")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

GET /staking/v1/transaction/{transaction_id}

Retrieve transaction events for a given transaction ID.

Sample code

Curl

Curl
Axios
Python

Copy

00
01

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/b77283bb4e86635b88eb9ce9867fb21f1502ec75ef76d575ecc868e3872e0505 \
-X GET

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/b77283bb4e86635b88eb9ce9867fb21f1502ec75ef76d575ecc868e3872e0505",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/1069/staking/v1/transaction/b77283bb4e86635b88eb9ce9867fb21f1502ec75ef76d575ecc868e3872e0505")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)