Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
onchain-quotes
curl --request POST \
  --url https://api.services.payward.com/v1/accounts/{account_id}/onchain-quotes \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-otp: <api-key>' \
  --header 'api-sign: <api-key>' \
  --data '
{
  "from": {
    "symbol": "USDC",
    "type": "stablecoin",
    "amount": "1853.40",
    "wallet": {
      "address": "0x8888...8888",
      "network": "ethereum"
    }
  },
  "to": {
    "symbol": "TSLAx",
    "type": "xstock"
  }
}
'
{
  "data": {
    "id": "XQAAAAAAAAAAA1",
    "status": "offered",
    "expires_at": "2026-04-23T16:00:30Z",
    "from": {
      "symbol": "USDC",
      "name": "USD Coin",
      "type": "stablecoin",
      "amount": "1853.40"
    },
    "to": {
      "symbol": "TSLAx",
      "name": "Tesla xStock",
      "type": "xstock",
      "amount": "10"
    },
    "execution_details": {
      "chain_id": "1",
      "proxy_address": "0x1111...1111",
      "proxy_swap_message": {
        "atomic_message": {
          "quote_id": "0x3333...3333",
          "expiration": 1777034103,
          "incoming_transfer": {
            "from": "0x1111...1111",
            "to": "0x4444...4444",
            "token": "0x5555...5555",
            "amount": "1853400000"
          },
          "outgoing_transfer": {
            "from": "0x4444...4444",
            "to": "0x1111...1111",
            "token": "0x6666...6666",
            "amount": "10000000000000000000"
          }
        },
        "atomic_signature": "0xaaaa...aaaa",
        "signature": "0x40e9...221c",
        "client_address": "0x8888...8888"
      }
    }
  }
}

Authorizations

​
api-key
string
header
required
​
api-sign
string
header
required
​
api-nonce
string
header
required
​
api-otp
string
header
required

Path Parameters

​
account_id
string
required

ID of the account the request applies to. This refers to one of the accounts held by the user the request is acting on behalf of (typically the user's main account, but any of the user's accounts is accepted). Routes the request to that specific account container. Canonical identifier for an account in the Payward public API.

Required string length: 14 - 42

Body

application/json

Request to create a new wallet-funded onchain quote.

Exactly one of from.amount or to.amount must be provided to indicate which side of the trade is fixed. The server calculates the other side. Requests that set both amounts or omit both are rejected with a 400 Bad Request.

​
from
object
required

Source side of a create-onchain-quote request.

​
to
object
required

Destination side of a create-onchain-quote request.

Response

Successful response

​
data
object

Full representation of an onchain quote.