Phoenix RPC

Developer Documents
Phoenix Intelligence Center

Develop and Build on top of Phoenix

Join the forefront of blockchain innovation by developing on the Phoenix Blockchain. With low transaction fees, high-speed processing, and EVM support.
Join Our Telegram
Phoenix API Documentation
Welcome to the Phoenix API Documentation. This API supports developers transitioning their applications from Etherscan to BlockScout, offering both GET and POST requests. Below is an overview of the available modules and their functionalities.

Example Usage

Get Balance

Endpoint: ?module=account&action=eth_get_balance&address={addressHash}
Description: Mimics Ethereum JSON RPC’s eth_getBalance. Returns the balance as of the provided block (defaults to latest).

Example:

				
					curl -X GET "http://localhost:4000/api?module=account&action=eth_get_balance&address=0x0000000000000000000000000000000000000000"

				
			
Get Balance for Multiple Addresses

Endpoint: ?module=account&action=balancemulti&address={addressHash1,addressHash2,addressHash3}
Description: Fetches the balance for multiple addresses.

Example:

				
					curl -X GET "http://localhost:4000/api?module=account&action=balancemulti&address=0x0000000000000000000000000000000000000000,0x0000000000000000000000000000000000000001"

				
			
Get Pending Transactions by Address

Endpoint: ?module=account&action=pendingtxlist&address={addressHash}
Description: Retrieves pending transactions for a specific address.

Example:

				
					curl -X GET "http://localhost:4000/api?module=account&action=pendingtxlist&address=0x0000000000000000000000000000000000000000"

				
			
Get Transactions by Address

Endpoint: ?module=account&action=txlist&address={addressHash}
Description: Retrieves up to 10,000 transactions for a specific address.

Example:

				
					curl -X GET "http://localhost:4000/api?module=account&action=txlist&address=0x0000000000000000000000000000000000000000"

				
			

Logs

Get Event Logs

Endpoint: ?module=logs&action=getLogs&fromBlock={blockNumber}&toBlock={blockNumber}&address={addressHash}&topic0={firstTopic}
Description: Fetches event logs for an address and/or topics, up to a maximum of 1,000 logs.

Example:

				
					curl -X GET "http://localhost:4000/api?module=logs&action=getLogs&fromBlock=0&toBlock=99999999&address=0x0000000000000000000000000000000000000000&topic0=0x0000000000000000000000000000000000000000000000000000000000000000"

				
			

Token

Get Token by Contract Address

Endpoint: ?module=token&action=getToken&contractaddress={contractAddressHash}
Description: Retrieves ERC-20 or ERC-721 token information by contract address.

Example:

				
					curl -X GET "http://localhost:4000/api?module=token&action=getToken&contractaddress=0x0000000000000000000000000000000000000000"

				
			
Get Token Holders

Endpoint: ?module=token&action=getTokenHolders&contractaddress={contractAddressHash}
Description: Retrieves token holders by contract address.

Example:

				
					curl -X GET "http://localhost:4000/api?module=token&action=getTokenHolders&contractaddress=0x0000000000000000000000000000000000000000"

				
			

Stats

Get Token Supply

Endpoint: ?module=stats&action=tokensupply&contractaddress={contractAddressHash}
Description: Retrieves ERC-20 or ERC-721 token total supply by contract address.

Example:

				
					curl -X GET "http://localhost:4000/api?module=stats&action=tokensupply&contractaddress=0x0000000000000000000000000000000000000000"

				
			
Get Latest Price

Endpoint: ?module=stats&action=coinprice
Description: Retrieves the latest price of the native coin in USD and BTC.

Example:

				
					curl -X GET "http://localhost:4000/api?module=stats&action=coinprice"

				
			

Block

Get Block Reward

Endpoint: ?module=block&action=getblockreward&blockno={blockNumber}
Description: Retrieves block reward by block number.

Example:

				
					curl -X GET "http://localhost:4000/api?module=block&action=getblockreward&blockno=1234567"
				
			
Get Block Number by Timestamp

Endpoint: ?module=block&action=getblocknobytime×tamp={blockTimestamp}&closest={before/after}
Description: Retrieves block number by timestamp.

Example:

				
					curl -X GET "http://localhost:4000/api?module=block&action=getblocknobytime×tamp=1625097600&closest=before"

				
			

Contract

List Contracts

Endpoint: ?module=contract&action=listcontracts
Description: Retrieves a list of contracts, sorted by the time they were first seen by the explorer.

Example:

				
					curl -X GET "http://localhost:4000/api?module=contract&action=listcontracts"

				
			
Get Contract ABI

Endpoint: ?module=contract&action=getabi&address={addressHash}
Description: Retrieves the ABI for a verified contract.

Example:

				
					curl -X GET "http://localhost:4000/api?module=contract&action=getabi&address=0x0000000000000000000000000000000000000000"

				
			

Transaction

Get Transaction Info

Endpoint: ?module=transaction&action=gettxinfo&txhash={transactionHash}
Description: Retrieves transaction information.

Example:

				
					curl -X GET "http://localhost:4000/api?module=transaction&action=gettxinfo&txhash=0x0000000000000000000000000000000000000000000000000000000000000000"

				
			
Get Transaction Receipt Status

Endpoint: ?module=transaction&action=gettxreceiptstatus&txhash={transactionHash}
Description: Retrieves the status of a transaction receipt.

Example:

				
					curl -X GET "http://localhost:4000/api?module=transaction&action=gettxreceiptstatus&txhash=0x0000000000000000000000000000000000000000000000000000000000000000"

				
			

Documentation and Best Practices

To ensure a smooth integration and to maximize the utility of the RPC API, here are some suggestions and hints:

What is the base URL for the Phoenix RPC API?
Which methods are supported by the Phoenix RPC API?
How do I retrieve the balance of an address using the RPC API?
You can retrieve the balance of an address by using the endpoint ?module=account&action=eth_get_balance&address={addressHash}. This can be done via GET or POST requests.
Can I check the balance of multiple addresses at once?
How do I get the list of transactions for a specific address?
Is there a limit to the number of logs I can retrieve?
How do I verify a smart contract on the Phoenix Blockchain?

Phoenix Blockchain: Revolutionizing crypto with low fees, high speed, and unparalleled versatility! 
Get Started