Skip to main content

List Strict Receive Payment Paths REST API Endpoint

Lists the paths a payment can take based on the amount of an asset you want the recipient to receive. The destination asset amount stays constant, and the type and amount of an asset sent varies based on offers in the order books

Updated on
Sep 05, 2025

Query Parameters

source_account
string

The Stellar address of the sender. Any returned path must start with an asset that the sender holds. Using either source_account or source_assets as an argument is required for strict receive path payments

source_assets
string

A comma-separated list of assets available to the sender. Any returned path must start with an asset in this list. Each asset is formatted as CODE:ISSUER_ACCOUNT. For example: USD:GDUKMGUGDZQK6YHYA5Z6AY2G4XDSZPSZ3SW5UN3ARVMO6QSRDWP5YLEX. Using either source_account or source_assets as an argument is required for strict receive path payments

destination_asset_type
string
REQUIRED

The type for the destination asset. Either 'native', 'credit_alphanum4', or 'credit_alphanum12'

destination_asset_issuer
string

The Stellar address of the issuer of the destination asset. Required if the destination_asset_type is not 'native'

destination_asset_code
string

The code for the destination asset. Required if the destination_asset_type is not 'native'

destination_amount
string
REQUIRED

The amount of the destination asset that should be received

Returns

_embedded
object

The embedded records containing the payment paths

records
array

An array of payment path records

source_asset_type
string

The type of the source asset

source_asset_code
string

(Optional) The code of the source asset. Only present when source_asset_type is not 'native'

source_asset_issuer
string

(Optional) The issuer of the source asset. Only present when source_asset_type is not 'native'

source_amount
string

The amount of the source asset that needs to be sent

destination_asset_type
string

The type of the destination asset

destination_asset_code
string

The code of the destination asset

destination_asset_issuer
string

The issuer of the destination asset

destination_amount
string

The amount of the destination asset that will be received

path
array

An array of assets that represents the path from source to destination

asset_type
string

The type of the asset in the path

asset_code
string

The code of the asset in the path

asset_issuer
string

The issuer of the asset in the path

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free