> ## 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.

# Nova Bridge

> Move SOL or USDC between Solana and Hyperliquid Perps with Nova's public bridge API.

Nova Bridge is the public API for routes between Solana and Hyperliquid Perps.

Use it when your app needs to:

* Send SOL or USDC from Solana into Hyperliquid Perps
* Move Hyperliquid USDC back to Solana
* Show wallet-ready route plans before the user approves anything
* Track route status after the user submits the transaction

## Base URL

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

No API key is required. Public requests are protected by rate limits, request caps, and abuse monitoring.

## Routes

| Route                                         | Input                     | Output                    |
| --------------------------------------------- | ------------------------- | ------------------------- |
| `POST /v1/bridge/solana-to-hyperliquid-perps` | SOL or USDC on Solana     | USDC on Hyperliquid Perps |
| `POST /v1/bridge/hyperliquid-perps-to-solana` | USDC on Hyperliquid Perps | SOL or USDC on Solana     |

## Send SOL To 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"
  }'
```

The response includes a `requestId`, route details, and a `routePlan` with wallet-executable steps. Your app should show the plan to the user and let the wallet handle approval and signing.

## Bring USDC Back To Solana

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

## Check Status

```bash theme={"dark"}
curl "https://api-nova.tech/v1/bridge/hyperliquid-perps/status?requestId=0xrequest"
```

Status responses include the current route state and any indexed transaction hashes once available.

<Note>
  Nova Bridge only needs public addresses and amount details. Do not send seed phrases, private keys, passcodes, backup codes, or signing payloads.
</Note>