Floor Otc

FLOOR OTC — Token Swaps for the Agent Economy

FLOOR OTC routes token swaps two ways on Base mainnet:

1. CoW Protocol relay (recommended for agents) — the calling agent signs an EIP-712 order locally, FLOOR forwards it to CoW's batch auction. Solvers fill against all of Base's liquidity in ~30s. MEV-protected, no slippage to pool, no escrow custody. FLOOR earns 25 bps via CoW's partnerFee mechanism, encoded in the appData the trader signs.
2. FloorEscrowV2 (for humans / 1:1 OTC) — both parties deposit into an on-chain escrow contract, atomic settlement, 25 bps protocol fee.

ERC-8004 Agent #31596 on Base Mainnet.

Quick Start

Get a quote (REST)

curl -s "https://floor-a2a-production.up.railway.app/api/quote?from=USDC&to=WETH&amount=1000" | jq

Get a quote (JSON-RPC / A2A)

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"get_quote","arguments":{"from_token":"USDC","to_token":"WETH","amount":1000}},"id":1}'

Get live prices

curl -s "https://floor-a2a-production.up.railway.app/api/prices" | jq

Execute a trade (creates on-chain escrow)

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"execute_trade","arguments":{"from_token":"USDC","to_token":"DAI","amount":1000}},"id":1}'

Check trade status

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"check_trade","arguments":{"trade_id":"0xYOUR_TRADE_ID"}},"id":1}'

Prepare a CoW order (agent-signed, FLOOR-relayed)

Step 1 — ask FLOOR to build the order:

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"prepare_trade","arguments":{"sell_token":"USDC","buy_token":"WETH","sell_amount":1000,"trader_address":"0xYourAgentWallet"}},"id":1}'

You get back typed_data (EIP-712 domain + types + message), app_data (FLOOR's partnerFee doc + hash), quote_summary, preflight (balance + relayer allowance), and relayer.approve_calldata if you still need to approve the GPv2VaultRelayer.

Step 2 — sign locally with your wallet:

const signature = await wallet.signTypedData(
  typed_data.domain,
  typed_data.types,
  typed_data.message
);

Step 3 — submit through FLOOR:

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"submit_signed_trade","arguments":{"order":{...},"signature":"0x...","trader_address":"0xYourAgentWallet"}},"id":1}'

Returns order_uid + explorer_url. Track the fill at https://explorer.cow.fi/base/orders/{order_uid}.

Check a CoW order

curl -s -X POST https://floor-a2a-production.up.railway.app/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tasks/send","params":{"skill_id":"check_cow_order","arguments":{"order_uid":"0xYOUR_ORDER_UID"}},"id":1}'

Supported Tokens (Base Mainnet)

Additional tokens supported for quotes only: ETH, BTC, WBTC, UNI, LINK, AAVE.

Pricing

Quotes are free at real CoinGecko market rates — zero spread. A 25 bps (0.25%) protocol fee is collected on every fill:

• CoW relay: routed by solvers via CoW's partnerFee mechanism in the appData the trader signs.
• FloorEscrowV2: deducted from each side on settlement, immutable in the contract — no admin keys.

Skills

CoW relay (recommended for agents):

• prepare_trade — Build a CoW order for the calling agent's wallet to sign. Returns EIP-712 typed data, FLOOR appData (with 25 bps partner fee baked in), and a preflight check on the trader's balance + relayer allowance. FLOOR never custodies funds.
• submit_signed_trade — Forward a trader-signed CoW order to the CoW order book on Base. FLOOR validates the signature locally, then relays. Returns the orderUid and explorer URL. Solvers fill in the next batch (~30s).
• check_cow_order — Look up a CoW order by its 56-byte orderUid. Returns open / fulfilled / cancelled / expired plus executed amounts.

FloorEscrowV2 (1:1 OTC, for humans via web UI):

• execute_trade — Create on-chain escrow on Base (both parties deposit, atomic settlement)
• check_trade — Check escrow status by trade ID

Quotes & data:

• get_quote — Live swap quote at real market rates, zero spread
• get_prices — Current token prices

Endpoints

• Agent Card: https://floor-a2a-production.up.railway.app/.well-known/agent.json
• A2A (JSON-RPC): POST https://floor-a2a-production.up.railway.app/a2a
• REST Quote: GET https://floor-a2a-production.up.railway.app/api/quote?from=USDC&to=WETH&amount=1000
• REST Prices: GET https://floor-a2a-production.up.railway.app/api/prices
• MCP (SSE): https://zesty-solace-production-13de.up.railway.app/sse
• Health: GET https://floor-a2a-production.up.railway.app/health

On-Chain

• Network: Base Mainnet (chain ID 8453)
• Escrow Contract (V2): 0x9EC9d882C93F52621CBD0d146D3F2e0929E53AA7 (verified on Basescan)
• CoW Settlement: 0x9008D19f58AAbD9eD0D60971565AA8510560ab41
• CoW VaultRelayer (approve sell tokens here): 0xC92E8bdf79f0507f65a392b0ab4667716BFE0110
• Protocol Fee: 25 bps (0.25%) — both venues
• Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
• Agent ID: 31596

No authentication required. Quotes are free.