Getting Started with 1inch APIs

Go from zero to your first API response in a few minutes. Everything below works on the free plan.

1. Create your account

Sign up at the 1inch Business Portal. During onboarding you create your first application — applications are how the portal organizes API keys, usage, and logs.

2. Get your API key

Your API key is available under Applications. Keys are bearer tokens; keep them out of client-side code and public repositories. For user-consent flows and server-to-server access without shared secrets, the platform also supports OAuth 2.1.

3. Make your first request

Every API accepts the key as an Authorization header (or an apiKey query parameter — see Authentication):

         
         

           Bash
         
 
         
         

           
           

             
1
2
3
4
           
 
           
           
curl -X 'GET' \
  'https://api.1inch.com/swap/v5.2/1/tokens' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'
         
       

A successful response returns the tradable token list on Ethereum (chain ID 1) — swap the 1 for any supported chain.

Prefer TypeScript? The official SDKs wrap order building, signing, and submission for the swap protocols:

         
         

           Bash
         
 
         
         

           
           

             
1
           
 
           
           
npm install @1inch/fusion-sdk
         
       

4. Explore from here

• Run requests interactively in the API playground on any API reference page
• Pick your product in Products at a glance
• Connect your AI coding assistant via the 1inch MCP server — it can query these docs and call the APIs while you build
• Hitting an error? See API troubleshooting