Borro for agents

Scope

It prepares everything. It signs nothing.

What the server does for an agent, and what it never will.

What it does05

Reads every market, rate and wallet position on Borro.
Prepares 25 kinds of transaction, approvals first, in exact amounts.
Builds each transaction with the code the app itself runs.
Simulates every step from the wallet and says why one would fail.
States the price a short or a leveraged long is closed for you at.

What it doesn't05

Hold a key, or ask for one.
Sign or send a transaction.
Keep a session, a standing order or an autopilot.
Hold funds: nothing of the wallet's ever passes through it.
Speak for Robinhood: it is Borro's own server.

Quickstart

Connect your agent in one step.

Every client points at the same endpoint. Nothing to install.

Clients04

Claude Code

One command in the terminal

Shell

claude mcp add --transport http borro https://borro.markets/mcp

Claude Desktop

Settings, Connectors, Add custom connector, then paste the address

URL

https://borro.markets/mcp

Any MCP client

One entry in its JSON config

JSON

{ "mcpServers": { "borro": { "type": "http", "url": "https://borro.markets/mcp" } } }

By hand

POST JSON-RPC 2.0, no key and no session header

Shell

curl -s https://borro.markets/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Models

Your agent brings the model.

Borro's server runs none. If your agent needs one, Raeto, a Borro partner on Robinhood Chain, has two ways in.

RaetoPartner

Raeto API

400+ models through one OpenAI-compatible endpoint, paid from a Raeto balance or per request in USDG on Robinhood Chain

URL

https://api.raeto.cc/v1

Raeto routing

Sends simple requests to a cheaper model on your own provider key. A key takes one click, no sign-up

URL

https://raeto.cc/routing

Raeto's developer docsRaeto runs its own service; Borro does not run its models.

Worked example

From one prompt to a signed short.

Read, prepare, sign, read back. The key stays with the wallet.

Short 1.5 NVDAmarkets → open_short → sign → position

You     Short 1.5 NVDA from my wallet with 200 USDG down.

Agent   → markets {}
        ← stocks[NVDA]: price_usd, free to short, what shorters pay a year

Agent   → open_short { "wallet": "0x1111…1111", "symbol": "NVDA",
                       "amount": "1.5", "deposit": "200" }
        ← quote: sale_usdg, deposit_at_least_usdg, closed_for_you_at_price
        ← transactions:
            1  approve   USDG to BorroShort, exactly 200
            2  call      BorroShort.open: borrow 1.5 NVDA, sell it, hold the money
        ← simulation: eth_simulateV1, ok

Wallet  signs and sends 1, waits for it to land, then 2.

Agent   → position { "wallet": "0x1111…1111" }
        ← stocks[NVDA].short: owed_stock 1.5, held_usdg, closed_for_you_at_price

// Node 18+ and ethers v6. The key never leaves this machine; Borro's server only prepares.
import { ethers } from "ethers";

const MCP = "https://borro.markets/mcp";
async function call(name, args = {}) {
  const res = await fetch(MCP, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
  });
  const { result } = await res.json();
  if (result.isError) throw new Error(result.content[0].text);
  return result.structuredContent;
}

// Your own Robinhood Chain RPC (chain id 4663) and the wallet the agent acts for.
const wallet = new ethers.Wallet(process.env.KEY, new ethers.JsonRpcProvider(process.env.RPC));

// 1. Read the shelf.
const shelf = await call("markets");
console.log(shelf.stocks.find((s) => s.symbol === "NVDA"));

// 2. Prepare the short: approvals first, then BorroShort.open, simulated from the wallet.
const plan = await call("open_short", { wallet: wallet.address, symbol: "NVDA", amount: "1.5", deposit: "200" });
if (!plan.simulation.ok) throw new Error(JSON.stringify(plan.simulation.steps));

// 3. Sign and send each step, in order, waiting for each to land.
for (const tx of plan.transactions) {
  await (await wallet.sendTransaction({ to: tx.to, data: tx.data, value: BigInt(tx.value), chainId: tx.chainId })).wait();
}

// 4. Read it back.
const mine = await call("position", { wallet: wallet.address });
console.log(mine.stocks.find((s) => s.symbol === "NVDA")?.short);

Tools

35 tools, one for every move on Borro.

Preparereturns unsigned transactions you sign

Nine read the chain. Twenty-six prepare transactions for the wallet to sign.

Markets and wallets

6 read

marketsRead

Every stock and the USDG vault: price, sizes, rates and the Drip.

No arguments

marketRead

One stock's full line: rates, sizes, limits, open fee, contracts.

`symbol`	stringrequired

positionRead

Everything a wallet has on Borro, from shorts to $BORRO to claim.

`wallet`	stringrequired

tradesRead

Recent shorts opened and closed across Borro, newest first.

No arguments

bear_coinsRead

Every bear coin launched on Pons from Borro, with its short.

No arguments

rulesRead

House rules, limits, what can go wrong, every contract address.

No arguments

Lend and borrow

6 prepare

supplyPrepare

Lend a stock or USDG; with post, lend and post stock in one step.

`wallet`	stringrequired
`asset`	stringrequired
`amount`	stringrequired
`post`	boolean

withdrawPrepare

Take back lent stock or USDG, part or all.

`wallet`	stringrequired
`asset`	stringrequired
`amount`	string
`all`	boolean

borrowPrepare

Borrow USDG against stock already lent and posted.

`wallet`	stringrequired
`symbol`	stringrequired
`amount`	stringrequired

repayPrepare

Repay USDG borrowed against a stock, part or all.

`wallet`	stringrequired
`symbol`	stringrequired
`amount`	string
`all`	boolean

bind_builderPrepare

Credit a bookrunner's code with the wallet's borrowing: one signature, no gas.

`wallet`	stringrequired
`code`	stringrequired
`timestamp`	integer
`signature`	string

buy_with_ethPrepare

Swap the wallet's ETH for USDG or a stock on Uniswap.

`wallet`	stringrequired
`want`	stringrequired
`amount`	stringrequired
`slip_bps`	integer

Shorts and pairs

4 prepare

open_shortPrepare

Borrow the stock, sell it and hold the money, in one open.

`wallet`	stringrequired
`symbol`	stringrequired
`amount`	stringrequired
`deposit`	string

close_shortPrepare

Buy back what is owed, return it, take out the money held.

`wallet`	stringrequired
`symbol`	stringrequired

open_pairPrepare

Buy and lend the long stock, then short the other.

`wallet`	stringrequired
`long`	stringrequired
`short`	stringrequired
`long_amount`	stringrequired
`short_amount`	stringrequired
`deposit`	string

close_pairPrepare

Close the newest pair of these two stocks, both legs.

`wallet`	stringrequired
`long`	stringrequired
`short`	stringrequired

Leverage

2 prepare

open_longPrepare

A leveraged long in one open, up to 1.80x on SPY, QQQ and NVDA.

`wallet`	stringrequired
`symbol`	stringrequired
`margin`	stringrequired
`leverage`	numberrequired

close_longPrepare

Sell the stock, repay the debt, take the rest in USDG.

`wallet`	stringrequired
`symbol`	stringrequired
`percent`	number

Farms

1 read · 2 prepare

farmsRead

Each stock farm's size, fees and lent part; a wallet's share.

`symbol`	string
`wallet`	string

farm_depositPrepare

Put USDG and a stock into its farm at the farm's ratio.

`wallet`	stringrequired
`symbol`	stringrequired
`usdg`	string
`stock`	string
`slip_bps`	integer

farm_withdrawPrepare

Take part or all out of a farm. Never paused.

`wallet`	stringrequired
`symbol`	stringrequired
`percent`	number
`slip_bps`	integer

Weekend

1 read · 5 prepare

weekendRead

While the market is shut: paused prices, Borro's band, quotes.

`symbol`	string

buy_coverPrepare

Monday-gap cover on a stock while the market is shut.

`wallet`	stringrequired
`symbol`	stringrequired
`side`	up \| downrequired
`notional`	stringrequired
`strike_bps`	integer

deposit_coverPrepare

Put USDG into the pool that backs every gap cover.

`wallet`	stringrequired
`amount`	stringrequired

withdraw_coverPrepare

Take USDG out of the gap cover pool once no cover is live.

`wallet`	stringrequired
`amount`	string
`all`	boolean

settle_coverPrepare

Settle a cover on the first print after the reopen, or void it.

`wallet`	stringrequired
`id`	stringrequired

claim_coverPrepare

Take a payout a settled or voided cover could not send.

`wallet`	stringrequired

Options

1 read · 7 prepare

optionsRead

One stock's chain for this Friday and next, checked on chain.

`symbol`	stringrequired

write_optionPrepare

Post an ask, or sell into a bid. Fully collateralized.

`wallet`	stringrequired
`symbol`	stringrequired
`type`	call \| put
`expiry`	string
`strike`	string
`shares`	stringrequired
`premium`	string
`from`	stock \| shares \| usdg
`order_id`	string

buy_optionPrepare

Buy from the best ask, with the premium as the most it takes.

`wallet`	stringrequired
`symbol`	stringrequired
`type`	call \| put
`expiry`	string
`strike`	string
`shares`	stringrequired
`order_id`	string
`max_premium`	string

post_bidPrepare

Bid for a series; the premium waits locked in USDG.

`wallet`	stringrequired
`symbol`	stringrequired
`type`	call \| putrequired
`expiry`	string
`strike`	stringrequired
`shares`	stringrequired
`premium`	stringrequired

cancel_orderPrepare

Cancel an ask or a bid; its lock goes back to its maker.

`wallet`	stringrequired
`order_id`	stringrequired

settle_seriesPrepare

Settle an expired series on the feed's last print.

`wallet`	stringrequired
`series_id`	string
`symbol`	string
`expiry`	string
`strike`	string
`type`	call \| put

claim_optionPrepare

Burn a settled series' tokens and take what they pay.

`wallet`	stringrequired
`series_id`	stringrequired
`shares`	string
`as_shares`	boolean

release_collateralPrepare

Give a writer back a settled series' lock, less what it pays.

`wallet`	stringrequired
`series_id`	stringrequired

Only on Borro

Short a stock, pair it, cover the weekend, lend it out.

The desks Borro runs on Robinhood Chain, each a tool call away.

Short a stockopen_short

1 transactionborrows, sells and holdsBorroShort.open does all three; an approval first if one is missing.

Pairsopen_pair

Long and shortin one prepared flowThe long is bought and lent in the wallet's name, so it earns rent while held.

The Weekend deskweekend · buy_cover

95% bandwhile the feeds pauseBorro's weekend price and band, and cover that pays past the strike on a Monday gap.

Lend stocksupply · borrow

Rentfrom the shorters who borrow itLend a stock token to its vault, or post it and borrow USDG against it.

Automation

Recipes an agent can run today.

Your agent watches and decides. The wallet signs every step.

RecipeTools

Watch and shortRead the markets on a schedule; open a short when the price or rent crosses your line.markets→open_short
Defend a shortWatch the price a short is closed for you at, and close it before the stock gets there.position→close_short
Cover the weekendWhile the market is shut, up to an hour before the reopen, buy gap cover up on a short.weekend→buy_cover
Lend what sits idleLend stock the wallet holds, and take it back when it is needed.position→supply·withdraw

Every prepare tool returns transactions the wallet signs itself. No session, no standing order, no key on the server: nothing happens without the wallet.

For agent operators

Bring deposits, share Borro's fee.

An agent credits your code by depositing through BorroBuilders, and a wallet's borrowing with one signature.

Fee shareFirst 12 months

100%of Borro's feeOn the deposits your code brings, paid monthly in USDG.

Fee shareAfter that

50%for as long as they stayCounted per deposit; withdrawals come off the oldest first.

Bookrunner DripYear one

20M$BORRO among bookrunnersSplit by the deposits each brings. See the economics.

The one deposit call, workedRent floats with demand. No income is promised.

Safety

The server prepares. The wallet decides.

What the server never does, and what can still go wrong.

KeysNever held, never asked for.
SendingThe server signs and sends nothing. The wallet's owner sends each step.
ApprovalsExact amounts, and only the ones missing.
SimulationEvery step runs from the wallet first, with the reason it would fail.
QuotesPriced at the call. A step that fails on slippage needs a fresh call.
Market capsSized from each stock's pool depth. The caps file
Shorting limit77% of what is held for SPY and QQQ, 62.5% for single stocks.
LiquidationPast the limit a short is closed for you, and part of the money held is kept.
AuditBorro's own contracts are reviewed and tested, not yet audited by an outside firm.
$BORROIt has no promised value and can be worth nothing.

Reference

Every tool, every argument, one example each.

01Connect

Detail	Spec
Endpoint	`https://borro.markets/mcp`
Transport	Streamable HTTP, stateless. POST a message or a batch; the answer comes back as JSON.
Sign-in	None. No API key, no session, no server-sent stream.
Protocol	`2025-06-18`, or `2025-03-26` and `2024-11-05` when the client asks for them
Methods	`initialize`, `tools/list`, `tools/call`, `ping`
Batches	1 to 10 messages
Body	Up to 64 KB
GET	A short plain-text description; asking for `text/event-stream` gets a 405
Browsers	CORS is open to any origin.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": { "protocolVersion": "2025-06-18" }
}

Answer

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "tools": { "listChanged": false } },
    "serverInfo": { "name": "borro", "title": "Borro", "version": "1.0.0" },
    "instructions": "Borro on Robinhood Chain: read markets and positions, and prepare unsigned transactions for a wallet to sign. Amounts are decimal strings in whole units (\"1.5\" NVDA, \"100\" USDG). Send prepared transactions in order and call the tool again if a quote has moved."
  }
}

02Calling a tool

Field	What it holds
`result.content`	One text item: the answer as JSON text.
`result.structuredContent`	The same answer as an object.
`result.isError`	True when the tool could not answer; the text says why.
`transactions`	A prepare tool's steps, in order, approvals first: each with to, data, value and chainId.
`simulation`	Every step run from the wallet as one block, with the reason a step would fail.

Request

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "open_short",
    "arguments": { "wallet": "0x1111111111111111111111111111111111111111", "symbol": "NVDA", "amount": "1.5", "deposit": "200" }
  }
}

structuredContent, shape

{
  "action": "open_short",
  "chainId": 4663,
  "from": "0x1111111111111111111111111111111111111111",
  "quote": { "sale_usdg": "…", "open_fee": …, "after_fee_usdg": "…", "least_accepted_usdg": "…",
             "deposit_at_least_usdg": …, "closed_for_you_at_price": …, "expires_at": "…", "weekend_rule": null },
  "transactions": [
    { "step": 1, "kind": "approve",
      "description": "Approve 0xd2D686cEdf225c5C9815187A08812783904E62Eb to take exactly what this needs",
      "to": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168", "data": "0x095ea7b3…", "value": "0", "chainId": 4663 },
    { "step": 2, "kind": "call",
      "description": "Short 1.5 NVDA: borrow it, sell it, hold the money",
      "to": "0xd2D686cEdf225c5C9815187A08812783904E62Eb", "data": "0x…", "value": "0", "chainId": 4663 }
  ],
  "simulation": { "method": "eth_simulateV1", "ok": true, "steps": [{ "step": 1, "ok": true }, { "step": 2, "ok": true }] },
  "how_to_send": "Sign and send each transaction from the wallet, in order, waiting for each to land. Nothing has been sent. Quotes move: if a step fails on slippage, call this tool again for fresh numbers."
}

03Errors and limits

Errors

Code	When
`-32700`	The body is not JSON. HTTP 400.
`-32600`	Not a JSON-RPC 2.0 request, a batch outside 1 to 10, a body over 64 KB, or a method other than POST.
`-32601`	A method the server does not have.
`-32602`	A tool name the server does not have.
`isError: true`	The tool could not do it, and the text says why. The RPC's address is never in it.
202, no body	A notification, a message without an id: nothing to answer.

Allowance

Units	Tools
250 every 10 seconds	Each visitor's budget, shared with the site's own reads.
2	`rules`
3	`trades`, `bear_coins`
5	`markets`, `market`, `weekend`
10	`farms`, `options`, `bind_builder`, `claim_cover`, `cancel_order`, `claim_option`, `release_collateral`
15	Every other prepare tool.
20	`settle_cover`, `settle_series`
30	`position`
Over the budget	`isError: true`, "Too many requests from this address right now; wait about 10 seconds."

Inputs

Input	Rule
Amounts	Decimal strings in whole units: `"1.5"` NVDA, `"100"` USDG
Wallet	0x and 40 hex characters, all lowercase or correctly checksummed.
Stocks	By ticker, like NVDA. The markets tool lists every one.
Expiry	`this`, `next`, a Friday's date like `2026-10-16`, or the unix time of its close
Deadlines	20 minutes past the chain's latest block.
Examples	Below, `0x1111…1111` stands for the wallet the agent acts for.

04Markets and wallets

`markets`Read

TitleThe shelf
Allowance5 units
ReturnsThe answer as JSON

No arguments.

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "markets", "arguments": {} } }

`market`Read

TitleOne stock
Allowance5 units
ReturnsThe answer as JSON

Argument	Description
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "market", "arguments": {
    "symbol": "NVDA"
  } } }

`position`Read

TitleA wallet on Borro
Allowance30 units
ReturnsThe answer as JSON

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "position", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111"
  } } }

`trades`Read

TitleRecent trades
Allowance3 units
ReturnsThe answer as JSON

No arguments.

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "trades", "arguments": {} } }

`bear_coins`Read

TitleBear coins
Allowance3 units
ReturnsThe answer as JSON

No arguments.

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "bear_coins", "arguments": {} } }

`rules`Read

TitleRules and contracts
Allowance2 units
ReturnsThe answer as JSON

No arguments.

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "rules", "arguments": {} } }

05Lend and borrow

`supply`Prepare

TitlePrepare: lend
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`asset`stringrequired	USDG, or a stock symbol
`amount`stringrequired	Amount to lend, in whole units as a decimal string, like "1.5"
`post`booleanoptional	Stock only: lend and post as collateral in one step

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "supply", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "asset": "NVDA",
    "amount": "1.5"
  } } }

`withdraw`Prepare

TitlePrepare: take back what is lent
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`asset`stringrequired	USDG, or a stock symbol
`amount`stringoptional	Amount to take back, in whole units as a decimal string, like "1.5"
`all`booleanoptional	Take back everything

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "withdraw", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "asset": "USDG",
    "all": true
  } } }

`borrow`Prepare

TitlePrepare: borrow USDG
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`amount`stringrequired	USDG to borrow, in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "borrow", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "amount": "50"
  } } }

`repay`Prepare

TitlePrepare: repay USDG
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`amount`stringoptional	USDG to repay, in whole units as a decimal string, like "1.5"
`all`booleanoptional	Repay everything owed

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "repay", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "all": true
  } } }

`bind_builder`Prepare

TitlePrepare: credit a bookrunner for borrowing
Allowance10 units
ReturnsTyped data to sign, then the binding

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`code`stringrequired	The bookrunner's code, as in borro.markets/?ref=<code>
`timestamp`integeroptional	With signature: the timestamp from the typed data that was signed
`signature`stringoptional	The wallet's EIP-712 signature, 0x and 130 hex characters; leave out to get the typed data

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "bind_builder", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "code": "route"
  } } }

`buy_with_eth`Prepare

TitlePrepare: pay with ETH
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`want`stringrequired	USDG, or a stock symbol
`amount`stringrequired	How much of it to get, in whole units as a decimal string, like "1.5"
`slip_bps`integeroptional	Most the price may move, in hundredths of a percent (default 100, 1%)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "buy_with_eth", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "want": "USDG",
    "amount": "100",
    "slip_bps": 100
  } } }

06Shorts and pairs

`open_short`Prepare

TitlePrepare: open a short
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`amount`stringrequired	Stock to short, in whole units as a decimal string, like "1.5"
`deposit`stringoptional	USDG to add to the money held, beyond the sale (optional, default 0), in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "open_short", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "amount": "1.5",
    "deposit": "200"
  } } }

`close_short`Prepare

TitlePrepare: close a short
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "close_short", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA"
  } } }

`open_pair`Prepare

TitlePrepare: open a pair
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`long`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`short`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`long_amount`stringrequired	Long stock to buy, in whole units as a decimal string, like "1.5"
`short_amount`stringrequired	Stock to short, in whole units as a decimal string, like "1.5"
`deposit`stringoptional	USDG held against the short beyond the sale (optional), in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "open_pair", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "long": "NVDA",
    "short": "TSLA",
    "long_amount": "1",
    "short_amount": "0.5",
    "deposit": "150"
  } } }

`close_pair`Prepare

TitlePrepare: close a pair
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`long`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`short`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "close_pair", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "long": "NVDA",
    "short": "TSLA"
  } } }

07Leverage

`open_long`Prepare

TitlePrepare: leveraged long
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`margin`stringrequired	USDG margin from the wallet, in whole units as a decimal string, like "1.5"
`leverage`numberrequired	Leverage, more than 1, like 1.5

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "open_long", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "margin": "100",
    "leverage": 1.5
  } } }

`close_long`Prepare

TitlePrepare: close a leveraged long
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`percent`numberoptional	How much of the position to close, 1 to 100 (default 100)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "close_long", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "percent": 50
  } } }

08Farms

`farms`Read

TitleStock farms
Allowance10 units
ReturnsThe answer as JSON

Argument	Description
`symbol`stringoptional	One stock's farm (optional), by its ticker, like NVDA; farms lists the stocks that have one
`wallet`stringoptional	A wallet whose part of each farm to show (optional)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "farms", "arguments": {
    "symbol": "NVDA",
    "wallet": "0x1111111111111111111111111111111111111111"
  } } }

`farm_deposit`Prepare

TitlePrepare: put money into a farm
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`usdg`stringoptional	USDG to put in (optional if stock is given), in whole units as a decimal string, like "1.5"
`stock`stringoptional	Stock to put in (optional if usdg is given), in whole units as a decimal string, like "1.5"
`slip_bps`integeroptional	Most the farm may move against the quote, in hundredths of a percent (default 50, 0.5%)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "farm_deposit", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "usdg": "100",
    "slip_bps": 50
  } } }

`farm_withdraw`Prepare

TitlePrepare: take money out of a farm
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`percent`numberoptional	How much of the wallet's part to take out, 1 to 100 (default 100)
`slip_bps`integeroptional	Least accepted under the preview, in hundredths of a percent (default 50, 0.5%)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "farm_withdraw", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "percent": 100
  } } }

09Weekend

`weekend`Read

TitleThe Weekend Desk
Allowance5 units
ReturnsThe answer as JSON

Argument	Description
`symbol`stringoptional	One stock (optional), by its ticker, like NVDA; with a pool, its quotes are read from the chain

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "weekend", "arguments": {
    "symbol": "NVDA"
  } } }

`buy_cover`Prepare

TitlePrepare: buy gap cover
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`side`up \| downrequired	up (pays on a gap up: for a short) or down (on a gap down: for a long)
`notional`stringrequired	Cover, in USDG: for a short, about what the shares are worth, in whole units as a decimal string, like "1.5"
`strike_bps`integeroptional	How far the stock must move before it pays, in hundredths of a percent: 100, 200, 300 or 500 are quoted (default 200, 2%)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "buy_cover", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "side": "up",
    "notional": "500",
    "strike_bps": 200
  } } }

`deposit_cover`Prepare

TitlePrepare: fund the gap cover pool
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`amount`stringrequired	USDG to deposit, in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "deposit_cover", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "amount": "100"
  } } }

`withdraw_cover`Prepare

TitlePrepare: withdraw from the gap cover pool
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`amount`stringoptional	USDG to withdraw, in whole units as a decimal string, like "1.5"
`all`booleanoptional	Withdraw everything this wallet has in the pool (only when it is all free)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "withdraw_cover", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "all": true
  } } }

`settle_cover`Prepare

TitlePrepare: settle gap cover
Allowance20 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The address that will send it (any address; the payout goes to the cover's buyer)
`id`stringrequired	The cover's number (position lists a wallet's covers)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "settle_cover", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "id": "7"
  } } }

`claim_cover`Prepare

TitlePrepare: claim a waiting payout
Allowance10 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "claim_cover", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111"
  } } }

10Options

`options`Read

TitleThe Options Desk
Allowance10 units
ReturnsThe answer as JSON

Argument	Description
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "options", "arguments": {
    "symbol": "NVDA"
  } } }

`write_option`Prepare

TitlePrepare: write a call or a put
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`type`call \| putoptional	call or put
`expiry`stringoptional	this (the nearest Friday still taking orders, the default), next, or a Friday's date like 2026-10-16
`strike`stringoptional	The strike in dollars, on the $0.25 tick, like "250"
`shares`stringrequired	Shares to write (at least 0.001), in whole units as a decimal string, like "1.5"
`premium`stringoptional	Premium you ask, USDG a share (for an ask), in whole units as a decimal string, like "1.5"
`from`stock \| shares \| usdgoptional	Where the lock comes from: a call stock (default) or shares; a put usdg (default) or shares
`order_id`stringoptional	Sell into this bid instead of posting an ask (its series, its premium)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "write_option", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "type": "call",
    "expiry": "this",
    "strike": "220",
    "shares": "1",
    "premium": "2.5"
  } } }

`buy_option`Prepare

TitlePrepare: buy a call or a put
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`type`call \| putoptional	call or put
`expiry`stringoptional	this (default), next, or a Friday's date like 2026-10-16
`strike`stringoptional	The strike in dollars, like "250"
`shares`stringrequired	Shares to buy, in whole units as a decimal string, like "1.5"
`order_id`stringoptional	Buy from this ask instead of the best one
`max_premium`stringoptional	The most to pay in all, USDG (optional), in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "buy_option", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "type": "call",
    "expiry": "this",
    "strike": "220",
    "shares": "1",
    "max_premium": "5"
  } } }

`post_bid`Prepare

TitlePrepare: bid for options
Allowance15 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`symbol`stringrequired	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`type`call \| putrequired	call or put
`expiry`stringoptional	this (default), next, or a Friday's date like 2026-10-16
`strike`stringrequired	The strike in dollars, like "250"
`shares`stringrequired	Shares to bid for, in whole units as a decimal string, like "1.5"
`premium`stringrequired	Premium you bid, USDG a share, in whole units as a decimal string, like "1.5"

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "post_bid", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "type": "put",
    "expiry": "next",
    "strike": "210",
    "shares": "1",
    "premium": "1.5"
  } } }

`cancel_order`Prepare

TitlePrepare: cancel an order
Allowance10 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`order_id`stringrequired	The order's number (position lists this wallet's open orders)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "cancel_order", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "order_id": "12"
  } } }

`settle_series`Prepare

TitlePrepare: settle an expired series
Allowance20 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The address that will send it (any address)
`series_id`stringoptional	The series id (or symbol, expiry, strike and type instead)
`symbol`stringoptional	A stock on Borro by its ticker, like NVDA or AAPL (markets lists every one)
`expiry`stringoptional	A Friday's date like 2026-10-16
`strike`stringoptional	The strike in dollars
`type`call \| putoptional	call or put

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "settle_series", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "symbol": "NVDA",
    "expiry": "2026-10-16",
    "strike": "220",
    "type": "call"
  } } }

`claim_option`Prepare

TitlePrepare: claim a settled option
Allowance10 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`series_id`stringrequired	The series id (position lists them)
`shares`stringoptional	Shares to claim (optional, default all), in whole units as a decimal string, like "1.5"
`as_shares`booleanoptional	A put: take Steakhouse USDG vault shares instead of USDG

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "claim_option", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "series_id": "0xcca74e6d15c7b29e48b7f9ae4e7131d80aa617bd27fe2353831aa4bc3305c4d5"
  } } }

`release_collateral`Prepare

TitlePrepare: take back a writer's lock
Allowance10 units
ReturnsUnsigned transactions and a simulation

Argument	Description
`wallet`stringrequired	The wallet's address (0x...); the transactions are built for it to sign
`series_id`stringrequired	The series id (position lists them)

Request

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": { "name": "release_collateral", "arguments": {
    "wallet": "0x1111111111111111111111111111111111111111",
    "series_id": "0xcca74e6d15c7b29e48b7f9ae4e7131d80aa617bd27fe2353831aa4bc3305c4d5"
  } } }

Get in touch

Building an agent on Borro? Tell us what it needs.

team@borro.markets

Email the team The Bookrunners program

A stock loan desk your agent can run.

It prepares everything. It signs nothing.

Connect your agent in one step.

Claude Code

Claude Desktop

Any MCP client

By hand

Your agent brings the model.

Raeto API

Raeto routing

From one prompt to a signed short.

35 tools, one for every move on Borro.

Markets and wallets

Lend and borrow

Shorts and pairs

Leverage

Farms

Weekend

Options

Short a stock, pair it, cover the weekend, lend it out.

Recipes an agent can run today.

Bring deposits, share Borro's fee.

The server prepares. The wallet decides.

Every tool, every argument, one example each.

01Connect

02Calling a tool

03Errors and limits

Errors

Allowance

Inputs

04Markets and wallets

marketsRead

marketRead

positionRead

tradesRead

bear_coinsRead

rulesRead

05Lend and borrow

supplyPrepare

withdrawPrepare

borrowPrepare

repayPrepare

bind_builderPrepare

buy_with_ethPrepare

06Shorts and pairs

open_shortPrepare

close_shortPrepare

open_pairPrepare

close_pairPrepare

07Leverage

open_longPrepare

close_longPrepare

08Farms

farmsRead

farm_depositPrepare

farm_withdrawPrepare

09Weekend

weekendRead

buy_coverPrepare

deposit_coverPrepare

withdraw_coverPrepare

settle_coverPrepare

claim_coverPrepare

10Options

optionsRead

write_optionPrepare

buy_optionPrepare

post_bidPrepare

cancel_orderPrepare

settle_seriesPrepare

claim_optionPrepare

release_collateralPrepare

Building an agent on Borro? Tell us what it needs.

`markets`Read

`market`Read

`position`Read

`trades`Read

`bear_coins`Read

`rules`Read

`supply`Prepare

`withdraw`Prepare

`borrow`Prepare

`repay`Prepare

`bind_builder`Prepare

`buy_with_eth`Prepare

`open_short`Prepare

`close_short`Prepare

`open_pair`Prepare

`close_pair`Prepare

`open_long`Prepare

`close_long`Prepare

`farms`Read

`farm_deposit`Prepare

`farm_withdraw`Prepare

`weekend`Read

`buy_cover`Prepare

`deposit_cover`Prepare

`withdraw_cover`Prepare

`settle_cover`Prepare

`claim_cover`Prepare

`options`Read

`write_option`Prepare

`buy_option`Prepare

`post_bid`Prepare

`cancel_order`Prepare

`settle_series`Prepare

`claim_option`Prepare

`release_collateral`Prepare