POST /submit

Build a broadcast-ready transaction for a previously issued quote

curl --request POST \
  --url https://quiet-bloodhound-531.convex.site/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "quoteId": "<string>",
  "user": "<string>",
  "useNativeIn": true,
  "unwrapNativeOut": true,
  "gasPriceWei": "<string>",
  "maxFeePerGasWei": "<string>",
  "maxPriorityFeePerGasWei": "<string>"
}
'

import requests

url = "https://quiet-bloodhound-531.convex.site/submit"

payload = {
    "quoteId": "<string>",
    "user": "<string>",
    "useNativeIn": True,
    "unwrapNativeOut": True,
    "gasPriceWei": "<string>",
    "maxFeePerGasWei": "<string>",
    "maxPriorityFeePerGasWei": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    quoteId: '<string>',
    user: '<string>',
    useNativeIn: true,
    unwrapNativeOut: true,
    gasPriceWei: '<string>',
    maxFeePerGasWei: '<string>',
    maxPriorityFeePerGasWei: '<string>'
  })
};

fetch('https://quiet-bloodhound-531.convex.site/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://quiet-bloodhound-531.convex.site/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'quoteId' => '<string>',
    'user' => '<string>',
    'useNativeIn' => true,
    'unwrapNativeOut' => true,
    'gasPriceWei' => '<string>',
    'maxFeePerGasWei' => '<string>',
    'maxPriorityFeePerGasWei' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://quiet-bloodhound-531.convex.site/submit"

	payload := strings.NewReader("{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://quiet-bloodhound-531.convex.site/submit")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://quiet-bloodhound-531.convex.site/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "quoteId": "<string>",
  "chainId": 123,
  "to": "<string>",
  "data": "<string>",
  "value": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

POST

submit

Build a broadcast-ready transaction for a previously issued quote

curl --request POST \
  --url https://quiet-bloodhound-531.convex.site/submit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "quoteId": "<string>",
  "user": "<string>",
  "useNativeIn": true,
  "unwrapNativeOut": true,
  "gasPriceWei": "<string>",
  "maxFeePerGasWei": "<string>",
  "maxPriorityFeePerGasWei": "<string>"
}
'

import requests

url = "https://quiet-bloodhound-531.convex.site/submit"

payload = {
    "quoteId": "<string>",
    "user": "<string>",
    "useNativeIn": True,
    "unwrapNativeOut": True,
    "gasPriceWei": "<string>",
    "maxFeePerGasWei": "<string>",
    "maxPriorityFeePerGasWei": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    quoteId: '<string>',
    user: '<string>',
    useNativeIn: true,
    unwrapNativeOut: true,
    gasPriceWei: '<string>',
    maxFeePerGasWei: '<string>',
    maxPriorityFeePerGasWei: '<string>'
  })
};

fetch('https://quiet-bloodhound-531.convex.site/submit', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://quiet-bloodhound-531.convex.site/submit",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'quoteId' => '<string>',
    'user' => '<string>',
    'useNativeIn' => true,
    'unwrapNativeOut' => true,
    'gasPriceWei' => '<string>',
    'maxFeePerGasWei' => '<string>',
    'maxPriorityFeePerGasWei' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://quiet-bloodhound-531.convex.site/submit"

	payload := strings.NewReader("{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://quiet-bloodhound-531.convex.site/submit")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://quiet-bloodhound-531.convex.site/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"quoteId\": \"<string>\",\n  \"user\": \"<string>\",\n  \"useNativeIn\": true,\n  \"unwrapNativeOut\": true,\n  \"gasPriceWei\": \"<string>\",\n  \"maxFeePerGasWei\": \"<string>\",\n  \"maxPriorityFeePerGasWei\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "quoteId": "<string>",
  "chainId": 123,
  "to": "<string>",
  "data": "<string>",
  "value": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Use POST /submit to convert a quoteId from POST /quote into the calldata your wallet broadcasts.

Authentication: x-api-key header required.
Quote TTL: quotes expire roughly 10 seconds after /quote. Submitting an expired quoteId returns 404.

Request

Endpoint
Body

POST {API_URL}/submit
Content-Type: application/json
x-api-key: <YOUR_API_KEY>

{
  "quoteId": "a1b2c3d4e5f6...",
  "user": "0xYourWalletAddress",
  "useNativeIn": false,
  "unwrapNativeOut": true
}

Body parameters

Field	Type	Required	Description
`quoteId`	string	yes	The `quoteId` from a recent `/quote` response.
`user`	address	yes	The wallet that will sign and broadcast the transaction.
`useNativeIn`	boolean	no	Override `routePlan.nativeIn`. Set `true` to send native ETH; the router wraps `msg.value` to WETH before dispatching legs.
`unwrapNativeOut`	boolean	no	Override `routePlan.nativeOut`. Set `true` to receive native ETH instead of WETH.
`permit`	object	no	Optional EIP-2612 permit payload for one-tx approve+swap. See `permit` payload below.
`gasPriceWei`	string	no	Hint for legacy gas pricing (`gasPrice`).
`maxFeePerGasWei`	string	no	Hint for EIP-1559 `maxFeePerGas`.
`maxPriorityFeePerGasWei`	string	no	Hint for EIP-1559 `maxPriorityFeePerGas`.

The gas price fields are hints only. They are not currently echoed back into the calldata; your wallet client should set its own gas pricing when broadcasting.

`permit` payload

When you have a fresh EIP-2612 permit signature for tokenIn, include it to skip the standard approve transaction.

{
  "permit": {
    "value": "1000000000",
    "deadline": 1712180600,
    "v": 27,
    "r": "0x...",
    "s": "0x..."
  }
}

Field	Type	Notes
`value`	string	Amount permitted in token base units. Must be `>= amountIn`.
`deadline`	integer	Unix seconds at which the permit expires.
`v` / `r` / `s`	components	EIP-2612 signature pieces.

The router consumes the permit inside the same transaction; if it fails, the whole swap reverts. See ERC-20 approvals for the full pattern.

Response

200 OK
404 Not Found
400 Bad Request
401 Unauthorized
429 Rate Limited

{
  "quoteId": "a1b2c3d4e5f6...",
  "chainId": 8453,
  "to": "0x8Dc736C6BA12e1Df1c73DB6BED8d7573F0aD90B3",
  "data": "0x...",
  "value": "0"
}

{ "error": "quote not found or expired" }

The quoteId either never existed or has aged out of the cache. Re-fetch via /quote and retry.

{ "error": "user is required" }

Other common 400 messages: invalid user address, permit signature invalid.

{ "error": "unauthorized" }

{
  "error": "rate limit exceeded",
  "limit": 120,
  "windowSec": 60
}

Response fields

Field	Type	Description
`quoteId`	string	Echo of the `quoteId` you submitted.
`chainId`	integer	Always `8453` while only Base is supported.
`to`	address	Always the `O1Router` address. See Router contract.
`data`	hex	Encoded `swapExactIn(...)` calldata.
`value`	string	`msg.value` to send with the transaction in wei. Non-zero only for native-in swaps (`useNativeIn: true`).

Sending the transaction

The response is intentionally minimal so any signer works. Example with viem:

const txHash = await walletClient.sendTransaction({
  to: submit.to as `0x${string}`,
  data: submit.data as `0x${string}`,
  value: BigInt(submit.value),
});

ethers v6:

const txResponse = await wallet.sendTransaction({
  to: submit.to,
  data: submit.data,
  value: submit.value,
});

Do not modify data before sending. The router validates the route plan against the submitted quoteId; any tamper attempt will revert.

Native ETH and unwrap behavior

Want to	Set on `/quote`	Set on `/submit`
Sell native ETH	`tokenIn` = native sentinel (`0xEeee...EEeE` or `0x0`)	`useNativeIn: true`
Receive native ETH	`tokenOut` = native sentinel	`unwrapNativeOut: true`

When you sell native ETH, the response value carries amountIn and the router wraps to WETH internally. See the Native ETH guide for the full matrix.

Common pitfalls

404 on /submit

Quote expired. Re-fetch via /quote with the same parameters and resubmit. Don’t cache quoteId longer than expiresAt minus a small safety window.

`value` is 0 for ETH swaps

You forgot useNativeIn: true. The router can’t infer it from tokenIn alone in /submit because the API does not assume the user has changed their mind since /quote.

Tx reverts with slippage error

Pool state moved between /quote and broadcast. Increase slippageBps slightly or re-quote and resend.

Allowance error

The user hasn’t approved the router for tokenIn. Approve O1Router for at least amountIn, or use a permit payload. See ERC-20 approvals.

Authorizations

x-api-key

string

header

required

Body

application/json

quoteId

string

required

user

string

required

20-byte hex address. The sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (or the zero address) signals the chain's native asset (ETH on Base) and is recognized in tokenIn/tokenOut.

Pattern: ^0x[a-fA-F0-9]{40}$

useNativeIn

boolean

Override routePlan.nativeIn. When true the router wraps msg.value to WETH before dispatching legs.

unwrapNativeOut

boolean

Override routePlan.nativeOut. When true the router unwraps WETH to ETH for the recipient.

permit

object

Show child attributes

gasPriceWei

string

Non-negative integer encoded as a decimal string (wei).

Pattern: ^[0-9]+$

maxFeePerGasWei

string

Non-negative integer encoded as a decimal string (wei).

Pattern: ^[0-9]+$

maxPriorityFeePerGasWei

string

Non-negative integer encoded as a decimal string (wei).

Pattern: ^[0-9]+$

Response

Transaction payload

quoteId

string

required

chainId

integer

required

string

required

20-byte hex address. The sentinel 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (or the zero address) signals the chain's native asset (ETH on Base) and is recognized in tokenIn/tokenOut.

Pattern: ^0x[a-fA-F0-9]{40}$

data

string

required

Hex-encoded bytes.

Pattern: ^0x[a-fA-F0-9]*$

value

string

required

msg.value in wei (non-zero only for native-in swaps).

Pattern: ^[0-9]+$

POST /quote POST /execute

Overview

Getting Started

Features

API

Native Token: $O

Community

Request

Body parameters

`permit` payload

Response

Response fields

Sending the transaction

Native ETH and unwrap behavior

Common pitfalls

404 on /submit

`value` is 0 for ETH swaps

Tx reverts with slippage error

Allowance error

Authorizations

Body

Response

​Request

​Body parameters

​permit payload

​Response

​Response fields

​Sending the transaction

​Native ETH and unwrap behavior

​Common pitfalls

404 on /submit

`value` is 0 for ETH swaps

Tx reverts with slippage error

Allowance error

Authorizations

Body

Response

Request

Body parameters

`permit` payload

Response

Response fields

Sending the transaction

Native ETH and unwrap behavior

Common pitfalls