Flow is a blockchain designed for the next generation of apps, games, and digital assets. Known for its high performance, scalability, and developer-friendly features, Flow offers a robust environment for deploying decentralized applications (dApps).

The Flow API facilitates interaction with the Flow network through a collection of JSON-RPC methods. Given its developer-friendly design, those familiar with Ethereum's JSON-RPC APIs will find working with Flow intuitive and straightforward.

Send Your First Request on Alchemy

Let's use the viem package to create a Flow EVM client connected to Alchemy and fetch the latest block number!

npm install --save viem

Create Client Connected to Alchemy

import { createPublicClient, http } from "viem"; 
import { flowTestnet } from "viem/chains";
 
const client = createPublicClient({
  chain: flowTestnet,
  transport: http("https://flow-testnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY"),
});

Now that you've created a client connected to Alchemy, you can continue with some basics:

Get Latest Block Number

const blockNumber = await client.getBlockNumber();
console.log("Current block number:", blockNumber);

Get an Address Balance

const balance = await client.getBalance({ address: "0xab5801a7d398351b8be11c439e05c5b3259aec9b" });
console.log("Balance (FLOW):", Number(balance) / 1e18);

Read Block Data

const block = await client.getBlock({
  blockNumber: blockNumber, // from previous example
});
console.log(block);

Fetch a Transaction by Hash

const tx = await client.getTransaction({ hash: "0xYOUR_TX_HASH" });
console.log(tx);

Fetch Transaction Receipt

const receipt = await client.getTransactionReceipt({
  hash: "0xYOUR_TX_HASH"
});
console.log(receipt);

Flow EVM APIs

For the full list of Flow EVM APIs, see the Flow EVM API Endpoints.