Docs
Beginner5 min read
Edit on GitHub

Quickstart

Get up and running with Nacho API in under 5 minutes

Get your first Cardano API response in under 5 minutes.

Step 1: Create an Account

Sign up at app.nacho.builders/login using:

  • Google Sign-In (recommended)
  • Email Magic Link

Your FREE API key is created automatically when you sign up.

Step 2: Find Your API Key

  1. Go to API Keys in your dashboard
  2. Copy your FREE tier key (starts with napi_)

Your FREE key includes 100,000 requests per day - enough to build and test most applications.

Step 3: Choose Your Network

Nacho API supports two networks with the same API key:

NetworkBase URLUse For
Mainnetapi.nacho.builders/v1/ogmiosProduction apps
Preprodapi.nacho.builders/v1/preprod/ogmiosTesting & development

Start with Preprod for development - you can get free test ADA from the Cardano Faucet.

Step 4: Make Your First Request

Query the current chain tip to verify everything works (examples use Mainnet - add /preprod for testnet):

curl -X POST https://api.nacho.builders/v1/ogmios \
-H "Content-Type: application/json" \
-H "apikey: YOUR_API_KEY" \
-d '{
  "jsonrpc": "2.0",
  "method": "queryNetwork/tip"
}'

Expected Response

{
  "jsonrpc": "2.0",
  "method": "queryNetwork/tip",
  "result": {
    "slot": 145832847,
    "id": "abc123def456..."
  }
}

Try It Live

Loading...

Next Steps

Now that you've made your first request:

Was this page helpful?