Skip to main content
POST
/
core
/
transactions
/
quote
curl --request POST \
  --url https://api.enterprise.sandbox.uphold.com/core/transactions/quote \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "origin": {
    "type": "account",
    "id": "b98e4f0d-a67d-4126-a99d-666f7e0315d9"
  },
  "destination": {
    "type": "account",
    "id": "555a99a1-620d-4431-a0ac-b43e1aad2bdc"
  },
  "denomination": {
    "asset": "GBP",
    "amount": "100.00",
    "target": "origin"
  }
}
'
{
  "quote": {
    "id": "623000c8-9bdf-4a2b-aa3d-6a6b44a7f6a0",
    "origin": {
      "amount": "100.00",
      "asset": "GBP",
      "rate": "47619.04761904762",
      "node": {
        "type": "account",
        "id": "b98e4f0d-a67d-4126-a99d-666f7e0315d9",
        "ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
      }
    },
    "destination": {
      "amount": "0.0021",
      "asset": "BTC",
      "rate": "0.000021",
      "node": {
        "type": "account",
        "id": "555a99a1-620d-4431-a0ac-b43e1aad2bdc",
        "ownerId": "e4ce04dc-67b7-4e9f-af91-482cb6f9fc4a"
      }
    },
    "denomination": {
      "amount": "100.00",
      "asset": "GBP",
      "target": "origin",
      "rate": "1"
    },
    "fees": [],
    "requirements": [],
    "expiresAt": "2024-07-24T15:22:39Z"
  }
}

​
Denomination

The denomination property defines the value moved from origin to destination. It consists of two key components:
  • asset: The asset that the amount refers to (typically the same as either the origin, destination, or the user’s national currency)
  • amount: The numerical value to be transferred
  • target: Specifies which side the amount applies to:
    • origin: If selected, the exact defined amount will be debited from the origin
    • destination: If selected, the exact defined amount will be credited to the destination
This distinction helps control who covers any applicable fees in the transaction.

​
Example: Using the target field

Consider a trade of 500 GBP to BTC with a 2% fee: If denomination.target is set to origin, then:
  • Exactly 500 GBP will be debited from the origin
  • The 2% fee (10 GBP) is applied, and the BTC worth of 490 GBP is credited to the destination
If denomination.target is set to destination, then:
  • 500 GBP plus the 2% fee (10 GBP) will be debited from the origin
  • The exact BTC worth of 500 GBP will be credited to the destination
By choosing the appropriate target, you can control whether the sender or recipient bears the transaction costs. For a more comprehensive explanation of the denomination concept in the context of transactions, see the Core Concepts page.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 authentication.

Body

application/json
​
origin
Account · object
required
​
destination
Account · object
required
​
denomination
object
required

Response

Quote created.

​
quote
object
required