# Price request

Request a price, prices are subject to change based on market volatility and network congestion.

Endpoint: GET /eapi/v0/price
Version: 0 BETA
Security: HMACAuth

## Query parameters:

  - `identityReference` (string, required)
    A unique customer identifier provided by you. This field is required and must be unique for each customer. Please ensure you consistently reuse the same identityReference for repeat interactions with the same customer, allowing us to reliably recognize and associate their identity.
    Example: "c-13344"

  - `fiat` (string, required)
    The desired fiat
    Example: "AUD"

  - `crypto` (string, required)
    The desired crypto
    Example: "USDT"

  - `method` (string, required)
    The payment method
    Example: "payid-bank-transfer"

  - `blockchain` (string, required)
    The chain for the crypto currency e.g. TRON or ETH
    Example: "TRON"

  - `transactionType` (string)
    The type of transaction
    Enum: "ONRAMP", "OFFRAMP"

  - `fiatAmount` (number)
    Required without cryptoAmount
The amount in fiat currency to convert.
Amount in fiat minor precision (typically 2 decimals).
This locks the fiat amount; the crypto amount will be computed and rounded to the configured crypto scale.
Note: due to differing decimal scales and rounding rules, converting fiat→crypto and then crypto→fiat may not return the exact original number..

  - `cryptoAmount` (number)
    Required without fiatAmount
Amount in crypto precision (token-dependent, e.g., 6–8 decimals).
This locks the crypto amount; the fiat amount will be computed and rounded to the fiat scale.
Note: small differences vs the reverse path are expected from precision/rounding.

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Bad Request"

  - `status` (integer)
    Example: 400

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

  - `status` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `message` (string)
    Example: "Not Found"

  - `status` (integer)
    Example: 404

## Response 422 fields (application/json):

  - `message` (string)
    Example: "The given data was invalid."

  - `errors` (object)

  - `status` (integer)
    Example: 422

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

  - `status` (integer)
    Example: 500

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"