To use the platform.getBalance method on the P-Chain, ensure that the end of your URL includes ext/bc/P.

Parameters

addresses

array

REQUIRED

An array of address strings

Returns

balance

string

The total token balance.

unlocked

string

The unlocked token balance.

lockedStakeable

string

The locked stakeable token balance.

lockedNotStakeable

string

The locked and not stakeable token balance.

balances

object

A mapping of addresses to their respective balances in atomic units

unlockeds

object

A mapping of addresses to their respective unlocked balances

lockedStakeables

object

A mapping of an address to its locked stakeable balance

lockedNotStakeables

object

A mapping of an address to its not locked stakeable balance

utxoIDs

array

A array of UTXO (Unspent Transaction Output) IDs, with each entry containing a transaction ID and output index

txID

string

The transaction id

outputIndex

integer

The output index

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": "platform.getBalance",
6
  "params": {
7
    "addresses": [
8
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
9
    ]
10
  },
11
  "id": 1
12
}'

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": "platform.getBalance",
6
  "params": {
7
    "addresses": [
8
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
9
    ]
10
  },
11
  "id": 1
12
}'

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("platform.getBalance", {
6
    "addresses": [
7
        "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
8
    ]
9
});
10
    console.log(response);
11
}
12

13
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("platform.getBalance", {
6
    "addresses": [
7
        "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
8
    ]
9
});
10
    console.log(response);
11
}
12

13
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("platform.getBalance", {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]})
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("platform.getBalance", {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]})
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: 'platform.getBalance',
10
        params: {
11
          "addresses": [
12
            "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
          ]
14
        }
15
    })
16

17
    console.log(result)
18
}
19

20
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: 'platform.getBalance',
10
        params: {
11
          "addresses": [
12
            "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
          ]
14
        }
15
    })
16

17
    console.log(result)
18
}
19

20
main()

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'platform.getBalance',
7
  {
8
  "addresses": [
9
    "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
  ]
11
},
12
  undefined,
13
  'https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'
14
)
15

16
console.log(result)

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

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'platform.getBalance',
7
  {
8
  "addresses": [
9
    "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
  ]
11
},
12
  undefined,
13
  'https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/'
14
)
15

16
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
        "platform.getBalance",
8
        {
9
            "addresses": [
10
                "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
11
            ]
12
        },
13
        endpoint_url="https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/",
14
    )
15
    print(result)
16

17
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
        "platform.getBalance",
8
        {
9
            "addresses": [
10
                "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
11
            ]
12
        },
13
        endpoint_url="https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/",
14
    )
15
    print(result)
16

17
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: "platform.getBalance",
7
  params: {
8
    "addresses" => [
9
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
    ]
11
  },
12
  endpoint_url: "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
13
)
14

15
puts result

1
require "quicknode_sdk"
2

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

5
result = qn.rpc.call(
6
  method: "platform.getBalance",
7
  params: {
8
    "addresses" => [
9
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
10
    ]
11
  },
12
  endpoint_url: "https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/"
13
)
14

15
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
            "platform.getBalance",
10
            Some(serde_json::json!({
11
    "addresses": [
12
        "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
    ]
14
})),
15
            None,
16
            Some("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

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
            "platform.getBalance",
10
            Some(serde_json::json!({
11
    "addresses": [
12
        "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
13
    ]
14
})),
15
            None,
16
            Some("https://docs-demo.flare-mainnet.quiknode.pro/ext/bc/C/rpc/".into()),
17
        )
18
        .await?;
19

20
    println!("{result}");
21
    Ok(())
22
}

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'platform.getBalance',
4
    params: {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]},
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: 'platform.getBalance',
4
    params: {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]},
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": "platform.getBalance",
9
  "params": {
10
    "addresses": [
11
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
12
    ]
13
  },
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
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": "platform.getBalance",
9
  "params": {
10
    "addresses": [
11
      "P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"
12
    ]
13
  },
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
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: "platform.getBalance",
11
  params: {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]}
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: "platform.getBalance",
11
  params: {"addresses":["P-flare1ljm5j7ku39shkern8peyg223axa9m0z30cl63c"]}
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
    "balance": "5659807676",
6
    "unlocked": "5659807676",
7
    "lockedStakeable": "0",
8
    "lockedNotStakeable": "0",
9
    "balances": {
10
      "2MxKSeEWXViLdYyDhW1SQ46AECZEbE2bnVRZptv42JrxqyUX5k": "5659807676"
11
    },
12
    "unlockeds": {
13
      "2MxKSeEWXViLdYyDhW1SQ46AECZEbE2bnVRZptv42JrxqyUX5k": "5659807676"
14
    },
15
    "lockedStakeables": {},
16
    "lockedNotStakeables": {},
17
    "utxoIDs": [
18
      {
19
        "txID": "2mgNobrqvuqQixoQvibWegh7Z8nd2WjufQTmfSVr1F9k69adKC",
20
        "outputIndex": 0
21
      }
22
    ]
23
  }
24
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "balance": "5659807676",
6
    "unlocked": "5659807676",
7
    "lockedStakeable": "0",
8
    "lockedNotStakeable": "0",
9
    "balances": {
10
      "2MxKSeEWXViLdYyDhW1SQ46AECZEbE2bnVRZptv42JrxqyUX5k": "5659807676"
11
    },
12
    "unlockeds": {
13
      "2MxKSeEWXViLdYyDhW1SQ46AECZEbE2bnVRZptv42JrxqyUX5k": "5659807676"
14
    },
15
    "lockedStakeables": {},
16
    "lockedNotStakeables": {},
17
    "utxoIDs": [
18
      {
19
        "txID": "2mgNobrqvuqQixoQvibWegh7Z8nd2WjufQTmfSVr1F9k69adKC",
20
        "outputIndex": 0
21
      }
22
    ]
23
  }
24
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free