Parameters

object

object

REQUIRED

The ripple_path_find request object.

destination_account

string

REQUIRED

The unique address of the account that would receive funds in a transaction

destination_amount

object

REQUIRED

The amount that the destination account will recieve. It contains the following fields:

currency

string

The currency of the destination amount

issuer

string

The issuer of the currency

value

string

The value of the destination amount

source_account

string

REQUIRED

The unique address of the account that would send funds in a transaction

source_currencies

array

An array of currencies that the source account might want to spend

currency

string

The currency of the source amount

Returns

result

object

An object which contains the following fields:

alternatives

array

An array of objects with possible paths to take

destination_account

string

The unique address of the account that would receive a payment transaction

destination_amount

object

The currency Amount that the destination account would receive in a transaction

currency

string

The currency of the destination amount

issuer

string

The issuer of the currency

value

string

The value of the destination amount

destination_currencies

string

An array of strings representing the currencies that the destination accepts, as 3-letter codes like USD or as 40-character hex like 015841551A748AD2C1F76FF6ECB0CCCD00000000

full_reply

boolean

If true, then this is the best path that network can find as of the current ledger

source_account

string

The source account

status

string

The status of the request

warnings

array

An array of warning objects, each containing the following fields:

id

integer

The ID of the warning

message

string

The warning message

Request

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "ripple_path_find",
6
  "params": [
7
    {
8
      "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
9
      "destination_amount": {
10
        "currency": "USD",
11
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
12
        "value": "0.001"
13
      },
14
      "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
15
      "source_currencies": [
16
        {
17
          "currency": "XRP"
18
        },
19
        {
20
          "currency": "USD"
21
        }
22
      ]
23
    }
24
  ],
25
  "id": 1
26
}'

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "ripple_path_find",
6
  "params": [
7
    {
8
      "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
9
      "destination_amount": {
10
        "currency": "USD",
11
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
12
        "value": "0.001"
13
      },
14
      "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
15
      "source_currencies": [
16
        {
17
          "currency": "XRP"
18
        },
19
        {
20
          "currency": "USD"
21
        }
22
      ]
23
    }
24
  ],
25
  "id": 1
26
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'ripple_path_find',
4
    params: [{"destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","destination_amount":{"currency":"USD","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","value":"0.001"},"source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","source_currencies":[{"currency":"XRP"},{"currency":"USD"}]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'ripple_path_find',
4
    params: [{"destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","destination_amount":{"currency":"USD","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","value":"0.001"},"source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","source_currencies":[{"currency":"XRP"},{"currency":"USD"}]}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "ripple_path_find",
9
  "params": [
10
    {
11
      "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
12
      "destination_amount": {
13
        "currency": "USD",
14
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
15
        "value": "0.001"
16
      },
17
      "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
18
      "source_currencies": [
19
        {
20
          "currency": "XRP"
21
        },
22
        {
23
          "currency": "USD"
24
        }
25
      ]
26
    }
27
  ],
28
  "id": 1
29
})
30
headers = {
31
  'Content-Type': 'application/json'
32
}
33

34
response = requests.request("POST", url, headers=headers, data=payload)
35

36
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "ripple_path_find",
9
  "params": [
10
    {
11
      "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
12
      "destination_amount": {
13
        "currency": "USD",
14
        "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
15
        "value": "0.001"
16
      },
17
      "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
18
      "source_currencies": [
19
        {
20
          "currency": "XRP"
21
        },
22
        {
23
          "currency": "USD"
24
        }
25
      ]
26
    }
27
  ],
28
  "id": 1
29
})
30
headers = {
31
  'Content-Type': 'application/json'
32
}
33

34
response = requests.request("POST", url, headers=headers, data=payload)
35

36
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "ripple_path_find",
11
  params: [{"destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","destination_amount":{"currency":"USD","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","value":"0.001"},"source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","source_currencies":[{"currency":"XRP"},{"currency":"USD"}]}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "ripple_path_find",
11
  params: [{"destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","destination_amount":{"currency":"USD","issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B","value":"0.001"},"source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","source_currencies":[{"currency":"XRP"},{"currency":"USD"}]}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "result": {
3
    "alternatives": [
4
      {
5
        "paths_canonical": [],
6
        "paths_computed": [
7
          [
8
            {
9
              "currency": "USD",
10
              "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
11
              "type": 48
12
            }
13
          ],
14
          [
15
            {
16
              "currency": "USD",
17
              "issuer": "rsbgrRPMTykHoStSYst8jbqkscAnHCPWY8",
18
              "type": 48
19
            },
20
            {
21
              "account": "rsbgrRPMTykHoStSYst8jbqkscAnHCPWY8",
22
              "type": 1
23
            }
24
          ]
25
        ],
26
        "source_amount": "722"
27
      },
28
      {
29
        "paths_canonical": [],
30
        "paths_computed": [],
31
        "source_amount": {
32
          "currency": "USD",
33
          "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
34
          "value": "0.0010015"
35
        }
36
      }
37
    ],
38
    "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
39
    "destination_amount": {
40
      "currency": "USD",
41
      "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
42
      "value": "0.001"
43
    },
44
    "destination_currencies": [
45
      "JOE",
46
      "MXN",
47
      "USD",
48
      "DYM",
49
      "CNY",
50
      "015841551A748AD2C1F76FF6ECB0CCCD00000000",
51
      "EUR",
52
      "BTC",
53
      "XRP"
54
    ],
55
    "full_reply": true,
56
    "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
57
    "status": "success"
58
  },
59
  "status": "success",
60
  "type": "response",
61
  "forwarded": true,
62
  "warnings": [
63
    {
64
      "id": 2001,
65
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
66
    }
67
  ]
68
}

1
{
2
  "result": {
3
    "alternatives": [
4
      {
5
        "paths_canonical": [],
6
        "paths_computed": [
7
          [
8
            {
9
              "currency": "USD",
10
              "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
11
              "type": 48
12
            }
13
          ],
14
          [
15
            {
16
              "currency": "USD",
17
              "issuer": "rsbgrRPMTykHoStSYst8jbqkscAnHCPWY8",
18
              "type": 48
19
            },
20
            {
21
              "account": "rsbgrRPMTykHoStSYst8jbqkscAnHCPWY8",
22
              "type": 1
23
            }
24
          ]
25
        ],
26
        "source_amount": "722"
27
      },
28
      {
29
        "paths_canonical": [],
30
        "paths_computed": [],
31
        "source_amount": {
32
          "currency": "USD",
33
          "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
34
          "value": "0.0010015"
35
        }
36
      }
37
    ],
38
    "destination_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
39
    "destination_amount": {
40
      "currency": "USD",
41
      "issuer": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
42
      "value": "0.001"
43
    },
44
    "destination_currencies": [
45
      "JOE",
46
      "MXN",
47
      "USD",
48
      "DYM",
49
      "CNY",
50
      "015841551A748AD2C1F76FF6ECB0CCCD00000000",
51
      "EUR",
52
      "BTC",
53
      "XRP"
54
    ],
55
    "full_reply": true,
56
    "source_account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
57
    "status": "success"
58
  },
59
  "status": "success",
60
  "type": "response",
61
  "forwarded": true,
62
  "warnings": [
63
    {
64
      "id": 2001,
65
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
66
    }
67
  ]
68
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free