Parameters

object

object

REQUIRED

The account_currencies request object.

account

string

REQUIRED

The XRP Ledger account for which the associated currencies are queried

account_index

integer

The account index

ledger_index

string

The ledger index to retrieve the currency information from

strict

boolean

A boolean field indicating whether strict validation should be applied

Returns

result

object

The method returns a JSON object with the following properties:

ledger_hash

string

The hash of the ledger containing the currency information

ledger_index

integer

The index of the ledger containing the currency information

receive_currencies

array

A list of currencies that the account can receive

send_currencies

array

A list of currencies that the account can send

validated

boolean

Indicates if the information is from a validated ledger

status

string

The status of the request

warnings

array

(Optional) A list of warnings. Returned at the JSON-RPC response root on some servers and omitted from the result object

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": "account_currencies",
6
  "params": [
7
    {
8
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
9
      "account_index": 0,
10
      "ledger_index": "validated",
11
      "strict": true
12
    }
13
  ],
14
  "id": 1
15
}'

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": "account_currencies",
6
  "params": [
7
    {
8
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
9
      "account_index": 0,
10
      "ledger_index": "validated",
11
      "strict": true
12
    }
13
  ],
14
  "id": 1
15
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'account_currencies',
4
    params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","account_index":0,"ledger_index":"validated","strict":true}],
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: 'account_currencies',
4
    params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","account_index":0,"ledger_index":"validated","strict":true}],
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": "account_currencies",
9
  "params": [
10
    {
11
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
12
      "account_index": 0,
13
      "ledger_index": "validated",
14
      "strict": True
15
    }
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
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": "account_currencies",
9
  "params": [
10
    {
11
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
12
      "account_index": 0,
13
      "ledger_index": "validated",
14
      "strict": True
15
    }
16
  ],
17
  "id": 1
18
})
19
headers = {
20
  'Content-Type': 'application/json'
21
}
22

23
response = requests.request("POST", url, headers=headers, data=payload)
24

25
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: "account_currencies",
11
  params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","account_index":0,"ledger_index":"validated","strict":true}]
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: "account_currencies",
11
  params: [{"account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59","account_index":0,"ledger_index":"validated","strict":true}]
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
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
4
    "ledger_index": 102609803,
5
    "validated": true,
6
    "receive_currencies": [
7
      "015841551A748AD2C1F76FF6ECB0CCCD00000000",
8
      "BTC",
9
      "CNY",
10
      "DYM",
11
      "EUR",
12
      "JOE",
13
      "MXN",
14
      "USD"
15
    ],
16
    "send_currencies": [
17
      "5553445400000000000000000000000000000000",
18
      "ASP",
19
      "BTC",
20
      "CHF",
21
      "CNY",
22
      "DYM",
23
      "EUR",
24
      "JOE",
25
      "JPY",
26
      "MXN",
27
      "USD"
28
    ],
29
    "status": "success"
30
  },
31
  "warnings": [
32
    {
33
      "id": 2004,
34
      "message": "Some fields from your request are deprecated. Please check the documentation at https://xrpl.org/docs/references/http-websocket-apis/ and update your request. Field 'account_index' is deprecated. Field 'strict' is deprecated."
35
    },
36
    {
37
      "id": 2001,
38
      "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"
39
    }
40
  ]
41
}

1
{
2
  "result": {
3
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
4
    "ledger_index": 102609803,
5
    "validated": true,
6
    "receive_currencies": [
7
      "015841551A748AD2C1F76FF6ECB0CCCD00000000",
8
      "BTC",
9
      "CNY",
10
      "DYM",
11
      "EUR",
12
      "JOE",
13
      "MXN",
14
      "USD"
15
    ],
16
    "send_currencies": [
17
      "5553445400000000000000000000000000000000",
18
      "ASP",
19
      "BTC",
20
      "CHF",
21
      "CNY",
22
      "DYM",
23
      "EUR",
24
      "JOE",
25
      "JPY",
26
      "MXN",
27
      "USD"
28
    ],
29
    "status": "success"
30
  },
31
  "warnings": [
32
    {
33
      "id": 2004,
34
      "message": "Some fields from your request are deprecated. Please check the documentation at https://xrpl.org/docs/references/http-websocket-apis/ and update your request. Field 'account_index' is deprecated. Field 'strict' is deprecated."
35
    },
36
    {
37
      "id": 2001,
38
      "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"
39
    }
40
  ]
41
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free