Skip to main content

​
How to authenticate your Uniblock API key

Every request to the Uniblock API must include your project API key in the request header. The key identifies your project, tracks usage, and gates access to the endpoints your plan supports.

​
Steps

  1. Obtain your API key: Navigate to your Uniblock dashboard, open your project, and copy the API key shown on the Overview page.
  2. Include the key in every request: Add an X-API-Key header to each HTTP request you make to the Uniblock API. 
curl --location \
'https://api.uniblock.dev/uni/v1/nft/balance?chainId=1&walletAddress=0x...' \
--header 'X-API-Key: YOUR_UNIBLOCK_API_KEY'
  1. Test in the API Tester: Open the Uniblock Explorer, click Authorize, paste your API key, and click Authorize again. Every endpoint in the explorer will now send requests authenticated as your project.
  2. Start calling endpoints: With your key in place, you’re ready to call any Unified API endpoint your plan supports. Usage and analytics for all authenticated calls appear in your project dashboard under Endpoints → Analytics.
If you switch projects in the dashboard, update the API key in your code to match the new project — each project has its own key and its own usage metrics.