curl --request POST --url https://relay.testnet.kuru.io/relay \
--header "Authorization: Bearer $KURU_RELAY_JWT" \
--header 'Content-Type: application/json' \
--data '{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","method":"wallet.execute_fok_swap","wallet":"0x1111111111111111111111111111111111111111","payload":{"header":{"accountId":"123","market":"0x0A082280e4eA3D822E23Ec1186685477241A039d","authNonce":"1","nonce":"1792480000001","deadline":"1792500000","clientOrderId":"0x0000000000000000000000000000000000000000000000000000000000000001","builder":"0x0000000000000000000000000000000000000000","builderFeePps":"0"},"order":{"side":"BUY","quantity":"10000000000","limitPrice":"30000000"},"signature":"0x..."}}'
{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","status":"BROADCAST","txHash":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","sponsorAddress":"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","sponsorNonce":"42","transactionType":"DYNAMIC_FEE"}
Opt-in operational REST methods
Execute FOK swap
Submit wallet.execute_fok_swap through the opt-in Relay operational path.
POST
/
relay
curl --request POST --url https://relay.testnet.kuru.io/relay \
--header "Authorization: Bearer $KURU_RELAY_JWT" \
--header 'Content-Type: application/json' \
--data '{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","method":"wallet.execute_fok_swap","wallet":"0x1111111111111111111111111111111111111111","payload":{"header":{"accountId":"123","market":"0x0A082280e4eA3D822E23Ec1186685477241A039d","authNonce":"1","nonce":"1792480000001","deadline":"1792500000","clientOrderId":"0x0000000000000000000000000000000000000000000000000000000000000001","builder":"0x0000000000000000000000000000000000000000","builderFeePps":"0"},"order":{"side":"BUY","quantity":"10000000000","limitPrice":"30000000"},"signature":"0x..."}}'
{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","status":"BROADCAST","txHash":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","sponsorAddress":"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","sponsorNonce":"42","transactionType":"DYNAMIC_FEE"}
Submits
wallet.execute_fok_swap when this method is enabled for the selected deployment. This is a slow operational method, not the low-latency trading path. Relay validates the typed request and signature where applicable, simulates the exact call against latest, and only then queues a sponsored transaction. See Operational methods for availability, gas, and latency rules.
The example uses testnet WETH/USDC where a market is required, but all identities, nonces, timestamps, hashes, and signatures are illustrative. Read current state and build a fresh valid signature for the selected network. Omit
authorization7702 and makerSlotsPrimed; complete delegation first.string
required
New lowercase UUIDv7 for request correlation.
string
default:"wallet.execute_fok_swap"
required
Must be
wallet.execute_fok_swap.string
required
Trading wallet matching the bearer JWT; for AccountCore operations this is the sponsoring frontend identity, not necessarily the signed authorizer.
object
required
Method-specific payload shown below; unknown fields are rejected.
order.quantity is base size and order.limitPrice is a protection bound, both in native market precision. The full quantity must fill or execution reverts. This is a base-quantity marketable limit order, not an exact-input swap. Resting-order min/max notional checks do not apply to this FOK request, matching batch FOK policy. For latency-sensitive FOK, use the existing fast wallet.execute_batch path.
Sign the exact EIP-712 type below using the KuruTradingWallet version 2, with the delegated trading wallet as verifyingContract and the selected chain ID (143 mainnet; 10143 testnet):
FokSwapIntent(uint40 accountId,address market,uint256 authNonce,uint64 nonce,uint64 deadline,bytes32 clientOrderId,address builder,uint32 builderFeePps,uint8 side,uint96 quantity,uint32 limitPrice)
curl --request POST --url https://relay.testnet.kuru.io/relay \
--header "Authorization: Bearer $KURU_RELAY_JWT" \
--header 'Content-Type: application/json' \
--data '{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","method":"wallet.execute_fok_swap","wallet":"0x1111111111111111111111111111111111111111","payload":{"header":{"accountId":"123","market":"0x0A082280e4eA3D822E23Ec1186685477241A039d","authNonce":"1","nonce":"1792480000001","deadline":"1792500000","clientOrderId":"0x0000000000000000000000000000000000000000000000000000000000000001","builder":"0x0000000000000000000000000000000000000000","builderFeePps":"0"},"order":{"side":"BUY","quantity":"10000000000","limitPrice":"30000000"},"signature":"0x..."}}'
{"requestId":"018f5ef2-88a1-7b41-a826-4b679010f87f","status":"BROADCAST","txHash":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","sponsorAddress":"0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","sponsorNonce":"42","transactionType":"DYNAMIC_FEE"}
BROADCAST means scheduling for asynchronous RPC broadcast, not provider acceptance or successful execution. Check the receipt and expected events/state. A failed estimate returns an immediate error with no transaction signed or broadcast.