v11

latestOpenAPI 3.1.0AGPL-3.0-onlyraw.githubusercontent.com2026-08-01307390.9 KB

Contracts

Get contract metadata.

Returns indexed token/contract metadata and optional current protocol enrichments such as ERC4626.

blockHeight reflects the indexer's best block at request time. ERC4626 fields under protocols.erc4626 are fetched through JSON-RPC calls pinned to that exact blockHeight, so the ERC4626 values are a consistent snapshot. If a vault is detected but the underlying asset metadata cannot be resolved, protocols.erc4626 contains error and omits asset; callers must not derive fiat rates or human-unit exchange rates from such a partial response.

Load estimate: Medium; indexed metadata is cheap, but optional protocol enrichment can add backend RPC calls and token metadata lookups.

get/api/v2/contract/{contract}

Path parameters

contractstring required

Smart contract address.

Query parameters

currencystring

Example:usd

Secondary currency code for rates.

protocolsstring[]

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

[
  "erc4626"
]

Response

Contract metadata.

type'' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155' required

Token standard name. Empty string means no token standard is known.

standard'' | 'XPUBAddress' | 'ERC20' | 'ERC721' | 'ERC1155' | 'BEP20' | 'BEP721' | 'BEP1155' | 'TRC20' | 'TRC721' | 'TRC1155' required

Token standard name. Empty string means no token standard is known.

contractstring required

namestring required

symbolstring required

decimalsinteger required

createdInBlockinteger

destructedInBlockinteger

blockHeightinteger required

Example response

{
  "protocols": {
    "erc4626": {
      "totalAssets": "100000000",
      "convertToAssets1Share": "100000000",
      "convertToShares1Asset": "100000000",
      "previewDeposit1Asset": "100000000",
      "previewRedeem1Share": "100000000"
    }
  }
}