Create an order

curl --request POST \
  --url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order' \
  --header "Content-Type: application/json" \
  --header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
  --header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
  --data '{
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01"
}'

{
  "transfer_quantity": null,
  "order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01",
  "asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
  "symbol": "AAPLx",
  "side": "BUY",
  "status": "PENDING",
  "network": "Ethereum",
  "funding_currency": "USDC",
  "quoted_quantity": "0.00297066689243735",
  "executed_quantity": null,
  "executed_price": null,
  "cash_amount": null,
  "fees": null,
  "total_amount": null,
  "transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
  "failure_code": null,
  "failure_message": null,
  "created_at": "2026-09-21T01:33:08.629Z",
  "updated_at": "2026-09-21T01:33:13.84Z",
  "completed_at": null,
  "failed_at": null
}

POST

order

curl --request POST \
  --url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order' \
  --header "Content-Type: application/json" \
  --header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
  --header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
  --data '{
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01"
}'

{
  "transfer_quantity": null,
  "order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01",
  "asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
  "symbol": "AAPLx",
  "side": "BUY",
  "status": "PENDING",
  "network": "Ethereum",
  "funding_currency": "USDC",
  "quoted_quantity": "0.00297066689243735",
  "executed_quantity": null,
  "executed_price": null,
  "cash_amount": null,
  "fees": null,
  "total_amount": null,
  "transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
  "failure_code": null,
  "failure_message": null,
  "created_at": "2026-09-21T01:33:08.629Z",
  "updated_at": "2026-09-21T01:33:13.84Z",
  "completed_at": null,
  "failed_at": null
}

curl --request POST \
  --url 'https://api-sandbox.uqpaytech.com/api/v1/stocks/order' \
  --header "Content-Type: application/json" \
  --header "x-auth-token: Bearer ${SANDBOX_TOKEN}" \
  --header "x-idempotency-key: ${UNIQUE_IDEMPOTENCY_KEY}" \
  --data '{
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01"
}'

{
  "transfer_quantity": null,
  "order_id": "53fe3d55-85ff-4804-b6f0-a25a32aa082f",
  "quote_id": "0576b03b-56dd-48b1-ba24-058ce90d0f53",
  "client_reference": "stocks-docs-20260921-buy-01",
  "asset_id": "7453f146-b267-11f1-b4f4-0abd773ba497",
  "symbol": "AAPLx",
  "side": "BUY",
  "status": "PENDING",
  "network": "Ethereum",
  "funding_currency": "USDC",
  "quoted_quantity": "0.00297066689243735",
  "executed_quantity": null,
  "executed_price": null,
  "cash_amount": null,
  "fees": null,
  "total_amount": null,
  "transaction_hash": "0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f",
  "failure_code": null,
  "failure_message": null,
  "created_at": "2026-09-21T01:33:08.629Z",
  "updated_at": "2026-09-21T01:33:13.84Z",
  "completed_at": null,
  "failed_at": null
}

Authorizations

x-auth-token

string

header

required

The API token for login provided by UQPAY.

Headers

x-idempotency-key

string<uuid>

required

A unique identifier used to maintain operation idempotency. Use the same key and request body when retrying an operation, and a new key for a new operation.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Body

application/json

quote_id

string<uuid>

required

Quote identifier to submit when creating an order.

Example:

"0576b03b-56dd-48b1-ba24-058ce90d0f53"

client_reference

string | null

Your reference for querying orders. It does not replace the idempotency key.

Required string length: 1 - 100

Example:

"stocks-docs-20260921-buy-01"

Response

Success

order_id

string<uuid>

required

Order identifier used to retrieve an order.

Example:

"53fe3d55-85ff-4804-b6f0-a25a32aa082f"

quote_id

string<uuid> | null

required

Quote used for a trade order. Null for deposit and withdrawal records.

Example:

"0576b03b-56dd-48b1-ba24-058ce90d0f53"

client_reference

string | null

required

Your reference for querying orders. It does not replace the idempotency key.

Example:

"stocks-docs-20260921-buy-01"

asset_id

string<uuid>

required

Asset identifier used across asset, quote, order, and position requests.

Example:

"7453f146-b267-11f1-b4f4-0abd773ba497"

symbol

string

required

Asset symbol.

Example:

"AAPLx"

side

enum<string>

required

Order activity. Trade orders originate from quotes; deposit and withdrawal records describe asset transfers.

Available options:

BUY,

SELL,

DEPOSIT,

WITHDRAWAL

Example:

"BUY"

status

enum<string>

required

Order processing state. Reconcile settled values only after completion.

Available options:

PENDING,

SUCCESS,

FAILED

Example:

"SUCCESS"

network

string | null

required

Network associated with execution or transfer, when available.

Example:

"Ethereum"

funding_currency

string | null

required

Currency used to fund a trade. Null for asset-transfer records.

Example:

"USDC"

quoted_quantity

string | null

required

Quantity from the accepted quote; null when the quote did not fix a quantity or the record is an asset transfer.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"0.00297066689243735"

executed_quantity

string | null

required

Settled quantity for a completed trade; null before settlement.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"0.00297066689243735"

executed_price

string | null

required

Settled trade price per unit in funding_currency. Not an asset-transfer cost basis.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"336.624750000000055741"

cash_amount

string | null

required

Settled trade amount before fees in funding_currency. Null before settlement and for asset-transfer records.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"1"

fees

object[] | null

required

Fees recorded on the completed order. Null means no settled fee information is available.

Show child attributes

Example:

[
  {
    "type": "TRADING",
    "amount": "0.0005",
    "currency": "USDC"
  }
]

total_amount

string | null

required

Settled buy outlay including fees or sell proceeds after fees, in funding_currency. Null before settlement and for asset transfers.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Example:

"1.0005"

transaction_hash

string | null

required

Public transaction hash when available. Null does not by itself indicate that the order failed.

Example:

"0x7e7b7f06c0a4adce2ec2bc01b455fd4e014b9f298e7e2598b02c93dffa86a96f"

failure_code

string | null

required

Business failure identifier on a failed order. This is separate from an HTTP error code.

failure_message

string | null

required

Human-readable explanation of an order failure; null when no failure is reported.

created_at

string<date-time>

required

Time the order was created.

Example:

"2026-09-21T01:33:08.629Z"

updated_at

string<date-time>

required

Time the order was last updated.

Example:

"2026-09-21T01:50:53.855Z"

completed_at

string<date-time> | null

required

Settlement completion time; null until the order completes.

Example:

"2026-09-21T01:50:53.561Z"

failed_at

string<date-time> | null

required

Time of terminal failure; null when the order has not failed.

transfer_quantity

string | null

required

Asset quantity for a deposit or withdrawal. Null for buy and sell orders.

Pattern: ^-?[0-9]+(\.[0-9]+)?$

Stablecoin Account API

Stocks API

Authorizations

Headers

Body

Response