/v1/tools

Tools

The tools your agent gets from keyfo, with where each one’s data comes from and how often it refreshes. Try the free read tools here; tools that build transactions or spend a balance need a key.

—

Stock tokens

stock_quote

Quote stock tokens and ETFs on Robinhood Chain by ticker (NVDA, TSLA, SPY…) or token address, one or up to 20 at once. Returns the pool price, 24h change and pool depth where a pool exists.

Pool prices from the stock token pools on Robinhood Chain, cached for 15 s.Pool prices from the stock token pools on Robinhood Chain, cached for 15 s. Bid and ask from Robinhood’s API, cached for 15 s.

stock_portfolio

The stock tokens and ETFs a wallet holds on Robinhood Chain, with amounts and value in dollars, plus its ETH.

Balances read from Robinhood Chain in one call, priced from the pools. Cached for 10 s per wallet.Balances read from Robinhood Chain in one call, priced from the pools, or from Robinhood’s API when a token has no pool. Dividends and splits from Robinhood’s API, cached for 1 h.

stock_moversNew in 1.6

Today’s movers among stock tokens on Robinhood Chain, ranked by the pool’s 24h change.

Ranked by the pool’s 24h change, from the stock token pools, cached for 15 s.Ranked by the pool’s 24h change, or by dollars minted and burned today and the place in the day’s range, from Robinhood’s API. Cached for 15 s.

stock_eventsNew in 1.6

Dividends and splits from Robinhood’s API, cached for 1 h.

Trades

build_trade

Build unsigned transactions to buy a stock token on Robinhood Chain with ETH (eth, or usd worth of ETH) or sell pct percent of the wallet’s holding for ETH. token is a ticker (TSLA) or the token address. A buy needs the ETH, plus gas, already in wallet; if it is short, fund it with fund_agent first. The calls expire at valid_until: sign and send before then, or build the trade again. Returns calls for the wallet owner to sign and send in order on Robinhood Chain (chain ID 4663). No keyfo tool signs.

Routes and quotes from LI.FI, tested on the network before the reply. A quote is cached for 30 s; its calls expire at valid_until.

Needs a keyConnect

Funding

fund_agent

Quote moving funds from another network (ethereum, base, arbitrum, optimism, bnb, polygon and others, 15 in all, or a chain ID) to an agent wallet on Robinhood Chain, arriving as ETH. payer is the wallet that already holds the funds on the origin network: if the user did not name it, ask, do not reuse wallet. amount is in the smallest unit (wei for ETH), a number or a string of digits. Returns transactions for the payer to sign.

Quotes from Relay for 15 origin networks. The payer signs on the origin network.

Needs a keyConnect

Your key

my_keyNew in 1.6

What your keyfo key can still use: its allowance, what is left and when it resets. Without a key: how many free read calls are left this hour.

Read from your key when you ask. Without a key: the free read calls left this hour.

Morpho

morpho_ratesNew in 1.7

Morpho’s public API, cached for 2 min. Rates change; the numbers are a snapshot.

morpho_loopNew in 1.7

A calculation on the Morpho rates, cached for 2 min. Nothing is built or sent.

build_morpho_depositNew in 1.7

Calls for a Morpho vault, tested on the network before the reply. Your agent signs them.

Needs a keyConnect

Models

list_modelsNew in 1.8

Read from keyfo’s cached model catalog. Free, and it calls no model.

model_detailNew in 1.8

Read from the same cached catalog, with a cost estimate for a typical call. Free.

ask_modelNew in 1.8

Sent through the same gateway as /v1/chat/completions. A paid call: it needs a key and is charged to it at the model’s price.

Needs a keyConnect

Wallet and chain

stock_approvalsNew in 1.9

Allowances read from Robinhood Chain in batches, against the spenders keyfo knows. Cached for 30 s per wallet.

chain_statusNew in 1.9

Read from Robinhood Chain: the latest block, the average block time over 1000 blocks and the gas price. Cached for 10 s.

explain_txNew in 1.9

Read from Robinhood Chain. Function names from keyfo’s own table, or from the open openchain.xyz signature database, cached for a day.

build_revokeNew in 1.9

A call that sets one approval to zero, tested on the network before the reply. Your agent signs it.

Needs a keyConnect