Prerequisites
- A server-side API key enabled for v1
- A Base wallet with USDC and ETH for approval and funding transactions
- The recipient’s OP Mainnet address
- The current supported chain and token configuration
Configure the transfer
The example amount is illustrative; quote availability and fees depend on the request. Check the returned
amountOut, minAmountOut, fees, and expiry before funding.
Complete the transfer
- Request and verify the quote. Verify the signed intent hashes and check that the funding transaction and delivery route match your request.
- Approve USDC to the returned funding transaction’s Portal when needed. Wait for a successful approval receipt, then estimate gas and send the funding transaction before the quote expires.
- Track the delivery intent with
GET /v1/intents/status. For a direct transfer, this is the quote’sintentHash; inspectsteps[]for routes with multiple intents. - Confirm
filledorsettledon the delivery intent. A successful funding receipt alone does not confirm destination delivery.
Troubleshooting
401or403: check your API key and v1 access.502 solver-error: no usable quote was returned. Check the token pair and amount; retry within a bounded budget.- An expired quote: request and verify a fresh quote before funding.
refundableorexpired: inspect the refund path. These states do not mean the source funds have returned.
