Execute Deposit - Notional Protocol

HyperliquidPolymarket

Submits a previously issued deposit quote. The Polymarket launch route funds Polygon pUSD from HyperCore USDC.

Endpoint

POST /exchange

Request Body

Parameter	Type	Description
`action`*	object	Deposit execution payload
`nonce`*	number	Replay-protection nonce, e.g., `1785254405000`
`expiresAfter`*	number	Signed request expiry, e.g., `1785254455000`
`signature`*	object	User’s EIP-712 signature

action

Field	Type	Description
`type`*	string	Must be `"executeProtocolTransfer"`
`terms`*	object	Signed deposit terms

action.terms

Field	Type	Description
`kind`*	string	Must be `"quoted"` for the Polymarket route
`quote`*	object	Exact `quote` object returned by `protocolTransferQuote`

const request = {
  action: {
    type: "executeProtocolTransfer",
    terms: {
      kind: "quoted",
      quote, // Complete object returned by protocolTransferQuote
    },
  },
  nonce: 1785254405000,
  expiresAfter: 1785254455000,
  signature: {
    r: "0x1234...",
    s: "0x5678...",
    v: 27,
  },
};

Sign the action containing the complete quote, then JSON-serialize the resulting request.

Response

200: Pending
503: Unavailable

{
  "status": "ok",
  "response": {
    "type": "executeProtocolTransfer",
    "data": {
      "transactionId": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
      "transferId": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "status": "pending",
      "blockNumber": 123456
    }
  }
}

{
  "error": "Protocol transfers are temporarily unavailable",
  "code": "SERVICE_UNAVAILABLE",
  "timestamp": 1785254400000,
  "retryAfter": 5
}

An accepted request returns pending; the transfer continues after the HTTP response. Poll protocolTransferStatus with transferId until its status is completed or failed.

Authorization Rules

The wallet in quote.terms.userAddress must directly sign the complete action.
Approved API wallets (agents) cannot initiate protocol transfers.
expiresAfter must be in the future and cannot be later than quote.terms.expiresAt.
The quote must still be authentic and unexpired, and the route must remain enabled.
The first-step source amount is reserved when the request is accepted.

Do not submit funds directly to quote.terms.steps[].provider.paymentInstruction. Execution is initiated only by the accepted, signed executeProtocolTransfer request.