Skip to content
Fluqo
Close

Tool · 07 / 14

API and MCP

The numbers behind the tools, for your own scripts and agents. Every call only reads. Nothing here signs or sends a transaction.

Access
API key from a wallet signature
Price
No charge
Calls
Read only

01 Get a key

A signature instead of an account.

One key per wallet, with one signature. It sends no transaction and costs nothing. Making a new key stops the old one.

Keys need a wallet that signs for itself. A smart contract wallet cannot make one yet. Holding $FLUQO is not needed.

02 REST API

GET requests, with your key in a header.

curl https://fluqo.xyz/api/v1/costs \
  -H "Authorization: Bearer <your key>"
GET /api/v1/pools

Pools on Robinhood Chain by liquidity, as GeckoTerminal lists them. Names are whatever each token calls itself.

No parameters · 1 unit
GET /api/v1/pools/{id}

What a pool address, a v4 pool id or a token address is, and its current state. A ticker is not an identity on this chain, so compare addresses.

No parameters · 10 units
GET /api/v1/pools/{id}/swaps

Recent swaps of a pool, newest reach only. The answer says which blocks it covered and whether the read failed.

kind (optional): Needed for a pool address. A 32-byte id is always v4. · 10 units
GET /api/v1/tokens/{address}/holders

Largest holders of a token where they can be read. complete: false means the list covers only wallets seen in recent transfers.

No parameters · 30 units
GET /api/v1/costs

Gas figures for the steps of a token launch, the gas price, ETH / USD and the Pons launch settings, each with its source. Gas excludes this chain's L1 data charge unless a line says otherwise.

No parameters · 1 unit
GET /api/v1/impact

How far a trade of this size moves a pool and what the trader pays, from current pool state. Hooks and transfer taxes are not simulated. Flags say when the result is only a guide.

pool: Pool address, or 32-byte v4 pool id, starting with 0x · amount: Amount in, whole number in the input token's smallest unit · from (optional): The input side. token0 if left out. · 10 units
GET /api/v1/curve-quote

A buy on an ETH-paired Pons curve, simulated with eth_call at the latest block. Nothing is sent. amountOut is null when the simulation did not go through.

curve: Curve: 20-byte address starting with 0x · amount: ETH in, as a whole number of wei · 5 units
GET /api/v1/compare

Sets a launch plan beside what the chain says about a live token, line by line. Each line reads match, differs or unknown. There is no overall verdict.

plan: The p= value of a simulator share link, or the whole link · token: Token: 20-byte address starting with 0x · pool (optional): Pool address, or 32-byte v4 pool id, starting with 0x · wallets (optional): Up to 8 extra wallets to read. In the URL, separate them with commas. · 12 units

03 MCP server

The same reads, as tools an agent can call.

The endpoint is https://fluqo.xyz/mcp over streamable HTTP, with the same key. There is nothing to install. Most clients take a block like this one:

{
  "mcpServers": {
    "fluqo": {
      "type": "http",
      "url": "https://fluqo.xyz/mcp",
      "headers": { "Authorization": "Bearer <your key>" }
    }
  }
}
  • list_pools
  • get_pool
  • get_recent_swaps
  • get_top_holders
  • get_launch_costs
  • estimate_price_impact
  • quote_pons_buy
  • compare_plan_actual

Every tool is marked read-only. No tool can sign, send or reach a wallet.

04 Reading an answer

Each answer says where it came from.

{
  "data": { ... },
  "meta": {
    "operation": "get_launch_costs",
    "source": "Robinhood Chain RPC",
    "block": 106199069,
    "readAt": "2026-11-05T09:00:00.000Z"
  }
}
  • null means it could not be read. It is never a zero and never a guess.
  • Amounts are whole numbers in the smallest unit, as strings.
  • A ticker is not an identity. Token names come from the tokens themselves and many borrow famous names. Compare addresses.
  • No verdicts. A reading is not advice, and nothing here says a token is good or safe.
  • Limits of the math. Hooks and transfer taxes are not simulated, and state moves between a read and a trade.

05 Limits

A shared public chain node sits behind this.

  • 600 units a minute and 20,000 units a day per wallet. A call answers 429 with a Retry-After header when over.
  • The API has its own overall budget, so it can answer “busy” even under your limit.
  • Answers can be seconds to minutes old, because reads are kept briefly.
  • This is new software with no uptime promise. Do not make a trade or a payment depend on it alone.
Opening the index…