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

# Overlay API

> SolanaとEVMチェーンでトークン、NFT、ウォレットを発行するためのAPI

Overlay APIは、SolanaとEVM系ネットワークでトークン、NFT、ウォレットを作成・操作するためのAPIです。

<CardGroup cols={2}>
  <Card title="Wallets" icon="wallet" href="/reference/overview">
    API経由のウォレットを発行します。秘密鍵はレスポンスでのみ返します。
  </Card>

  <Card title="Tokens" icon="coins" href="/guides/token-flow">
    トークンの作成、mint、transfer、burnに対応します。
  </Card>

  <Card title="NFTs" icon="image" href="/guides/nft-flow">
    NFTコレクション作成とNFT mintに対応します。
  </Card>
</CardGroup>

## Core concepts

<AccordionGroup>
  <Accordion title="API key authentication">
    外部APIは `api-key` ヘッダーで認証します。`auth-key` は不要です。
  </Accordion>

  <Accordion title="Managed user wallets">
    ユーザー登録時にSolanaとEVMのウォレットを1つずつ作成し、`network` に応じて自動利用します。
  </Accordion>

  <Accordion title="Usage tracking">
    API利用は `usages` コレクションに記録します。生の `api-key` は保存しません。
  </Accordion>
</AccordionGroup>

## Base URL

```txt theme={null}
https://overlay.fun
```

## Authentication

発行系APIは、HTTPヘッダーに `api-key` を指定します。

```http theme={null}
api-key: ovl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
```

`auth-key` は不要です。

## First API request

```bash theme={null}
curl --location 'https://overlay.fun/wallets' \
  --header 'api-key: ovl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "network": "solana"
  }'
```

成功すると、API経由で発行されたウォレットの `public_key` と `secret_key` が返ります。

<Warning>
  API経由で発行されたウォレットの `secret_key` はレスポンスでのみ返され、DBには保存されません。
</Warning>