# StockKit Trade Builder – Tokenized Stock Swap Transaction Constructor

> StockKit Trade Builder – Tokenized Stock Swap Transaction Constructor is a paid API for AI agents from api.stockkit.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Builds unsigned buy/sell transactions for tokenized stocks on Robinhood Chain, returning ready-to-sign transaction objects for execution

## Facts

- Endpoint: POST https://api.stockkit.dev/v1/x402/trade/build
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stockkit-trade-builder-tokenized-stock-swap-transaction-constructor-15a10c49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sgrrt6MwAMbvSqdzrPlyP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stockkit-trade-builder-tokenized-stock-swap-transaction-constructor-15a10c49 -d '<json body>'
```

Example prompt: Build me a buy transaction on StockKit for $500 worth of NVDA tokenized stock, sending it to my wallet 0xAbC1234567890abcdef1234567890abcdef123456 with a max slippage of 50 basis points.

## When to prefer this

Use this endpoint when you need to programmatically build tokenized-stock swap transactions on Robinhood Chain for an AI agent or automation pipeline. Prefer it over generic DEX swap builders when dealing specifically with tokenized equities (stocks) paired with USDG, and when you need precise slippage control and wallet-addressed unsigned transactions ready for signing.

## Known failure modes

- Unknown or unsupported stock ticker symbol returns an error
- Invalid wallet address format (non-0x hex) causes validation failure
- Amount string with invalid format (non-numeric) rejected
- Slippage out of range (below 1 or above 5000 bps) causes parameter error
- Insufficient liquidity for the requested trade size may return an error
- Missing required fields (symbol, side, amount, recipient) cause 400 validation errors

## How this service works

Build tokenized-stock applications on Robinhood Chain with unified market data, execution, portfolio, and agent infrastructure.

## Output

Returns a JSON object containing one or more unsigned blockchain transactions ready to be signed and broadcast by the recipient wallet, representing the on-chain swap between USDG and the specified stock token on Robinhood Chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "side": {
   "enum": [
    "buy",
    "sell"
   ],
   "type": "string",
   "description": "buy = spend USDG to receive the token; sell = spend the token to receive USDG."
  },
  "denom": {
   "enum": [
    "usd",
    "token"
   ],
   "type": "string",
   "default": "usd",
   "description": "Unit of amount: usd (USDG) or token (the stock token)."
  },
  "amount": {
   "type": "string",
   "pattern": "^\\d+(\\.\\d+)?$",
   "description": "Trade size as a positive decimal string, in the unit given by denom."
  },
  "symbol": {
   "type": "string",
   "maxLength": 16,
   "minLength": 1,
   "description": "Stock token ticker, e.g. NVDA."
  },
  "recipient": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$",
   "description": "Wallet that signs and sends the returned transactions and receives the swap output."
  },
  "slippageBps": {
   "type": "integer",
   "default": 50,
   "maximum": 5000,
   "minimum": 1,
   "description": "Max slippage in basis points (50 = 0.5%)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stockkit-trade-builder-tokenized-stock-swap-transaction-constructor-15a10c49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.stockkit.dev](https://www.zero.xyz/host/api.stockkit.dev/llms.txt)
