nacian.finance · top-pools-by-apr

Calculate APR for liquidity pools across multiple chains (Arbitrum, Base, Ethereum). Tokens do not necessarily need to be token0 and token1 respectively in the pool, they are reordered automatically. Price range must be specified based on the ratio of token0 / token1. For example, if the provided token0 is ETH and the provided token1 is USDC, a correct price lower could be 1000 and price upper could be 8000. Viceversa, if the provided token0 is USDC and token1 is ETH, a correct price lower could be 0.000125 and price upper could be 0.001.

Call it in 30 seconds

// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY); // funds USDC on Base
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);

// Pays the $0.02 USDC automatically on the 402, then returns the real response:
const res = await fetchWithPay("https://nacian.finance/api/x402/pools/top-pools-by-apr", { method: "GET" });
console.log(await res.json());

# pip install x402 eth-account httpx
import os, asyncio
from eth_account import Account
from x402.clients.httpx import x402HttpxClient

account = Account.from_key(os.environ["PRIVATE_KEY"])  # funds USDC on Base

async def main():
    async with x402HttpxClient(account=account) as client:
        # x402 handles the 402 -> pay ($0.02 USDC) -> retry automatically
        r = await client.get("https://nacian.finance/api/x402/pools/top-pools-by-apr")
        print((await r.aread()).decode())

asyncio.run(main())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://nacian.finance/api/x402/pools/top-pools-by-apr?chain=string&liquidityUSD=string&priceLower=string&priceUpper=string&timeframeHours=string&token0=string&token1=string"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →