Prizm Space
  • Prizm GitBook
  • Whitepaper
    • Introduction
    • Review
    • Core Technologies
    • POS in Prizm
    • Comparsion with Peercoin
    • Tokens
    • Network node
    • Blocks
    • Forging
    • Forging Algorithm
    • Paramining
    • Paramining options
    • Prizm Accounts
    • WALLET.DAT
    • Basics of Prizm Cryptography
    • Key Features
    • Problems
    • Application
    • Prizm Solutions
  • Prizm API
    • Description
    • General Notes
    • Create Transaction
    • Account Operations
    • Arbitrary Message System Operations
    • Block Operations
    • Forging Operations
    • Hallmark Operations
    • Networking Operations
    • Server Information Operations
    • Token Operations
    • Transaction Operations
    • Utilities
    • Debug Operations
    • Prizm API Examples
  • Roadmap
  • Prizm Devs
  • Latest News
  • Community
  • Downloads
  • Guidelines
    • Video
    • Articles
      • How can I connect to my node from another device?
      • How to create Prizm Wallet
      • How to install Prizm Core
      • Prizm Integration
  • F.A.Q
Powered by GitBook
On this page
  • Get Account
  • Get Account Block Count
  • Get Account Block Ids
  • Get Account Blocks
  • Get Account Id
  • Get Account Ledger
  • Get Account Ledger Entry
  • Get Account Public Key
  • Get Account Transaction Ids
  • Get Account Transactions
  • Get Balance
  • Get Blockchain Transactions
  • Get Guaranteed Balance
  • Get Unconfirmed Transaction Ids
  • Get Unconfirmed Transactions
  • Search Accounts
  • Send Money
  • Set Account Info

Was this helpful?

  1. Prizm API

Account Operations

Get Account

Get account information given an account ID.

Request:

  • requestType is getAccount

  • account is the account ID

  • includeEffectiveBalance is true to include effectiveBalancePrizm and guaranteedBalanceNQT (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • unconfirmedBalanceNQT (S) is balanceNQT less unconfirmed outgoing transactions, the balance displayed in the client

  • effectiveBalancePrizm (N) is the balance (in PRIZM) of the account available for forging

  • forgedBalanceNQT (S) is the balance (in NQT) that the account has forged

  • balanceNQT (S) is the minimally confirmed basic balance (in NQT) of the account

  • publicKey (S) is the public key of the account

  • requestProcessingTime (N) is the API request processing time (in millisec)

  • guaranteedBalanceNQT (S) is the balance (in NQT) of the account with at least 1440 confirmations

  • unconfirmedAssetBalances (A) is an array of asset objects including the fields unconfirmedBalanceQNT (S) and asset (S) ID

  • accountRS (S) is the Reed-Solomon address of the account

  • name (S) is the name associated with the account, if applicable

  • description (S) is the description of the account, if applicable

  • account (S) is the account number

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

Get Account Block Count

Get the number of blocks forged by an account.

Request:

  • requestType is getAccountBlockCount

  • account is an account ID

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • numberOfBlocks (N) is the number of blocks forged by the account

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Account Block Ids

Get the block IDs of all blocks forged (generated) by an account in reverse block height order.

Request:

  • requestType is getAccountBlockIds

  • account is the account ID

  • timestamp is the earliest block (in seconds since the genesis block) to retrieve (optional)

  • firstIndex is a zero-based index to the first block ID to retrieve (optional)

  • lastIndex is a zero-based index to the last block ID to retrieve (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • blockIds (A) is an array of block IDs

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millsec)

Get Account Blocks

Get all blocks forged (generated) by an account in reverse block height order.

Request:

  • requestType is getAccountBlocks

  • account is the account ID

  • timestamp is the earliest block (in seconds since the genesis block) to retrieve (optional)

  • firstIndex is a zero-based index to the first block to retrieve (optional)

  • lastIndex is a zero-based index to the last block to retrieve (optional)

  • includeTransactions is true to retrieve transaction details, otherwise only transaction IDs are retrieved (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Account Id

Get an account ID given a secret passphrase or public key. POST only.

Request:

  • requestType is getAccountId

  • secretPhrase is the secret passphrase of the account (optional)

  • publicKey is the public key of the account (optional if secretPhrase provided)

Response:

  • accountRS (S) is the Reed-Solomon address of the account

  • publicKey (S) is the public key of the account

  • requestProcessingTime (N) is the API request processing time (in millisec)

  • account (S) is the account number

Get Account Ledger

Get multiple account ledger entries.

Request:

  • requestType is getAccountLedger

  • account is the account ID (optional)

  • firstIndex is a zero-based index to the first block to retrieve (optional)

  • lastIndex is a zero-based index to the last block to retrieve (optional)

  • event is the event ID (optional)

  • eventType is a string representing the event type (optional)

  • holdingType is a string representing the holding type (optional)

  • holding is the holding ID (optional)

  • includeTransactions is true to retrieve transaction details, otherwise only transaction IDs are retrieved (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • entries (A) is an array of ledger objects including the fields:

    • change (S) is the change in the balance for the holding identified by 'holdingType'

    • eventType (S) is the event type causing the account change

    • ledgerId (S) is the ledger entry ID

    • holding (S) is the item identifier for an asset or currency balance

    • isTransactionEvent (B) is true if the event is associated with a transaction and false if it is associated with a block.

    • balance (S) is the balance for the holding identified by 'holdingType'

    • holdingType (S) is the item being changed (account balance, asset balance or currency balance)

    • accountRS (S) is the Reed-Solomon address of the account

    • block (S) is the block ID that created the ledger entry

    • event (S) is the block or transaction associated with the event

    • account (S) is the account number

    • height (N) is the the block height associated with the event

    • timestamp (N) is the the block timestamp associated with the event

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Account Ledger Entry

Get a specific account ledger entry.

Request:

  • requestType is getAccountLedgerEntry

  • ledgerId is the ledger ID

  • includeTransactions is true to retrieve transaction details, otherwise only transaction IDs are retrieved (optional)

  • includeHoldingInfo is true to retrieve asset or currency info (optional) with the ledger entry. The default is false.

Response:

  • change (S) is the change in the balance for the holding identified by 'holdingType'

  • eventType (S) is the event type causing the account change

  • ledgerId (S) is the ledger entry ID

  • holding (S) is the item identifier for an asset or currency balance

  • isTransactionEvent (B) is true if the event is associated with a transaction and false if it is associated with a block.

  • balance (S) is the balance for the holding identified by 'holdingType'

  • holdingType (S) is the item being changed (account balance, asset balance or currency balance)

  • accountRS (S) is the Reed-Solomon address of the account

  • block (S) is the block ID that created the ledger entry

  • event (S) is the block or transaction associated with the event

  • account (S) is the account number

  • height (N) is the the block height associated with the event

  • timestamp (N) is the the block timestamp associated with the event

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Account Public Key

Get the public key associated with an account ID.

Request:

  • requestType is getAccountPublicKey

  • account is the account ID

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • publicKey (S) is the 32-byte public key associated with the account, returned as a hex string

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Account Transaction Ids

Get Account Transactions

Get Balance

Get the balance of an account.

Request:

  • requestType is getBalance

  • account is an account ID

  • includeEffectiveBalance is true to include effectiveBalancePrizm and guaranteedBalanceNQT (optional)

  • height is the height to retrieve account balance for, if still available (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • unconfirmedBalanceNQT (S) is balanceNQT less unconfirmed outgoing transactions, the balance displayed in the client

  • guaranteedBalanceNQT (S) is the balance (in NQT) of the account with at least 1440 confirmations

  • effectiveBalancePrizm (N) is the balance (in PRIZM) of the account available for forging: the unleased guaranteedBalance of this account plus the leased guaranteedBalance of all lessors to this account

  • forgedBalanceNQT (S) is the balance (in NQT) that the account has forged

  • balanceNQT (S) is the minimally confirmed basic balance (in NQT) of the account

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Blockchain Transactions

Get the transactions associated with an account in reverse block timestamp order.

Request:

  • requestType is getBlockchainTransactions

  • account is the account ID

  • timestamp is the earliest block (in seconds since the genesis block) to retrieve (optional)

  • type is the type of transactions to retrieve (optional)

  • subtype is the subtype of transactions to retrieve (optional)

  • firstIndex is a zero-based index to the first transaction to retrieve (optional)

  • lastIndex is a zero-based index to the last transaction to retrieve (optional)

  • numberOfConfirmations is the required number of confirmations per transaction (optional)

  • withMessage is true to retrieve only only transactions having a message attachment, either non-encrypted or decryptable by the account (optional)

  • includeExpiredPrunable is true' to retrieve pruned data if available (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Guaranteed Balance

Get the guaranteed balance of an account. This is the minimum balance the account had in the interval

(currentHeight - numberOfConfirmations, currentHeight]

Amounts in unconfirmed transactions are not deduced from the result (or included to the result).

Request:

  • requestType is getGuaranteedBalance

  • account is an account ID

  • numberOfConfirmations is the minimum number of confirmations for a transaction to be included in the guaranteed balance (optional, if omitted or zero then minimally confirmed transactions are included)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • guaranteedBalanceNQT (S) is the balance (in NQT) of the account with at least numberOfConfirmations confirmations

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Unconfirmed Transaction Ids

Get a list of unconfirmed transaction IDs associated with an account.

Request:

  • requestType is getUnconfirmedTransactionIds

  • account is one account ID (optional)

  • account is one account ID (optional)

â‹®

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

  • firstIndex is a zero-based index to the first transaction ID to retrieve (optional)

  • lastIndex is a zero-based index to the last transaction ID to retrieve (optional)

Response:

  • unconfirmedTransactionIds (A) is an array of unconfirmed transaction IDs

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Get Unconfirmed Transactions

Get a list of unconfirmed transactions associated with an account.

Request:

  • requestType is getUnconfirmedTransactions

  • account is one account ID (optional)

  • account is one account ID (optional)

â‹®

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

  • firstIndex is a zero-based index to the first unconfirmed transaction to retrieve (optional)

  • lastIndex is a zero-based index to the last unconfirmed transaction to retrieve (optional)

Response:

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Search Accounts

Get accounts having a name or description that match a given query in reverse relevance order.

Request:

  • requestType is searchAccounts

  • firstIndex is a zero-based index to the first account to retrieve (optional)

  • lastIndex is a zero-based index to the last account to retrieve (optional)

  • requireBlock is the block ID of a block that must be present in the blockchain during execution (optional)

  • requireLastBlock is the block ID of a block that must be last in the blockchain during execution (optional)

Response:

  • accounts (A) is an array of account objects with the following fields:

    • account (S) is the account number

    • accountRS (S) is the Reed-Solomon address of the account

    • name (S) is the name of the account

    • description (S) is the description of the account (if applicable)

  • lastBlock (S) is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)

  • requestProcessingTime (N) is the API request processing time (in millisec)

Send Money

Send PRIZM to an account. POST only.

  • requestType is sendMoney

  • amountNQT is the amount (in NQT) in the transaction

  • recipient is the account ID of the recipient

  • recipientPublicKey is the public key of the receiving account (optional, enhances security of a new account)

Set Account Info

Set account information. POST only.

  • requestType is setAccountInfo

  • name is a name to associate with the account (optional)

  • description is a description to associate with the account (optional)

PreviousCreate TransactionNextArbitrary Message System Operations

Last updated 4 years ago

Was this helpful?

Example: Refer to example.

Example: Refer to example.

Example: Refer to example.

blocks (A) is an array of blocks (refer to for details)

Example: Refer to example.

Example: Refer to example.

Example: Refer to example.

Example: Refer to example.

Example: Refer to example.

(Removed. Use instead.)

(Removed. Use instead.)

Example: Refer to example.

Note: Refer to for definitions of types and subtypes

transactions (A) is an array of transactions (refer to for details)

Example: Refer to example.

Example: Refer to example.

Example: Refer to example.

unconfirmedTransactions (A) is an array of unconfirmed transactions (refer to for details)

Example: Refer to example.

query is a full text query on the account fields name (S) and description (S) in the

Example: Refer to example.

Request: Refer to for common parameters.

Response: Refer to .

Example: Refer to example.

Request: Refer to for common parameters.

Response: Refer to .

Example: Refer to example.

standard Lucene syntax
Create Transaction Request
Create Transaction Response
Create Transaction Request
Create Transaction Response
Get Account
Get Account Block Count
Get Account Block Ids
Get Block
Get Account Blocks
Get Account Id
Get Account Ledger
Get Account Ledger Entry
Get Account Public Key
Get Blockchain Transactions
Get Blockchain Transactions
Get Balance
Get Constants
Get Transaction
Get Blockchain Transactions
Get Guaranteed Balance
Get Unconfirmed Transaction Ids
Get Transaction
Get Unconfirmed Transactions
Search Accounts
Send Money
Set Account Info