cfx_getInterestRate

Returns interest rate of the given epoch

Represents rpc api epoch number param.

U64

U64

CURL

curl --request POST \
     --url https://main.confluxrpc.com \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "params": ["0x4350b21"],
  "method": "cfx_getInterestRate"
}'

Params

epoch_number optional

Represents rpc api epoch number param.

oneOf

U64

type : string

Pattern : ^0x([1-9a-f][0-9a-f]{0,15}|0)$

string

type : string

Possible values : 

• earliest
• latest_checkpoint
• latest_finalized
• latest_confirmed
• latest_state
• latest_mined

Result

Schema

type : string

Pattern : ^0x([1-9a-f][0-9a-f]{0,63}|0)$

Examples

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "0x4350b21"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

"0x24b675dc000"

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "latest_mined"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

{
  "code": -32602,
  "message": "Invalid parameters: epoch_num",
  "data": "\"Latest mined epoch is not executed\""
}

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "earliest"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

{
  "code": -32016,
  "message": "Error processing request: State for epoch (number=0 hash=0x3fb9d350f95424c3c27fcf248d9a6f633a83c2a75c11ef887ea41540c85e7804) does not exist: out-of-bound StateAvailabilityBoundary { synced_state_height: 0, lower_bound: 70580001, upper_bound: 70587171, optimistic_executed_height: Some(70587170) }"
}

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "latest_state"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

"0x24b675dc000"

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "latest_confirmed"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

"0x24b675dc000"

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "latest_finalized"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

"0x24b675dc000"

cfx_getInterestRate

Request

curl -X POST --data \
'{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "cfx_getInterestRate",
    "params": [
        "latest_checkpoint"
    ]
}' \
-H "Content-Type: application/json" \
localhost:12539

Response

{
  "code": -32016,
  "message": "Error processing request: State for epoch (number=70500000 hash=0x3dc71e0aa01c258cc1a2415ba54a4fb36a53ba19be4ea3be6e566e879a42ddd0) does not exist: out-of-bound StateAvailabilityBoundary { synced_state_height: 0, lower_bound: 70580001, upper_bound: 70587171, optimistic_executed_height: Some(70587171) }"
}