To use the avax.getUTXOs method on the C-Chain, ensure that the end of your URL includes ext/bc/C/avax.

Parameters

addresses

array

REQUIRED

An array of addresses

limit

integer

The limit ofUTXOs to return. If limit is omitted or greater than 1024, it is set to 1024

sourceChain

string

REQUIRED

The source chain to retrieve UTXOs from. Used for cross-chain transfers

encoding

string

The encoding format to use. Only hex is supported when a value is provided

startIndex

object

If startIndex is omitted, it will fetch all UTXOs up to a limit. When using pagination (i.e when startIndex is provided), UTXOs are not guaranteed to be unique across multiple calls. That is, a UTXO may appear in the result of the first call, and then again in the second call

address

string

The starting address for pagination

Returns

result

object

The result of the UTXO query

numFetched

string

The number of UTXOs fetched

utxos

array

The list of UTXOs returned by the query

endIndex

object

The end index for the UTXO fetching process

address

string

The address for the end index

utxo

string

The UTXO ID for the end index

encoding

string

The encoding format used for the UTXOs

Request

1
curl -X POST "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "avax.getUTXOs",
6
  "params": {
7
    "addresses": [
8
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
9
    ],
10
    "limit": 1024,
11
    "sourceChain": "X",
12
    "encoding": "hex"
13
  },
14
  "id": 1
15
}'

1
curl -X POST "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "avax.getUTXOs",
6
  "params": {
7
    "addresses": [
8
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
9
    ],
10
    "limit": 1024,
11
    "sourceChain": "X",
12
    "encoding": "hex"
13
  },
14
  "id": 1
15
}'

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/");
5
    const response = await provider.send("avax.getUTXOs", {
6
    "addresses": [
7
        "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
8
    ],
9
    "limit": 1024,
10
    "sourceChain": "X",
11
    "encoding": "hex"
12
});
13
    console.log(response);
14
}
15

16
main();

1
import { ethers } from "ethers";
2

3
async function main() {
4
    const provider = new ethers.JsonRpcProvider("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/");
5
    const response = await provider.send("avax.getUTXOs", {
6
    "addresses": [
7
        "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
8
    ],
9
    "limit": 1024,
10
    "sourceChain": "X",
11
    "encoding": "hex"
12
});
13
    console.log(response);
14
}
15

16
main();

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'))
3
response = w3.provider.make_request("avax.getUTXOs", {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"})
4
print(response)

1
from web3 import Web3, HTTPProvider
2
w3 = Web3(HTTPProvider('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'))
3
response = w3.provider.make_request("avax.getUTXOs", {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"})
4
print(response)

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/')
6
    })
7

8
    const result = await client.request({
9
        method: 'avax.getUTXOs',
10
        params: {
11
          "addresses": [
12
            "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
          ],
14
          "limit": 1024,
15
          "sourceChain": "X",
16
          "encoding": "hex"
17
        }
18
    })
19

20
    console.log(result)
21
}
22

23
main()

1
import { createPublicClient, http } from 'viem'
2

3
async function main() {
4
    const client = createPublicClient({
5
        transport: http('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/')
6
    })
7

8
    const result = await client.request({
9
        method: 'avax.getUTXOs',
10
        params: {
11
          "addresses": [
12
            "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
          ],
14
          "limit": 1024,
15
          "sourceChain": "X",
16
          "encoding": "hex"
17
        }
18
    })
19

20
    console.log(result)
21
}
22

23
main()

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'avax.getUTXOs',
7
  {
8
  "addresses": [
9
    "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
  ],
11
  "limit": 1024,
12
  "sourceChain": "X",
13
  "encoding": "hex"
14
},
15
  undefined,
16
  'https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'
17
)
18

19
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'avax.getUTXOs',
7
  {
8
  "addresses": [
9
    "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
  ],
11
  "limit": 1024,
12
  "sourceChain": "X",
13
  "encoding": "hex"
14
},
15
  undefined,
16
  'https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'
17
)
18

19
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "avax.getUTXOs",
8
        {
9
            "addresses": [
10
                "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
11
            ],
12
            "limit": 1024,
13
            "sourceChain": "X",
14
            "encoding": "hex"
15
        },
16
        endpoint_url="https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "avax.getUTXOs",
8
        {
9
            "addresses": [
10
                "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
11
            ],
12
            "limit": 1024,
13
            "sourceChain": "X",
14
            "encoding": "hex"
15
        },
16
        endpoint_url="https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/",
17
    )
18
    print(result)
19

20
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "avax.getUTXOs",
7
  params: {
8
    "addresses" => [
9
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
    ],
11
    "limit" => 1024,
12
    "sourceChain" => "X",
13
    "encoding" => "hex"
14
  },
15
  endpoint_url: "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
16
)
17

18
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "avax.getUTXOs",
7
  params: {
8
    "addresses" => [
9
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
    ],
11
    "limit" => 1024,
12
    "sourceChain" => "X",
13
    "encoding" => "hex"
14
  },
15
  endpoint_url: "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
16
)
17

18
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "avax.getUTXOs",
10
            Some(serde_json::json!({
11
    "addresses": [
12
        "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
    ],
14
    "limit": 1024,
15
    "sourceChain": "X",
16
    "encoding": "hex"
17
})),
18
            None,
19
            Some("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "avax.getUTXOs",
10
            Some(serde_json::json!({
11
    "addresses": [
12
        "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
    ],
14
    "limit": 1024,
15
    "sourceChain": "X",
16
    "encoding": "hex"
17
})),
18
            None,
19
            Some("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/".into()),
20
        )
21
        .await?;
22

23
    println!("{result}");
24
    Ok(())
25
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'avax.getUTXOs',
4
    params: {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/', {
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: 'avax.getUTXOs',
4
    params: {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"},
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/', {
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.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "avax.getUTXOs",
9
  "params": {
10
    "addresses": [
11
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
12
    ],
13
    "limit": 1024,
14
    "sourceChain": "X",
15
    "encoding": "hex"
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.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "avax.getUTXOs",
9
  "params": {
10
    "addresses": [
11
      "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
12
    ],
13
    "limit": 1024,
14
    "sourceChain": "X",
15
    "encoding": "hex"
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.flare-mainnet.quiknode.pro/ext/bc/C/rpc/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "avax.getUTXOs",
11
  params: {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"}
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.flare-mainnet.quiknode.pro/ext/bc/C/rpc/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "avax.getUTXOs",
11
  params: {"addresses":["C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"],"limit":1024,"sourceChain":"X","encoding":"hex"}
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
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "numFetched": "0",
6
    "utxos": [],
7
    "endIndex": {
8
      "address": "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c",
9
      "utxo": "11111111111111111111111111111111LpoYY"
10
    },
11
    "encoding": "hex"
12
  }
13
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "numFetched": "0",
6
    "utxos": [],
7
    "endIndex": {
8
      "address": "C-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c",
9
      "utxo": "11111111111111111111111111111111LpoYY"
10
    },
11
    "encoding": "hex"
12
  }
13
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free