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.
Enhanced DDOS protections have been implemented if this is causing your project any problems, feel free to contact us with your ip address so it can be white listed.
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, and TFuel /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 and TFuel /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 two endpoint. The first will the current year by month of staked earnings.
?address=0xc15149236229bd13f0aec783a9cc8e8059fb28daThe second will return staking earning of the entered year by month.
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 BalanceThis 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.