> ## 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 — GoldRush

> API endpoints for GoldRush.

# GoldRush — Direct API Endpoints

GoldRush provides 48 unique direct API endpoints across the following categories:

* DeFi (1 endpoint)
* Market Data (6 endpoints)
* NFT (14 endpoints)
* Scan (10 endpoints)
* Token (12 endpoints)
* Transaction (12 endpoints)
* Wallets (21 endpoints)

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

> **Learn more:** [GoldRush Documentation](https://goldrush.dev/docs/api-reference)

## Prefix and Example

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

**Example Request:**

```bash theme={null}
curl --request GET \
  --url https://api.uniblock.dev/direct/v1/GoldRush/v1/pricing/spot_prices/{chainName}/pools/{contractAddress} \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_UNIBLOCK_API_KEY'
```

## DeFi

### GET

| Path                                                                                                                                                                                                 | Est. CU | Description                                                                                                             |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ----------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/pricing/spot\_prices<br />/\{chainName}/pools/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices#get-pool-spot-prices) |    5000 | Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. |

## Market Data

### GET

| Path                                                                                                                                                                                                                     | Est. CU | Description                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | ----------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/pricing/spot\_prices<br />/\{chainName}/pools/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices#get-pool-spot-prices)                     |    5000 | Get the spot token pair prices for a specified pool contract address. Supports pools on Uniswap V2, V3 and their forks. |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/floor\_price](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-floor-price)                                          |    5000 | Get historical floor prices for a collection                                                                            |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/sale\_count](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-sale-count)                                            |    5000 | Get historical sales count for a collection                                                                             |
| [direct/v1/GoldRush/v1/pricing<br />/historical\_by\_addresses\_v2/\{chainName}<br />/\{quoteCurrency}/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) |    5000 | Get historical token prices                                                                                             |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/volume](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-volume)                                                     |    5000 | Get historical volume for a collection                                                                                  |

### POST

| Path                                                                                         | Est. CU | Description                                                                                                                      |
| -------------------------------------------------------------------------------------------- | ------: | -------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/hypercore/info](https://goldrush.dev/docs/goldrush-hyperliquid/overview) |    5000 | GoldRush is the complete data layer for Hyperliquid that offers a drop-in Hyperliquid /info API replacement with no rate limits. |

## NFT

### GET

| Path                                                                                                                                                                                                                              | Est. CU | Description                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | ---------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_nft](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address)                                                              |    5000 | Get NFTs for address                                 |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/\{collectionContract}/traits/\{trait}/attributes](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-attribute-values-collection-trait)                               |    5000 | Get attributes for a collection trait                |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/collections](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-chain-collections)                                                                                    |    5000 | Get chain collections                                |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/collection/\{collectionContract}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection)                              |    5000 | Check ownership in NFT collection                    |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/collection/\{collectionContract}<br />/token/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) |    5000 | Check ownership in NFT collection for specific token |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/floor\_price](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-floor-price)                                                   |    5000 | Get historical floor prices for a collection         |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/sale\_count](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-sale-count)                                                     |    5000 | Get historical sales count for a collection          |
| [direct/v1/GoldRush/v1/\{chainName}/nft\_market<br />/\{contractAddress}/volume](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-volume)                                                              |    5000 | Get historical volume for a collection               |
| [direct/v1/GoldRush/v1/\{chainName}/nft/approvals<br />/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-nft-approvals)                                                                    |    5000 | Get NFT approvals for address                        |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/\{contractAddress}/metadata](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-token-ids-for-contract-with-metadata)                                             |    5000 | Get NFTs from contract with metadata                 |
| [direct/v1/GoldRush/v1/\{chainName}/tokens<br />/\{contractAddress}/nft\_transactions/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-transactions-contract)                                     |    5000 | Get NFT transactions for contract                    |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/\{contractAddress}/metadata/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-metadata-token-id-contract)                                            |    5000 | Get single NFT from contract with metadata           |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/\{collectionContract}/traits](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-list-of-traits-collection)                                                           |    5000 | Get traits for a collection                          |
| [direct/v1/GoldRush/v1/\{chainName}/nft<br />/\{collectionContract}/traits\_summary](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-collection-trait-summary)                                                   |    5000 | Get trait summary for collection                     |

## Scan

### GET

| Path                                                                                                                                                                                                         | Est. CU | Description                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------- |
| [direct/v1/GoldRush/v1/chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains)                                                                                              |    5000 | Get all chains                               |
| [direct/v1/GoldRush/v1/chains/status](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses)                                                                               |    5000 | Get all chain statuses                       |
| [direct/v1/GoldRush/v1/\{chainName}/block\_v2<br />/\{startDate}/\{endDate}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights)                                             |    5000 | Get block heights                            |
| [direct/v1/GoldRush/v1/\{chainName}/block\_hash<br />/\{blockHash}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block)                  |    5000 | Get all transactions in a block (v3)         |
| [direct/v1/GoldRush/v1/\{chainName}/block<br />/\{blockHeight}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) |    5000 | Get all transactions in a block by page (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/block\_v2<br />/\{blockHeight}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block)                                                            |    5000 | Get a block                                  |
| [direct/v1/GoldRush/v1/\{chainName}/event<br />/\{eventType}/gas\_prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices)                                                   |    5000 | Get gas prices                               |
| [direct/v1/GoldRush/v1/\{chainName}/events/address<br />/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address)                            |    5000 | Get log events by contract address           |
| [direct/v1/GoldRush/v1/\{chainName}/events/topics<br />/\{topicHash}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash)                                         |    5000 | Get log events by topic hash(es)             |
| [direct/v1/GoldRush/v1/\{chainName}/events](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs)                                                                                       |    5000 | Get logs                                     |

## Token

### GET

| Path                                                                                                                                                                                                                     | Est. CU | Description                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/portfolio\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time)                            |    5000 | Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days. |
| [direct/v1/GoldRush/v1/allchains/address<br />/\{walletAddress}/balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions)                                               |    5000 | Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.                          |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_native](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance)                                         |    5000 | Get native token balance for address                                                                                                                |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address)                                                        |    5000 | Get token balances for address                                                                                                                      |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address)                    |    5000 | Get historical token balances for address                                                                                                           |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address)                               |    5000 | Get ERC20 token transfers for address                                                                                                               |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address)                                       |    5000 | Get Bitcoin balances for non-HD address                                                                                                             |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/hd\_wallets](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address)                                    |    5000 | Get Bitcoin balances for HD address                                                                                                                 |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address)                    |    5000 | Get historical Bitcoin balance for non-HD address                                                                                                   |
| [direct/v1/GoldRush/v1/pricing<br />/historical\_by\_addresses\_v2/\{chainName}<br />/\{quoteCurrency}/\{contractAddress}](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) |    5000 | Get historical token prices                                                                                                                         |
| [direct/v1/GoldRush/v1/\{chainName}/approvals<br />/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address)                                                 |    5000 | Get token approvals for address                                                                                                                     |
| [direct/v1/GoldRush/v1/\{chainName}/tokens<br />/\{tokenAddress}/token\_holders\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2)                      |    5000 | Get token holders as of any block height (v2)                                                                                                       |

## Transaction

### GET

| Path                                                                                                                                                                                                               | Est. CU | Description                                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------: | -------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_summary](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address)               |    5000 | Get transaction summary for address                |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address)                         |    5000 | Get ERC20 token transfers for address              |
| [direct/v1/GoldRush/v1/allchains/transactions](https://goldrush.dev/docs/api-reference/cross-chain/foundational-api/get-allchains-transactions)                                                                    |    5000 | Get multichain & multiaddress transactions         |
| [direct/v1/GoldRush/v1/cq/covalent/app/bitcoin<br />/transactions](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address)                                     |    5000 | Get transactions for Bitcoin address               |
| [direct/v1/GoldRush/v1/\{chainName}/block\_hash<br />/\{blockHash}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block)                        |    5000 | Get all transactions in a block (v3)               |
| [direct/v1/GoldRush/v1/\{chainName}/block<br />/\{blockHeight}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page)       |    5000 | Get all transactions in a block by page (v3)       |
| [direct/v1/GoldRush/v1/\{chainName}/bulk<br />/transactions/\{walletAddress}/\{timeBucket}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3)     |    5000 | Get bulk time bucket transactions for address (v3) |
| [direct/v1/GoldRush/v1/\{chainName}/bulk<br />/transactions/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3)                      |    5000 | Get earliest transactions for address (v3)         |
| [direct/v1/GoldRush/v1/\{chainName}/tokens<br />/\{contractAddress}/nft\_transactions/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-transactions-contract)                      |    5000 | Get NFT transactions for contract                  |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3)                 |    5000 | Get recent transactions for address (v3)           |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) |    5000 | Get paginated transactions for address (v3)        |
| [direct/v1/GoldRush/v1/\{chainName}/transaction\_v2<br />/\{txHash}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction)                                                      |    5000 | Get a transaction                                  |

## Wallets

### GET

| Path                                                                                                                                                                                                                              | Est. CU | Description                                                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/portfolio\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time)                                     |    5000 | Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days. |
| [direct/v1/GoldRush/v1/allchains/address<br />/\{walletAddress}/balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions)                                                        |    5000 | Fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.                          |
| [direct/v1/GoldRush/v1/address/\{walletAddress}<br />/activity](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity)                                                                        |    5000 | Get activity across all chains for address                                                                                                          |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_native](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance)                                                  |    5000 | Get native token balance for address                                                                                                                |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_nft](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address)                                                              |    5000 | Get NFTs for address                                                                                                                                |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address)                                                                 |    5000 | Get token balances for address                                                                                                                      |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address)                             |    5000 | Get historical token balances for address                                                                                                           |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_summary](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address)                              |    5000 | Get transaction summary for address                                                                                                                 |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transfers\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address)                                        |    5000 | Get ERC20 token transfers for address                                                                                                               |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/balances\_v2](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address)                                                |    5000 | Get Bitcoin balances for non-HD address                                                                                                             |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/hd\_wallets](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address)                                             |    5000 | Get Bitcoin balances for HD address                                                                                                                 |
| [direct/v1/GoldRush/v1/btc-mainnet/address<br />/\{walletAddress}/historical\_balances](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address)                             |    5000 | Get historical Bitcoin balance for non-HD address                                                                                                   |
| [direct/v1/GoldRush/v1/\{chainName}/bulk<br />/transactions/\{walletAddress}/\{timeBucket}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3)                    |    5000 | Get bulk time bucket transactions for address (v3)                                                                                                  |
| [direct/v1/GoldRush/v1/\{chainName}/bulk<br />/transactions/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3)                                     |    5000 | Get earliest transactions for address (v3)                                                                                                          |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/collection/\{collectionContract}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection)                              |    5000 | Check ownership in NFT collection                                                                                                                   |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/collection/\{collectionContract}<br />/token/\{tokenId}](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) |    5000 | Check ownership in NFT collection for specific token                                                                                                |
| [direct/v1/GoldRush/v1/\{chainName}/nft/approvals<br />/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-nft-approvals)                                                                    |    5000 | Get NFT approvals for address                                                                                                                       |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/resolve\_address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address)                                |    5000 | Get resolved address for registered address                                                                                                         |
| [direct/v1/GoldRush/v1/\{chainName}/approvals<br />/\{walletAddress}](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address)                                                          |    5000 | Get token approvals for address                                                                                                                     |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_v3](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3)                                |    5000 | Get recent transactions for address (v3)                                                                                                            |
| [direct/v1/GoldRush/v1/\{chainName}/address<br />/\{walletAddress}/transactions\_v3/page/\{page}](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3)                |    5000 | Get paginated transactions for address (v3)                                                                                                         |