Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.adamik.io/llms.txt

Use this file to discover all available pages before exploring further.

The Read API provides endpoints to retrieve blockchain data across multiple categories. These endpoints deliver standardized responses across all supported networks.

API Categories

Chain Information

  • Get Supported Chains (GET /api/chains): List all supported blockchain networks and their features
  • Get Chain Info (GET /api/chain/{chainId}): Detailed information about a specific blockchain
  • Get Validators (GET /api/{chainId}/validators): List of validators and their details
  • Get Transaction Details (GET /api/{chainId}/transaction/{transactionId}): Detailed transaction information

Account Operations

  • Get Account State (GET /api/{chainId}/account/{accountId}/state): Comprehensive account information including balances
  • Get Account Tokens (GET /api/{chainId}/account/{accountId}/state/tokens): List of tokens owned by an account
  • Get Account History (GET /api/{chainId}/account/{accountId}/history): Transaction history for an account

Utilities

  • Encode Address (POST /api/{chainId}/address/encode): Convert public key to chain-specific address format
  • Validate Address (POST /api/{chainId}/address/validate): Verify address format for a specific chain

Interaction Flow

Note: All Read API endpoints are stateless and return standardized responses across different blockchain networks. Pagination is supported where applicable using the nextPage parameter.

Chain-Specific Features

The Read API adapts to each blockchain’s capabilities:
{
  "read": {
    "token": true, // Token information support
    "validators": true, // Validator queries support
    "transaction": {
      "native": true, // Native transaction queries
      "tokens": true, // Token transaction queries
      "staking": true // Staking transaction queries
    },
    "account": {
      "balances": {
        "native": true, // Native balance queries
        "tokens": true, // Token balance queries
        "staking": true // Staking position queries
      },
      "transactions": {
        "native": true, // Native transaction history
        "tokens": true, // Token transaction history
        "staking": true // Staking transaction history
      }
    }
  }
}

Response Standardization

The API provides consistent response formats across all chains:
  • Transaction states are normalized (pending, unconfirmed, confirmed, failed, unknown)
  • Transaction types are standardized (transfer, transferToken, delegate, redelegate, undelegate, claimRewards)
  • Optional include parameters allow requesting additional data (e.g., parsed and raw transaction details)
For implementation details, refer to: