JSON-RPC API

1 Account

Generate New Wallet

Request:

{
    "method": "wallet_propose"
}
Field Type Description
method string RPC interface name

Response:

{
    "result": {
        "account_id": "bPnysEutjupUykHmxxKaFNsmTQQ4zqS56f",
        "key_type": "secp256k1",
        "master_key": "RICE WALL HISS BLUE AUTO MINK MOSS AWL TRAY HAST SHAY JUDE",
        "master_seed": "ssg4x********************gGL4",
        "master_seed_hex": "46A33DCABC9F40BF78F5E42C63D61ECF",
        "public_key": "aB4oK4oDfVDUUi42RR3z7PZo8hmxPQQvdE9AxxPfQ5vMknoBa3DX",
        "public_key_hex": "026ED8327BCABC3DEC585D4E55487A9B2BCB47D39F020DEBED05B9E1B7CAA6D86B",
        "status": "success"
    }
}
Field Type Description
account_id string Account address
key_type string Generates the encryption algorithm for the account.
master_key string Mnemonic
master_seed string Secret key
master_seed_hex string Hex coded key
publick_key string Public key
publick_key_hex string Hex coded public key
status string Response status

Get Account Information

Request:

{
    "method": "account_info",
    "params": [
        {
            "account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "strict": true,
            "ledger_index": "current",
            "queue": true
        }
    ]
}
Field Type Description
account string Account
strict bool (Optional) If set to true, the account value must be the account address or the public key of the account.
master_key string Mnemonic
ledger_index string、unsigned int Ledger height
status string Response status

Response:

{
    "result": {
        "account_data": {
            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "Balance": "100000000000000000",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 0,
            "PreviousTxnID": "0000000000000000000000000000000000000000000000000000000000000000",
            "PreviousTxnLgrSeq": 0,
            "Sequence": 1,
            "index": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8"
        },
        "ledger_current_index": 52594,
        "queue_data": {
            "txn_count": 0
        },
        "status": "success",
        "validated": false
    }
}
Field Type Description
Account string Account address
Balance string BVC balance in the account. The unit is Drop. 1 BVC=1000000 Drops, which is one million Drops.
Flags unsigned int Flag
PreviousTxnID string HashID of the last transaction
PreviousTxnLgrSeq unsigned int Ledger height of the last transaction
Sequence unsigned int Transaction serial number
index string HashID of account object
status string Response status

2 Account Settings

Request:

{
    "method": "submit",
    "params": [{
        "secret": "ss3ZB*************4Kuf",
        "tx_json": {
            "TransactionType": "AccountSet",
            "Account" : "bnUy2SHTbB9DursPmkJZUXTf5FcNDGbYEA",
            "SetFlag": 8
        }
    }]
}
Field Type Description
method string RPC interface name
secret string Secret key
TransactionType string Transaction Type
SetFlag int Integer flag to enable for this account,8 indicates that there is a right to issue tokens

Response:

{
    "result": {
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The transaction was applied. Only final in a validated ledger.",
        "status": "success",
        "tx_blob": "12000322800000002400000001202100000008684000000000002710732103EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C87446304402205BFB7608D868795E7EED17A3F42C90C2AD1F237356D2D33DE0FE0D9902F9EC7102201E152A87D45D56A11B02CF6549FD60C28D4744145E88741CEEF03E4EB6721DB281142E244E6F20104E57C0C60BD823CB312BF10928C7",
        "tx_json": {
            "Account": "bnUy2SHTbB9DursPmkJZUXTf5FcNDGbYEA",
            "Fee": "10000",
            "Flags": 2147483648,
            "Sequence": 1,
            "SetFlag": 8,
            "SigningPubKey": "03EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C8",
            "TransactionType": "AccountSet",
            "TxnSignature": "304402205BFB7608D868795E7EED17A3F42C90C2AD1F237356D2D33DE0FE0D9902F9EC7102201E152A87D45D56A11B02CF6549FD60C28D4744145E88741CEEF03E4EB6721DB2",
            "hash": "CF53B9D755668F5CD9A010BED9B8121502D7981882300E3DDC2AAB686C2DC0A1"
        }
    }
}
Field Type Description
engine_result string Engine execution result
engine_result_code int Engine execution result code
engine_result_message string Engine execution result message
status string Submit status
tx_blob string Signature result, binary data format
tx_json string Transaction element, json format
TxnSignature string Transaction signature
hash string Transaction hash

3 Signature

Request:

{
    "method": "sign",
    "params": [
        {
            "offline": false,
            "secret": "snoPB**************SUTr",
            "tx_json": {
                "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                "Amount": 100,
                "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                "TransactionType": "Payment"
            }
        }
    ]
}
Field Type Description
offline bool If true, indicates offline signature
secret string Secret key
tx_json object Transaction Elements
Account string Source account address
Amount unsigned int、object Transaction volume
Destination string Target account address
TransactionType string Transaction Type

Response:

{
    "result": {
        "status": "success",
        "tx_blob": "1200002280000000240000000761400000000000006468400000000000271073210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A0098114B5F762798A53D543A014CAF8B297CFF8F2F937E883146C84C2FBB004F1B1CE847AFB99EE28A25A43C436",
        "tx_json": {
            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "Amount": "100",
            "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
            "Fee": "10000",
            "Flags": 2147483648,
            "Sequence": 7,
            "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
            "TransactionType": "Payment",
            "TxnSignature": "3045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A009",
            "hash": "F84166F16AE55B7149686827D7A067ACC34138D0ED1286E1C7584BAACB050D2B"
        }
    }
}
Field Type Description
tx_blob string Signature result, binary data format
tx_json object Signature element content, json format
SigningPubKey string Signature public key
TxnSignature string Transaction signature summary
status string Response status

4 Payment

Online BVC Payments

Request:

{
    "method": "submit",
    "params": [{
        "offline": false,
        "secret": "snoPB**************SUTr",
        "tx_json": {
            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "Amount": 30000000,
            "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
            "TransactionType": "Payment",
            "Memos": [{
                "Memo": {
                    "MemoData": "74657374",
                    "MemoType": "737472696E67"
                }
            }]
        }
    }]
}
Field Type Description
method string RPC interface name
offline bool Is offline submit? The default is false.
Amount unsignedint，object Amount
Memos object[] (optional) memo object
Memo object Memos
MemoData string Memo must be hexadecimal format. For example, "test" after hexadecimal is "74657374".
MemoType string Memo type must be hexadecimal, For example, "string" after hexadecimal is "737472696E67".

Response:

{
    "result": {
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The transaction was applied. Only final in a validated ledger.",
        "status": "success",
        "tx_blob": "12000022800000002400000006614000000001C9C38068400000000000271073210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD0207446304402205D68089A4C0DC5F6CDE8E59043DD4EF8A44E255B6EF935EE2DA546272A69C3D10220149DB2D3F13AE61267B39E83103E14AB2146F72E64C4EE452924613F169A313A8114B5F762798A53D543A014CAF8B297CFF8F2F937E883146C84C2FBB004F1B1CE847AFB99EE28A25A43C436F9EA7C06737472696E677D0474657374E1F1",
        "tx_json": {
            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "Amount": "30000000",
            "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
            "Fee": "10000",
            "Flags": 2147483648,
            "Memos": [
                {
                    "Memo": {
                        "MemoData": "74657374",
                        "MemoType": "737472696E67"
                    }
                }
            ],
            "Sequence": 6,
            "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
            "TransactionType": "Payment",
            "TxnSignature": "304402205D68089A4C0DC5F6CDE8E59043DD4EF8A44E255B6EF935EE2DA546272A69C3D10220149DB2D3F13AE61267B39E83103E14AB2146F72E64C4EE452924613F169A313A",
            "hash": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D"
        }
    }
}
Field Type Description
engine_result string Payment execution result
engine_result_code int Payment result code
engine_result_message string Payment result
tx_blob string Signature result, binary data format
tx_json object Transaction element, json format
Memos object[] (optional) memo object
Memo object Memos
MemoData string Memo must be hexadecimal format. For example, "test" after hexadecimal is "74657374".
MemoType string Memo type must be hexadecimal, For example, "string" after hexadecimal is "737472696E67".
Fee string Transaction fee in drops
status string Response status

Offline Signature Payments

Request:

{
    "method": "submit",
    "params": [
        {
            "tx_blob": "1200002280000000240000000761400000000000006468400000000000271073210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A0098114B5F762798A53D543A014CAF8B297CFF8F2F937E883146C84C2FBB004F1B1CE847AFB99EE28A25A43C436"
        }
    ]
}
Field Type Description
method string RPC interface name
tx_blob string Signature result, binary data format

Response:

{
    "result": {
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The transaction was applied. Only final in a validated ledger.",
        "status": "success",
        "tx_blob": "1200002280000000240000000761400000000000006468400000000000271073210330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD02074473045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A0098114B5F762798A53D543A014CAF8B297CFF8F2F937E883146C84C2FBB004F1B1CE847AFB99EE28A25A43C436",
        "tx_json": {
            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "Amount": "100",
            "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
            "Fee": "10000",
            "Flags": 2147483648,
            "Sequence": 7,
            "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
            "TransactionType": "Payment",
            "TxnSignature": "3045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A009",
            "hash": "F84166F16AE55B7149686827D7A067ACC34138D0ED1286E1C7584BAACB050D2B"
        }
    }
}
Field Type Description
engine_result string Payment execution result
engine_result_code int Payment result code
engine_result_message string Payment result
tx_blob string Signature result, binary data format
tx_json object Transaction element, json format
Fee string Transaction fees
status string Response status

5 Trustline

View Trustline History

Request:

{
    "method": "account_lines",
    "params": [
        {
            "account": "bDg53Haik2475DJx8rjMDSDPj4VX7htaMd"
        }
    ]
}
Field Type Description
account string Account address
ledger_hash string (Optional) A 20-byte hex string for the ledger version to use
ledger_index string、unsigned int (Optional) The sequence number of the ledger to use, or a shortcut string to choose a ledger automatically
peer string (Optional) The Address of a second account. If provided, show only lines of trust connecting the two accounts.
limit unsigned int (Optional, default varies) Limit the number of transactions to retrieve. The server is not required to honor this value. Must be within the inclusive range 10 to 400
marker object (Optional) Value from a previous paginated response. Resume retrieving data where that response left off.

Response:

{
    "result": {
        "account": "bDg53Haik2475DJx8rjMDSDPj4VX7htaMd",
        "ledger_current_index": 1505800,
        "lines": [
            {
                "account": "bnUy2SHTbB9DursPmkJZUXTf5FcNDGbYEA",
                "balance": "0",
                "currency": "USD",
                "limit": "100000",
                "limit_peer": "0",
                "quality_in": 0,
                "quality_out": 0
            }
        ],
        "status": "success",
        "validated": false
    }
}
Field Type Description
account string Account address
lines Array Array of trust line objects, as described below. If the number of trust lines is large, only returns up to the limit at a time.
ledger_current_index Integer (Omitted if ledger_hash or ledger_index provided) Sequence number of the ledger version used when retrieving this data.
ledger_index Integer (Omitted if ledger_current_index provided instead) Sequence number, provided in the request, of the ledger version that was used when retrieving this data.
ledger_hash string (May be omitted) Hex hash, provided in the request, of the ledger version that was used when retrieving this data.
marker object Server-defined value indicating the response is paginated. Pass this to the next call to resume where this call left off. Omitted when there are no additional pages after this one.

Each trust line object has some combination of the following fields:

Field Type Description
account string Account address
balance string Representation of the numeric balance currently held against this line. A positive balance means that the perspective account holds value; a negative balance means that the perspective account owes value.
currency string A Currency Code identifying what currency this trust line can hold.
limit string The maximum amount of the given currency that this account is willing to owe the peer account
limit_peer string The maximum amount of currency that the counterparty account is willing to owe the perspective account
quality_in unsigned int Rate at which the account values incoming balances on this trust line, as a ratio of this value per 1 billion units. (For example, a value of 500 million represents a 0.5:1 ratio.) As a special case, 0 is treated as a 1:1 ratio.
quality_out unsigned int Rate at which the account values outgoing balances on this trust line, as a ratio of this value per 1 billion units. (For example, a value of 500 million represents a 0.5:1 ratio.) As a special case, 0 is treated as a 1:1 ratio.

Trustline

Request:

{
    "method": "submit",
    "params": [{
        "secret": "ssqt*************9EYe",
        "tx_json": {
            "TransactionType": "TrustSet",
            "Account" : "bDg53Haik2475DJx8rjMDSDPj4VX7htaMd",
            "LimitAmount":
                {
                    "currency":"USD",
                    "value":"100000",
                    "issuer":"bnUy2SHTbB9DursPmkJZUXTf5FcNDGbYEA" 
                }
        }
    }]
}
Field Type Description
method string RPC interface name
secret string Secret key
TransactionType string Transaction Type
Account string Account address
LimitAmount JSON Trustline object
currency string Token name
issuer string Issuer address
value string The max limit to set on this issuer

Response:

{
    "result": {
        "engine_result": "tesSUCCESS",
        "engine_result_code": 0,
        "engine_result_message": "The transaction was applied. Only final in a validated ledger.",
        "status": "success",
        "tx_blob": "1200142280000000240000000163D5C38D7EA4C6800000000000000000000000000055534400000000002E244E6F20104E57C0C60BD823CB312BF10928C76840000000000027107321029A80E85C9EAFE4CF6376524AF360724D4ECE4F2B6197A2E1172E81CC071B7D0C7446304402202D11C42E4C38A7F64F60B1E62E04CA6734C97AB0E4589D29C75C071E5928EAE302206F45A845A544C874C8B97F379F90A28C5E22AE9111388428D6A9961279F933C081148B240FCDC580525F0BFCABB590F434252AC36AF8",
        "tx_json": {
            "Account": "bDg53Haik2475DJx8rjMDSDPj4VX7htaMd",
            "Fee": "10000",
            "Flags": 2147483648,
            "LimitAmount": {
                "currency": "USD",
                "issuer": "bnUy2SHTbB9DursPmkJZUXTf5FcNDGbYEA",
                "value": "100000"
            },
            "Sequence": 1,
            "SigningPubKey": "029A80E85C9EAFE4CF6376524AF360724D4ECE4F2B6197A2E1172E81CC071B7D0C",
            "TransactionType": "TrustSet",
            "TxnSignature": "304402202D11C42E4C38A7F64F60B1E62E04CA6734C97AB0E4589D29C75C071E5928EAE302206F45A845A544C874C8B97F379F90A28C5E22AE9111388428D6A9961279F933C0",
            "hash": "955E5B41D9779D5C1C8E2F45FE2E29D134DF9A9ED8F5A62C200DED0689F0A9E3"
        }
    }
}
Field Type Description
engine_result string Engine execution result
engine_result_code int Engine execution result code
engine_result_message string Engine execution result message
status string Submit status
tx_blob string Binary format data submitted by the transaction
tx_json string JSON format data submitted by the transaction
TxnSignature string Transaction signature
hash string Transaction hash
LimitAmount JSON Trustline object
currency string Token name
issuer string Issuer address
value string The max limit to set on this issuer

6 Account Transaction History

Get Account Transaction History

Request:

{
    "method": "account_tx",
    "params": [
        {
            "account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
            "binary": false,
            "forward": false,
            "ledger_index_max": -1,
            "ledger_index_min": -1,
            "limit": 2
        }
    ]
}
Field Type Description
method string RPC interface name Return whether the transaction record format is in binary format, (default) false is in json format, true is in binary format
forward bool Transaction sorting direction
ledger_index_min int The starting height of the ledger, -1 means starting from the minimum
ledger_index_max int Ledger end height, -1 means the current end
limit unsigned int Returns the page size of the record

Response:

{
    "result": {
        "account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
        "ledger_index_max": 52647,
        "ledger_index_min": 1,
        "limit": 2,
        "marker": {
            "ledger": 52624,
            "seq": 0
        },
        "status": "success",
        "transactions": [
            {
                "meta": {
                    "AffectedNodes": [
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                                    "Balance": "99999999969979900",
                                    "Flags": 0,
                                    "OwnerCount": 0,
                                    "Sequence": 8
                                },
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8",
                                "PreviousFields": {
                                    "Balance": "99999999969990000",
                                    "Sequence": 7
                                },
                                "PreviousTxnID": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D",
                                "PreviousTxnLgrSeq": 52624
                            }
                        },
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Account": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                                    "Balance": "30000100",
                                    "Flags": 0,
                                    "OwnerCount": 0,
                                    "Sequence": 1
                                },
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "FFEBD09C2D6CD0B2A0F2C5539753A470EEA97F06C4606D3363473C41407966DF",
                                "PreviousFields": {
                                    "Balance": "30000000"
                                },
                                "PreviousTxnID": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D",
                                "PreviousTxnLgrSeq": 52624
                            }
                        }
                    ],
                    "TransactionIndex": 0,
                    "TransactionResult": "tesSUCCESS",
                    "delivered_amount": "100"
                },
                "tx": {
                    "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                    "Amount": "100",
                    "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                    "Fee": "10000",
                    "Flags": 2147483648,
                    "Sequence": 7,
                    "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
                    "TransactionType": "Payment",
                    "TxnSignature": "3045022100F77193526323BC2184DA9353B4A6A6C79EADC0AA7C02BC756BFA7B75A4D96B2202206B22F6E35D9E73C4C9993F2387FE9C5EC4393D20EDCE375A926BDBFF1474A009",
                    "date": 617442630,
                    "hash": "F84166F16AE55B7149686827D7A067ACC34138D0ED1286E1C7584BAACB050D2B",
                    "inLedger": 52643,
                    "ledger_index": 52643
                },
                "validated": true
            },
            {
                "meta": {
                    "AffectedNodes": [
                        {
                            "ModifiedNode": {
                                "FinalFields": {
                                    "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                                    "Balance": "99999999969990000",
                                    "Flags": 0,
                                    "OwnerCount": 0,
                                    "Sequence": 7
                                },
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8",
                                "PreviousFields": {
                                    "Balance": "100000000000000000",
                                    "Sequence": 6
                                },
                                "PreviousTxnID": "273740A49417A56305B44E609DF702AFB41A9D6F231DE9A9BF3C97CBD280EAC3",
                                "PreviousTxnLgrSeq": 52624
                            }
                        },
                        {
                            "CreatedNode": {
                                "LedgerEntryType": "AccountRoot",
                                "LedgerIndex": "FFEBD09C2D6CD0B2A0F2C5539753A470EEA97F06C4606D3363473C41407966DF",
                                "NewFields": {
                                    "Account": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                                    "Balance": "30000000",
                                    "Sequence": 1
                                }
                            }
                        }
                    ],
                    "TransactionIndex": 1,
                    "TransactionResult": "tesSUCCESS",
                    "delivered_amount": "30000000"
                },
                "tx": {
                    "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                    "Amount": "30000000",
                    "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                    "Fee": "10000",
                    "Flags": 2147483648,
                    "Memos": [
                        {
                            "Memo": {
                                "MemoData": "74657374",
                                "MemoType": "737472696E67"
                            }
                        }
                    ],
                    "Sequence": 6,
                    "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
                    "TransactionType": "Payment",
                    "TxnSignature": "304402205D68089A4C0DC5F6CDE8E59043DD4EF8A44E255B6EF935EE2DA546272A69C3D10220149DB2D3F13AE61267B39E83103E14AB2146F72E64C4EE452924613F169A313A",
                    "date": 617442440,
                    "hash": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D",
                    "inLedger": 52624,
                    "ledger_index": 52624
                },
                "validated": true
            }
        ]
    }
}
Field Type Description
marker object Pagination
meta object Transaction history
AffectedNodes object Affected units
ModifiedNode object Modified unit
FinalFields object Final field
TransactionIndex unsigned int Transaction number
TransactionResult string Transaction results
delivered_amount string Transaction amount
validated bool Verify status

Get Transaction History

Request:

{
    "method": "tx",
    "params": [
        {
            "transaction": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D",
            "binary": false
        }
    ]
}
Field Type Description
method string RPC interface name
transaction string The hash of the transaction record, which is the serial number of the transaction
binary bool Whether the result of the transaction is displayed in binary, the default is false. If true, it will be displayed in binary format; if false, it will be displayed in JSON format

Response:

{
    "result": {
        "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
        "Amount": "30000000",
        "Destination": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
        "Fee": "10000",
        "Flags": 2147483648,
        "Memos": [
            {
                "Memo": {
                    "MemoData": "74657374",
                    "MemoType": "737472696E67"
                }
            }
        ],
        "Sequence": 6,
        "SigningPubKey": "0330E7FC9D56BB25D6893BA3F317AE5BCF33B3291BD63DB32654A313222F7FD020",
        "TransactionType": "Payment",
        "TxnSignature": "304402205D68089A4C0DC5F6CDE8E59043DD4EF8A44E255B6EF935EE2DA546272A69C3D10220149DB2D3F13AE61267B39E83103E14AB2146F72E64C4EE452924613F169A313A",
        "date": 617442440,
        "hash": "3D11BD3D9FCC22A8190C9D633BD35954A68BF454EA080796C368EA377794675D",
        "inLedger": 52624,
        "ledger_current_index": 52655,
        "ledger_index": 52624,
        "meta": {
            "AffectedNodes": [
                {
                    "ModifiedNode": {
                        "FinalFields": {
                            "Account": "bHr9CJAWyB4bj91VRWn96DkukG4rwdtyTh",
                            "Balance": "99999999969990000",
                            "Flags": 0,
                            "OwnerCount": 0,
                            "Sequence": 7
                        },
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8",
                        "PreviousFields": {
                            "Balance": "100000000000000000",
                            "Sequence": 6
                        },
                        "PreviousTxnID": "273740A49417A56305B44E609DF702AFB41A9D6F231DE9A9BF3C97CBD280EAC3",
                        "PreviousTxnLgrSeq": 52624
                    }
                },
                {
                    "CreatedNode": {
                        "LedgerEntryType": "AccountRoot",
                        "LedgerIndex": "FFEBD09C2D6CD0B2A0F2C5539753A470EEA97F06C4606D3363473C41407966DF",
                        "NewFields": {
                            "Account": "bwtopwNshjkqfrrCPikeshEjVCVhfZkK7Z",
                            "Balance": "30000000",
                            "Sequence": 1
                        }
                    }
                }
            ],
            "TransactionIndex": 1,
            "TransactionResult": "tesSUCCESS",
            "delivered_amount": "30000000"
        },
        "status": "success",
        "validated": true
    }
}
Field Type Description
date unsigned int Transaction time
ledger_index unsigned int The number of the ledger in the exchange
meta object Transaction history
AffectedNodes object Affected units
ModifiedNode object Modified unit
FinalFields object Final field
TransactionIndex unsigned int Transaction number
TransactionResult string Transaction results
delivered_amount string Transaction amount
validated bool Verify status

7 Server Information

Request:

{
    "method": "server_info",
    "params": [
        {
        }
    ]
}
Field Type Description
method string RPC interface name

Response:

{
    "result": {
        "info": {
            "build_version": "0.3.3",
            "complete_ledgers": "1-1504167",
            "hostid": "bvc-core1",
            "io_latency_ms": 1,
            "last_close": {
                "converge_time_s": 9.997999999999999,
                "proposers": 2
            },
            "load": {
                "job_types": [
                    {
                        "avg_time": 4,
                        "job_type": "ledgerData",
                        "peak_time": 30
                    },
                    {
                        "in_progress": 1,
                        "job_type": "clientCommand",
                        "per_second": 1
                    },
                    {
                        "avg_time": 2,
                        "job_type": "writeObjects",
                        "peak_time": 9
                    },
                    {
                        "job_type": "peerCommand",
                        "per_second": 4
                    }
                ],
                "threads": 4
            },
            "load_factor": 1,
            "peers": 3,
            "pubkey_node": "n9KqqziahrKCT1gDg1HfsGhAsz1EmeGcn6Wi3pU57ihCv3ffA85G",
            "pubkey_validator": "n9LPJjwXzi7HUexDy5TvecxUzX6YpycZYxravpar2UT1CSuJ2jii",
            "server_state": "proposing",
            "state_accounting": {
                "connected": {
                    "duration_us": "170040666",
                    "transitions": 12
                },
                "disconnected": {
                    "duration_us": "10841240",
                    "transitions": 1
                },
                "full": {
                    "duration_us": "15100199535937",
                    "transitions": 613
                },
                "syncing": {
                    "duration_us": "6639937640",
                    "transitions": 617
                },
                "tracking": {
                    "duration_us": "200043695",
                    "transitions": 614
                }
            },
            "uptime": 15107220,
            "validated_ledger": {
                "age": 3,
                "base_fee_bvc": 0.01,
                "hash": "3DCDAAA2922E44041798B1305CD1632788C28B4355D2856F1C55AE82275F17CE",
                "reserve_base_bvc": 30,
                "reserve_inc_bvc": 5,
                "seq": 1504167
            },
            "validation_quorum": 3
        },
        "status": "success"
    }
}
Field Type Description
build_version string Node program version number
complete_ledgers string The range of ledgers that the node has synchronized.
server_state string Node status
status string Submit status
load string The current load state of the node
peers int Number of nodes this one is currently connected to
uptime int Number of consecutive seconds that the server has been operational.
validated_ledger json Information about the most recent fully-validated ledger.
validation_quorum int Minimum number of trusted validations required to validate a ledger version.

results matching ""

    No results matching ""