> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniblock.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Direct API: Alchemy

> API endpoints for Alchemy.

# Alchemy: Direct API Endpoints

Alchemy provides 29 unique direct API endpoints across the following categories:

* DeFi (3 endpoints)
* Market Data (4 endpoints)
* NFT (24 endpoints)
* Other (1 endpoint)
* Token (4 endpoints)
* Wallets (5 endpoints)

*Note: Some endpoints appear in multiple categories. The count above reflects unique API paths.*

> **Learn more:** [Alchemy Documentation](https://www.alchemy.com/docs/data)

## Prefix and Example

**Prefix:** No prefix is required for Alchemy, an example URL will therefore look like: `https://api.uniblock.dev/direct/v1/Alchemy + /[Alchemy_endpoint]`.

**Example Request:**

```bash theme={null}
curl --request GET \
  --url https://api.uniblock.dev/direct/v1/Alchemy/prices/v1/tokens/by-symbol \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```

## DeFi

### GET

| Path                                                                                                                                                              | Est. CU | Description                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol) |      80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |

### POST

| Path                                                                                                                                                                | Est. CU | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) |      80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) |      80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address.                                          |

## Market Data

### GET

| Path                                                                                                                                                                  | Est. CU | Description                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol)     |      80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getFloorPrice](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-floor-price-v-3) |     160 | Retrieves the floor prices of an NFT collection across different marketplaces.                                                                                   |

### POST

| Path                                                                                                                                                                | Est. CU | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) |      80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) |      80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address.                                          |

## NFT

### GET

| Path                                                                                                                                                                                               | Est. CU | Description                                                                                                                                                      |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getCollectionMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-collection-metadata-v-3)     |     480 | Retrieves high-level collection or contract-level information for an NFT collection.                                                                             |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getCollectionsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-collections-for-owner-v-3) |     720 | Retrieves all NFT collections held by a specified owner address.                                                                                                 |
| [direct/v1/Alchemy/\{chain}/nft/v3/computeRarity](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/compute-rarity-v-3)                            |     160 | Calculates the rarity of each attribute within an NFT.                                                                                                           |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getContractMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-contract-metadata-v-3)         |     320 | Retrieves high-level collection or contract-level information for an NFT.                                                                                        |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getContractsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-contracts-for-owner-v-3)     |     640 | Retrieves all NFT contracts held by a specified owner address.                                                                                                   |
| [direct/v1/Alchemy/\{chain}/nft/v3/getFloorPrice](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-floor-price-v-3)                              |     160 | Retrieves the floor prices of an NFT collection across different marketplaces.                                                                                   |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/invalidateContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/invalidate-contract-v-3)            |     160 | Marks all cached tokens for the specified contract as stale, ensuring the next query fetches live data instead of cached data.                                   |
| [direct/v1/Alchemy/\{chain}/nft/v3/isAirdropNFT](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/is-airdrop-nft-v-3)                                 |     160 | Determines whether a specific token is marked as an airdrop. Airdrops are defined as NFTs minted to a user address in a transaction sent by a different address. |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/isHolderOfContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/is-holder-of-contract-v-3)         |     160 | Determines whether a specific wallet holds any NFT from a given contract.                                                                                        |
| [direct/v1/Alchemy/\{chain}/nft/v3/isSpamContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/is-spam-contract-v-3)                             |     160 | Determines whether a specific contract is marked as spam by Alchemy.                                                                                             |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nft-metadata-v-3)                         |     160 | Retrieves the metadata associated with a specific NFT.                                                                                                           |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTSales](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-sales-endpoints/get-nft-sales-v-3)                                  |     320 | Retrieves NFT sales that have occurred through on-chain marketplaces.                                                                                            |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getNFTsForCollection](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nf-ts-for-collection-v-3)     |     100 | Retrieves all NFTs associated with a specific NFT collection.                                                                                                    |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getNFTsForContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nf-ts-for-contract-v-3)         |    1200 | Retrieves all NFTs associated with a specific NFT contract.                                                                                                      |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-nf-ts-for-owner-v-3)                    |     960 | Retrieves all NFTs currently owned by a specified address.                                                                                                       |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getOwnersForContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-owners-for-contract-v-3)     |     960 | Retrieves all owners associated with a specific NFT contract.                                                                                                    |
| [direct/v1/Alchemy/\{chain}/nft/v3/getOwnersForNFT](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-owners-for-nft-v-3)                     |     160 | Retrieves the owner(s) for a specific token.                                                                                                                     |
| [direct/v1/Alchemy/\{chain}/nft/v3/reportSpam](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/report-spam-v-3)                                      |     100 | Reports a specific address to the API if it is suspected to be spam.                                                                                             |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/searchContractMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/search-contract-metadata-v-3)   |     960 | Searches for a keyword across metadata of all ERC-721 and ERC-1155 smart contracts.                                                                              |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getSpamContracts](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-spam-endpoints/get-spam-contracts-v-3)                   |     960 | Returns a list of all spam contracts marked by Alchemy.                                                                                                          |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/summarizeNFTAttributes](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/summarize-nft-attributes-v-3)   |     160 | Generates a summary of attribute prevalence for a specific NFT collection.                                                                                       |

### POST

| Path                                                                                                                                                                                                  | Est. CU | Description                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getContractMetadataBatch](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-contract-metadata-batch-v-3) |     960 | Retrieves metadata for a list of specified contract addresses in a single request.    |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getNFTMetadataBatch](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/get-nft-metadata-batch-v-3)           |     960 | Retrieves metadata for up to 100 specified NFT contracts in a single request.         |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/refreshNftMetadata](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-metadata-endpoints/refresh-nft-metadata-v-3)              |      80 | Submits a request for Alchemy to refresh the cached metadata of a specific NFT token. |

## Other

### POST

| Path                                                                                                            | Est. CU | Description                                                                                           |
| --------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/hyperliquid/info](https://www.alchemy.com/docs/chains/hyperliquid/hyperliquid-info-endpoint) |     100 | Alchemy Hyperliquid info endpoint. Use the `type` field in the request body to specify the operation. |

## Token

### GET

| Path                                                                                                                                                              | Est. CU | Description                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-symbol](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-symbol) |      80 | Fetches current prices for multiple tokens using their symbols. Returns a list of token prices, each containing the symbol, prices, and an optional error field. |

### POST

| Path                                                                                                                                                                | Est. CU | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <code>direct/v1/Alchemy/\{chain}/v2</code>                                                                                                                          |     100 |                                                                                                                                                                                        |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) |      80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |
| [direct/v1/Alchemy/prices/v1/tokens/historical](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-historical-token-prices) |      80 | Provides historical price data for a single token over a time range. You can identify the token by symbol or by network and contract address.                                          |

## Wallets

### GET

| Path                                                                                                                                                                                               | Est. CU | Description                                                               |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ------------------------------------------------------------------------- |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getCollectionsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-collections-for-owner-v-3) |     720 | Retrieves all NFT collections held by a specified owner address.          |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/getContractsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-contracts-for-owner-v-3)     |     640 | Retrieves all NFT contracts held by a specified owner address.            |
| [direct/v1/Alchemy/\{chain}/nft/v3<br />/isHolderOfContract](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/is-holder-of-contract-v-3)         |     160 | Determines whether a specific wallet holds any NFT from a given contract. |
| [direct/v1/Alchemy/\{chain}/nft/v3/getNFTsForOwner](https://www.alchemy.com/docs/reference/nft-api-endpoints/nft-api-endpoints/nft-ownership-endpoints/get-nf-ts-for-owner-v-3)                    |     960 | Retrieves all NFTs currently owned by a specified address.                |

### POST

| Path                                                                                                                                                                | Est. CU | Description                                                                                                                                                                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/Alchemy/prices/v1/tokens/by-address](https://www.alchemy.com/docs/data/prices-api/prices-api-endpoints/prices-api-endpoints/get-token-prices-by-address) |      80 | Fetches current prices for multiple tokens using network and address pairs. Returns a list of token prices, each containing the network, address, prices, and an optional error field. |