Theta Developer APIs
API OverviewThis API is provided for the Theta community to use for free and without warranty. Please do not abuse the API and limit your calls to no more then 1 or 2 per second. Every endpoint can be used with a post or a get. The API can be used with the USA node
http://www.thetascan.ioor the Singapore node
http://sg.thetascan.ioThese nodes are independent of each other if one goes offline the other is not affected.
ThetaScan has 10 top level categories.
Endpoints that return address balances.
Endpoints that return transaction hash details.
Endpoints that return blocks.
Endpoint that returns staking information.
Endpoint that returns block timing information.
Endpoint that will broadcast a raw signed transaction.
Endpoints that return transaction information.
Endpoints that return the market cap of Theta and TFuel.
Endpoints that return the price of Theta and TFuel.
Endpoints that return the details for a contract or address balance.
Get Theta and TFuel Balance for a single AddressThis category has 2 endpoints. The first is passing a single address to it.
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28daIt will return the balance of Theta, Theta staked, TFuel, and Tfuel staked /1000000000000000000. The second endpoint is passing a group of address
?multiaddress=address1,address2,address3Each address must be seperated by a comma and will also return the balance of Theta, Theta staked, TFuel, and Tfuel staked /1000000000000000000..
Get a Transactions By HashThis category has one endpoint.
?hash=0x1ae21d5852c961ca0acff380103e6b914e7d0692c042e6d2fca503e51d63043bIt will return a transactions details.
Get a Block By Block NumberThis category has three endpoints. The first is passing no data to it. It will return the most resent block proccessed by the node. The second endpoint is passing a block number
?block=12344Which will return the specific block requested. The third endpoint will return a grouping of blocks by passing a starting block and an ending block
?start_block=1512000&end_block= 1512100It is limited to 100 blocks per call. Requesting any more blocks will return nothing.
Get Summary list of Staked Earnings by AddressThis category has five endpoints. The first will return the current year by month of staked earnings.
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28daThe second will return staking earning of the entered year by month.
?address=address&year=2020The third will return the current amount of Theta staked to a Guardian Node or TFuel staked to an Elite Edge Node.
?node=0x88884a84d980bbfb7588888126fb903486bb8888The next endpoint will return the current amount of Theta staked to a Guardian Node or TFuel staked to an Elite Edge Node by address staked.
?staketonode=0x88884a84d980bbfb7588888126fb903486bb8888The last endpoint will return 60 coinbase rewards at a time for an address. Offset = 0 returns 1 to 60, offset=1 returns 61 to 120, etc.. Changing the year will return the 60 most recent to oldest for that year.
Get Block TimesThis category has one endpoint. It will return the average block time for the previous day.
Send a Raw TransactionThis category has one endpoint and will allow a signed raw transaction to be sent over the Theta network.
Get Transaction InformationThis category has six endpoints. The first one is passing no data it will return the number of transactions for the previous day. The next passing a date
?date=2020-7-25will return the transactions count on that specific date. The next endpoint is passing a date range
?start_date=2020-7-25&end_date=2020-8-25This will return the daily transaction counts for each day in the range. It does not include the ending date. The next three endpoints return type 2 transactions from a Theta address. Passing only an address
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28dawill return the last 100 transactions for that address. Passing an address and date
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28da&date=2020-8-31will return all the transactions on that specific date. The last endpoint is passing an address with a date range
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28da&start_date=2020-7-25&end_date=2020-9-25It will return up to 1000 transactions in that range.
Get Theta Current or Historical Daily Market CapThis category has three endpoint. The first is passing no data to it. It will return the current market cap of Theta and TFuel. Which is updated every 10 minutes. The second will return the market cap at closing UTC time on a specific date.
?date=2020-8-25The third will return a range of Theta and TFuel market caps.
Get Theta Current or Historical PriceThis category has three endpoint. The first is passing no data to it. It will return the current price of Theta and TFuel. Which is updated every 10 minutes. The second will return the price at closing UTC time on a specific date.
?date=2020-8-25The third will return a range of Theta and TFuel prices.
Get Contract Details or Contract Account Balance for TNT-20 TokenThis category has two endpoint. The first is passing the contract address. This will return details about the contract such as its name, total supply, and decimal.
?contract=0x2806a488d901922b8c1176e730649b135da1c7dbThe second will return the balance of tokens for any address in the contract.
***Note: The balance will be returned with the contract decimal applied.