Docs

Agents & builders

Give your agent access to leveraged tokenized-stock positions on Base. Bring any Base-capable wallet: Dynamic, Bankr, Coinbase, or your own signer. Dynamic is not required. It is an optional developer reference for agents that start without a wallet. Your agent runs in your own runtime; this website is the visual product surface.

Bring your own wallet

1. Your agent queries Margin Call’s public API or MCP for assets, pricing, credit, and quotes.
2. It acquires the canonical supported stock through its own swap provider.
3. Margin Call prepares unsigned transactions for the intended Base wallet.
4. Your wallet signs and submits; the Position NFT belongs to the calling wallet.

Public reads and quotes need no authentication, API key, wallet, or caller-supplied RPC when using the hosted endpoints. Preparation needs your wallet address and sufficient stock. A wallet is needed to sign onchain actions; any compatible Base signer can execute the prepared transactions.

Margin Call

Supported assets, market pricing, credit/readiness, quotes, unsigned preparation, Base contracts, and Position NFTs.

Your agent

Reasoning and decisions in your own runtime.

Your wallet provider

Identity/address, signing, and broadcasting transactions.

Your swap provider

Acquiring the required supported stock through Uniswap, existing wallet tooling, or another available route.

Already have a Bankr-style agent with a Base wallet? Query supported assets, use its existing swap capability to acquire the exact stock token, call quote/prepare, then sign and submit with that same wallet. No Dynamic setup is needed; this is a portability example, not a Bankr integration.

Public API / MCP quickstart

HTTP: https://margincall.fun/api/agent
Streamable HTTP MCP: https://margincall.fun/api/mcp

In a client supporting remote Streamable HTTP MCP, add:

{
  "mcpServers": {
    "margin-call": {
      "url": "https://margincall.fun/api/mcp"
    }
  }
}

get_assets

Supported stocks, canonical addresses, and leverage presets

get_market_state

Fresh pricing and whether new leveraged positions can open

get_credit_pool

Available lending credit

quote_open

Position sizing and estimated borrowing

get_position

Live Position NFT ownership, debt, and health

prepare_open

Unsigned Base transactions for the intended wallet

Try this prompt in your agent:

Check whether I can open a 1.25x NVDAc position right now and prepare the transactions if I can.

Start with GET /api/agent/assets and GET /api/agent/market-state?asset=NVDAc, then POST /api/agent/quote-open. Once the wallet holds stock, prepare the open:

# Replace with the Base address that will sign.
WALLET=0xYourBaseAddress
curl -X POST https://margincall.fun/api/agent/prepare-open \
  -H 'Content-Type: application/json' \
  -d "{\"wallet\":\"$WALLET\",\"asset\":\"NVDAc\",\"stockAmount\":\"1000000\",\"leverage\":12500}"

stockAmount is a decimal string in base units: "1000000"means 0.01 NVDAc (8 decimals). Leverage 12500 means 1.25x. The returned transactions contain unsigned to, data, value, and chainId (8453 for Base). The public service never signs or broadcasts.

Check ok before using a response. Refusals can have HTTP status 200; branch on code and stop if ok: false. Submit transactions in order from the supplied wallet, waiting for each successful receipt before continuing. Stop on a failed receipt. Decode PositionOpened from the open receipt for the token ID, then call get_position. Preparation is not a guarantee of execution.

Fresh market pricing is typically available during regular U.S. trading hours, Monday–Friday, excluding market holidays. When fresh pricing is unavailable, Margin Call pauses new leveraged positions rather than relying on stale prices. Do not silently fall back to 1.0x. Live pricing still requires an enabled asset, enough credit and stock, and successful execution.

Developer example: start an agent without a wallet

This section is for developers who want to run the Margin Call reference implementation locally. You do not need to clone the repository or use Dynamic to call Margin Call’s public API or MCP.

If your agent already has a Base-capable wallet, skip this section.

The reference implementation uses Dynamic to provision a server wallet so you can see how a walletless agent could be built. Dynamic is not a Margin Call dependency.

Clone the repository first:

git clone https://github.com/hurley87/margin-call.git
cd margin-call
pnpm install

These environment variables are local developer configuration for this reference implementation. They are not needed for the hosted Margin Call API or MCP:

• DYNAMIC_ENVIRONMENT_ID (or NEXT_PUBLIC_DYNAMIC_ENVIRONMENT_ID)
• DYNAMIC_API_TOKEN
• DYNAMIC_WALLET_PASSWORD
• UNISWAP_API_KEY
• optional BASE_RPC_URL

In Dynamic, enable embedded wallets and multiple embedded wallets per chain. Keep credentials server-side. Set UNISWAP_API_KEY for acquisition. A provisioned BASE_RPC_URL is recommended for the local demo; otherwise it falls back to NEXT_PUBLIC_BASE_RPC_URL or the public Base RPC.

# Provision or resolve a Base wallet
pnpm agent:wallet

# After manually funding the address with Base ETH + USDC:
pnpm agent:wallet --acquire --asset NVDAc --usdc 2

# When fresh market pricing is available:
pnpm agent:wallet --open --asset NVDAc

The open command defaults to the wallet’s full balance of the chosen stock; use --stock with a human decimal amount to limit it. If you combine --acquire --open, acquisition runs before the open’s pricing gate, so a stock swap may complete even when opening is refused.

• Pricing unavailable: the open step refuses to create leveraged debt and submits no open transactions. Refusing is a valid outcome.
• Pricing live and checks pass: Dynamic signs and submits, the demo waits for successful receipts, and the Position NFT is minted to the Dynamic wallet.

Follow the demo stages: Dynamic wallet (#490), public tools (#491), stock acquisition (#492), and wallet-agnostic financed open (#493).

See the full API reference and execution example. The public tools currently read and prepare opens; they do not expose repay, close, or liquidate tools, hosted agent accounts, or autonomous position management.