Skip to main content

​
Account Endpoints

​
Changed

  • /api/account/state (POST) -> /api/{chainId}/account/{accountId}/state (GET)
    • Moved chainId from body to URL path
    • Moved accountId from body to URL path
    • Query params remain unchanged (include=native,tokens,staking)
  • /api/account/state/tokens (POST) -> /api/{chainId}/account/{accountId}/tokens (GET)
    • Moved chainId from body to URL path
    • Moved accountId from body to URL path
    • Pagination via nextPage query param remains unchanged
  • /api/account/history (POST) -> /api/{chainId}/account/{accountId}/history (GET)
    • Moved chainId from body to URL path
    • Moved accountId from body to URL path
    • Query params remain unchanged (include=parsed,raw)
    • Pagination via nextPage query param remains unchanged

​
Transaction Endpoints

​
Changed

  • /api/transaction/broadcast (POST) -> /api/{chainId}/transaction/broadcast (POST)
    • Moved chainId from body to URL path
    • Payload structure remains unchanged
  • /api/transaction/encode (POST) -> /api/{chainId}/transaction/encode (POST)
    • Moved chainId from body to URL path
    • Transaction details remain in request body
  • /api/transaction/{hash} (GET) -> /api/{chainId}/transaction/{hash} (GET)
    • Added chainId to URL path
    • Response structure remains unchanged

​
Validator Endpoints

​
Changed

  • /api/validators (GET) -> /api/{chainId}/validators (GET)
    • Moved chainId from query param to URL path
    • Pagination via nextPage query param remains unchanged

​
Chain Information

​
Unchanged

  • /api/chains (GET)
    • Lists all supported chains and their features
    • No changes to endpoint or response structure

​
Utils Endpoints

​
Changed

  • /api/address/validate (POST) -> /api/{chainId}/address/validate (POST)
    • Moved chainId from body to URL path
    • Response type remains boolean
  • /api/address/encode (POST) -> /api/{chainId}/address/encode (POST)
    • Moved chainId from body to URL path
    • Pubkey remains in request body

​
OpenAPI Specification

The OpenAPI specification is available at: https://api.adamik.io/openapi.json

​
General Changes

  1. HTTP Method Changes:
    • Most POST endpoints converted to GET where they were only used for reading data
    • POST methods retained only for actual data modifications/submissions
  2. URL Structure:
    • Consistent pattern: /api/{chainId}/...
    • Resource identifiers moved to URL paths
    • Query parameters used only for filtering and pagination
  3. Pagination:
    • Consistent nextPage token approach across all paginated endpoints
    • Token passed via query parameter
  4. Response Formats:
    • Added more detailed error and warning messages in status object
    • Consistent structure across all endpoints