Create a new gateway order.

Creates a new request, reserves the required liquidity.

POST /v2/create-order

Create a new gateway order.

cURL

curl --request POST \
  --url https://gateway-api-mainnet.gobob.xyz/v2/create-order \
  --header 'Content-Type: application/json' \
  --data '
{
  "onramp": {
    "dstChain": "<string>",
    "dstToken": "<string>",
    "executionFees": {
      "address": "<string>",
      "amount": "<string>",
      "chain": "<string>",
      "usd": "<string>"
    },
    "feeBreakdown": {
      "affiliateFee": {
        "address": "<string>",
        "amount": "<string>",
        "chain": "<string>",
        "usd": "<string>"
      },
      "executionFee": {
        "address": "<string>",
        "amount": "<string>",
        "chain": "<string>",
        "usd": "<string>"
      },
      "layerzeroFee": {
        "address": "<string>",
        "amount": "<string>",
        "chain": "<string>",
        "usd": "<string>"
      },
      "protocolFee": {
        "address": "<string>",
        "amount": "<string>",
        "chain": "<string>",
        "usd": "<string>"
      },
      "solverFee": {
        "address": "<string>",
        "amount": "<string>",
        "chain": "<string>",
        "usd": "<string>"
      }
    },
    "fees": {
      "address": "<string>",
      "amount": "<string>",
      "chain": "<string>",
      "usd": "<string>"
    },
    "inputAmount": {
      "address": "<string>",
      "amount": "<string>",
      "chain": "<string>",
      "usd": "<string>"
    },
    "outputAmount": {
      "address": "<string>",
      "amount": "<string>",
      "chain": "<string>",
      "usd": "<string>"
    },
    "recipient": "<string>",
    "signedQuoteData": "<string>",
    "slippage": "<string>",
    "token": "<string>",
    "affiliateAddress": "<string>",
    "affiliates": [
      {
        "address": "<string>",
        "fee": {
          "address": "<string>",
          "amount": "<string>",
          "chain": "<string>",
          "usd": "<string>"
        }
      }
    ],
    "estimatedTimeInSecs": 1,
    "gasRefill": "<string>",
    "priceImpact": "<string>",
    "priceImpactUsd": "<string>",
    "sender": "<string>",
    "strategyAddress": "<string>",
    "strategyMessage": "<string>"
  }
}
'

201

{
  "onramp": {
    "address": "<string>",
    "order_id": "f81d4fae-7dec-11d0-a765-00a0c91e6bf6",
    "op_return_data": "<string>",
    "psbt_hex": "<string>"
  }
}

Body

application/json

Option 1

Option 2

Option 3

Gateway quote.

onramp · object · required

V2 onramp quote: identical to V1 plus a resolved affiliates list. Kept as a separate type so the V1 OpenAPI schema stays frozen.

Show child attributes

Response

201

application/json

Created order

Option 1

Option 2

Option 3

V2 create-order response

onramp · object · required

Show child attributes