Introduction

This document outlines the various endpoints available through the Autheo REST API. More information can be found at the API Documentation Page on the Autheo block explorer.

Address Methods

Details for address methods can be found on the Address Methods page.

Block Methods

Details for block methods can be found on the Block Methods page.

Main Page Methods

Details for main-page methods can be found on the Main Page Methods page.

Search Methods

/search

Returns any entities that correspond with the provided query string.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/search?q=tst' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "address": "0xfeeE0ece0903D0E3fcE990a2975C6d103bEb80cb",
      "address_url": "/address/0xfeeE0ece0903D0E3fcE990a2975C6d103bEb80cb",
      "certified": false,
      "circulating_market_cap": null,
      "exchange_rate": null,
      "icon_url": null,
      "is_smart_contract_verified": false,
      "is_verified_via_admin_panel": false,
      "name": "Testing Token",
      "priority": 0,
      "symbol": "TST",
      "token_type": "ERC-20",
      "token_url": "/token/0xfeeE0ece0903D0E3fcE990a2975C6d103bEb80cb",
      "total_supply": "10000000000000000000000",
      "type": "token"
    }
  ],
  "next_page_params": null
}

/search/check-redirect

Returns a boolean indicating whether the queried address is redirected or not.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/search/check-redirect?q=USDT' \
  -H 'accept: application/json'

Response

{
  "parameter": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
  "redirect": true,
  "type": "address | block | transaction"
}

Smart Contract Methods

Details for smart-contracts methods can be found on the Smart Contract Methods page.

Stats Methods

/stats

Returns statistic counters

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/stats' \
  -H 'accept: application/json'

Response

{
  "average_block_time": 1313,
  "coin_image": null,
  "coin_price": null,
  "coin_price_change_percentage": null,
  "gas_price_updated_at": "2024-11-12T22:58:04.049085Z",
  "gas_prices": {
    "slow": null,
    "average": null,
    "fast": null
  },
  "gas_prices_update_in": 15702,
  "gas_used_today": "12963689",
  "market_cap": "0",
  "network_utilization_percentage": 0,
  "secondary_coin_image": null,
  "secondary_coin_price": null,
  "static_gas_price": null,
  "total_addresses": "14",
  "total_blocks": "99886",
  "total_gas_used": "0",
  "total_transactions": "16",
  "transactions_today": "14",
  "tvl": null
}

/stats/charts/transactions

Returns a chart of transactions by date.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/stats/charts/transactions' \
  -H 'accept: application/json'

Response

{
  "chart_data": [
    {
      "date": "2024-11-12",
      "tx_count": 2
    },
    {
      "date": "2024-11-11",
      "tx_count": 14
    },
    {
      "date": "2024-11-10",
      "tx_count": 0
    },
    {
      "date": "2024-11-09",
      "tx_count": 0
    },
    {
      "date": "2024-11-08",
      "tx_count": 0
    },
    {
      "date": "2024-11-07",
      "tx_count": 0
    },
    {
      "date": "2024-11-06",
      "tx_count": 0
    },
    {
      "date": "2024-11-05",
      "tx_count": 0
    },
    {
      "date": "2024-11-04",
      "tx_count": 0
    },
    {
      "date": "2024-11-03",
      "tx_count": 0
    },
    {
      "date": "2024-11-02",
      "tx_count": 0
    }
  ]
}

/stats/charts/market

Returns a chart of market data.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/stats/charts/market' \
  -H 'accept: application/json'

Response

{
  "available_supply": "164918857.718061",
  "chart_data": [
    {
      "date": "2022-10-31",
      "closing_price": "0.00254915",
      "market_cap": "420471.10604559750644"
    }
  ]
}

Token Methods

Details for tokens methods can be found on the Token Methods page.

Transaction Methods

Details for transaction methods can be found on the Transaction Methods page.

Additional Methods

/config/json-rpc-url

Returns the url for the JSON-RPC endpoint

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/config/json-rpc-url' \
  -H 'accept: application/json'

Response

{
  "json_rpc_url": "https://core.poa.network"
}

/withdrawals

Returns withdrawals.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/withdrawals' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "index": 1,
      "amount": "1000000000000000000",
      "validator_index": 1,
      "receiver": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "block_number": 1,
      "timestamp": "2023-06-20T07:55:00.000000Z"
    }
  ],
  "next_page_params": {
    "index": 1,
    "items_count": 50
  }
}