Execute Transfer

HyperliquidPolymarket

Submits a previously issued transfer quote. The forward route funds Polygon pUSD from HyperCore USDC; deployments with reverse ingress enabled also support returning Polygon pUSD to HyperCore USDC using a version 2 quote.

Endpoint

POST /exchange

Request Body

Parameter	Type	Description
`action`*	object	Transfer 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 transfer terms

action.terms

Field	Type	Description
`kind`*	string	Must be `"quoted"` for the Polymarket route
`quote`*	object	Exact version 1 or version 2 `quote` 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 with the exchange signing flow, using the account owner’s wallet. Pass expiresAfter to the signing helper as well as the request, 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. blockNumber is present on the initial successful submission and may be absent on an exact retry.

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.
Forward transfers reserve their source funds when accepted. Reverse transfers debit the signed pUSD funding amount into the withdrawal lifecycle; follow the funding and step status fields returned by protocolTransferStatus.

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

Start Here

Info

Analytics

Exchange

WebSocket

Endpoint

Request Body

action

action.terms

Response

Authorization Rules

​Endpoint

​Request Body

​action

​action.terms

​Response

​Authorization Rules

Endpoint

Request Body

action

action.terms

Response

Authorization Rules