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

# Quickstart

> Try Nova with a token risk check, Solana to Hyperliquid Perps route, token search, and public wallet intelligence request.

Use this public base URL:

```text theme={"dark"}
https://api-nova.tech
```

## 1. Make A Public Request

Public API requests do not require an API key:

```bash theme={"dark"}
curl "https://api-nova.tech/v1/data/tokens/search?query=bonk"
```

The docs playground uses the same simple shape. For user context, pass a public wallet address.

## 2. Start With Security

Check a token before you show it:

```bash theme={"dark"}
curl "https://api-nova.tech/v1/security/token-risk" \
  -H "Content-Type: application/json" \
  -d '{ "mint": "So11111111111111111111111111111111111111112" }'
```

## 3. Send SOL To Hyperliquid Perps

Build a wallet-ready route from Solana into Hyperliquid Perps:

```bash theme={"dark"}
curl "https://api-nova.tech/v1/bridge/solana-to-hyperliquid-perps" \
  -H "Content-Type: application/json" \
  -d '{
    "solanaAddress": "9xQeWvG816bUx9EPfQ5D9b8fRGyJitf8F6f4fH6QJjAo",
    "hyperliquidAddress": "0xf3d63166f0ca56c3c1a3508fce03ff0cf3fb691e",
    "amount": "0.1",
    "asset": "SOL"
  }'
```

Use `POST /v1/bridge/hyperliquid-perps-to-solana` to bring Hyperliquid Perps USDC back to Solana.

## 4. Add Wallet Data

Load a wallet by public address:

```bash theme={"dark"}
curl "https://api-nova.tech/v1/data/wallets/9xQeWvG816bUx9EPfQ5D9b8fRGyJitf8F6f4fH6QJjAo"
```

Search tokens when you need discovery:

```bash theme={"dark"}
curl "https://api-nova.tech/v1/data/tokens/search?query=bonk"
```

## 5. Add Market Context

```bash theme={"dark"}
curl "https://api-nova.tech/v1/data/tokens/trending"
```

Use public wallet addresses, token mints, transaction signatures, or URLs. Do not send private keys, seed phrases, recovery phrases, passcodes, backup codes, or signing payloads.

## 6. Respect Limits

Every endpoint has practical rate limits and request limits so the playground stays fast and reliable.