Skip to content

Price (Indicative)

Indicative Pricing - Get real-time, non-persisted price estimates for cryptocurrency transactions.

The price endpoint returns an indicative price that is not stored or locked. It carries no quoteId and cannot be referenced when creating a ramp transaction. For a locked quote that can be used to create a ramp, use the GET /eapi/v0/quote endpoint.

Key Features:

  • Real-time market rates
  • Includes all fees (processing + network)
  • Lock fiat OR crypto amount

Important Notes:

  • Prices are indicative and not persisted
  • Prices fluctuate with market conditions
  • Don't cache prices for more than 1 minute
  • Use the Quote endpoint to obtain a locked, referenceable quote

Use Cases:

  • Display indicative price to customer
  • Transaction previews and fee breakdowns
  • UI price tickers and estimates
Operations

Indicative price request

Request

Request an indicative, non-persisted price. The returned price is a point-in-time estimate and is not stored or locked — it carries no quoteId and cannot be referenced later.

Use this endpoint for display purposes, transaction previews, or fee breakdowns. For a locked price that can be used to create a ramp transaction, use the GET /eapi/v0/quote endpoint instead.

Prices are subject to change based on market volatility and network congestion.

Security
HMACAuth
Query
identityReferencestringrequired

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:identityReference=c-13344
fiatstringrequired

The desired fiat

Example:fiat=AUD
cryptostringrequired

The desired crypto

Example:crypto=USDT
methodstringrequired

The payment method.

Available payments
debit-credit-card
apple-pay
sepa-bank-transfer
gbp-bank-transfer
ach-bank-transfer
pix
zar-bank-transfer
interac-bank-transfer
ideal-bank-transfer
google-pay
payid-bank-transfer
wire-transfer
spei
pse
khipu
aud-bank-transfer
usd-bank-transfer
paypal
klarna-paynow
Example:method=payid-bank-transfer
blockchainstringrequired

The chain for the crypto currency e.g. TRON or ETH

Example:blockchain=TRON
transactionTypestring

The type of transaction

Enum:"ONRAMP""OFFRAMP"
Example:transactionType=ONRAMP
fiatAmountnumber, >= 10

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..

cryptoAmountnumber, >= 0.01

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.

curl -i -X GET \
  'https://docs.banxa.com/_mock/products/native-api/openapi/eapi/v0/price?identityReference=c-13344&fiat=AUD&crypto=USDT&method=payid-bank-transfer&blockchain=TRON&transactionType=ONRAMP&fiatAmount=10&cryptoAmount=0.01' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Prices are subject to change due to market volatility and network congestion, therefore it's not recommended to cache this response for longer than 1 minute.

Indicative price response. This price is not persisted and cannot be used to create a ramp transaction.

Bodyapplication/json
One of:
identityReferencestring, [ 1 .. 255 ] characters(Identity Reference)^[A-Za-z0-9-]+$required

A unique customer identifier provided by the partner. This field is required and must be unique for each customer.

Important: You must consistently reuse the same identityReference for repeat interactions with the same customer, allowing Banxa to reliably recognize and associate their identity across multiple transactions.

Format Requirements:

  • Only ASCII letters (a-z, A-Z), digits (0-9), and hyphens (-) are allowed
  • Must be between 1 and 255 characters
  • Case-sensitive

Best Practices:

  • Use a consistent format across your system
  • Consider using a prefix to identify your organization (e.g., 'partner-customer-123')
  • Do not include personally identifiable information (PII) in the reference
  • Store the mapping between your internal customer ID and this reference securely
Example:"c-13344"
sourceobjectrequired
targetobjectrequired
processingFeestringrequired

The processing fee associated with the price.

Example:"1.00"
networkFeestringrequired

The network fee (gas fee) associated with the price.

Example:"1.00"
marketRateobject(Market Rates)required

Current market rates for crypto and forex conversions.

Purpose: Provides transparency on the exchange rates used for the quote calculation.

Components:

  • crypto: Map of fiat currencies to crypto market rates
  • forex: Foreign exchange rates relative to reference currency
Response
Customer wants to spend exactly 100 AUD to buy USDT on TRON
{
  "identityReference": "customer-12345",
  "source": {
    "fiat": { … },
    "amount": "100.00"
  },
  "target": {
    "crypto": { … },
    "amount": "95.50"
  },
  "processingFee": "2.50",
  "networkFee": "2.00",
  "marketRate": {
    "crypto": { … },
    "forex": { … }
  }
}
© Banxa 2026