> ## Documentation Index
> Fetch the complete documentation index at: https://blackswan-23965643.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BlackSwan API Access: Authentication and Rate Limits

> BlackSwan's testnet REST API requires no API key. Learn about rate limits, production access, and how to contact us for higher limits.

BlackSwan's testnet API is fully open — no API key, no account creation, and no authentication headers required. Send requests directly to the REST API and start receiving live credit data immediately. When you're ready to move to production or need higher throughput, contact the BlackSwan team to discuss elevated access.

***

## Testnet Access

On testnet (Polygon Amoy and Ethereum Sepolia), the BlackSwan API is publicly accessible. Every endpoint accepts unauthenticated `GET` requests. No registration is needed and no keys need to be managed.

Make requests directly to the base URL:

```bash theme={null}
curl https://api.blackswanfinance.xyz/v1/credit/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4
```

To target a specific network, append the `?network` query parameter:

```bash theme={null}
# Polygon Amoy (default)
curl "https://api.blackswanfinance.xyz/v1/credit/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4?network=amoy"

# Ethereum Sepolia
curl "https://api.blackswanfinance.xyz/v1/credit/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4?network=sepolia"
```

***

## Production Access

When you're ready to deploy to production or require capabilities beyond the free testnet tier, reach out to the BlackSwan team directly:

**Email:** [contact@blackswanfinance.xyz](mailto:contact@blackswanfinance.xyz)

Production access includes:

* **Higher rate limits** suited for live application traffic
* **Mainnet support** once v1.1 launches (see note below)
* **Priority support** and dedicated onboarding assistance
* **SLA guarantees** for uptime and response time

Include a brief description of your use case, your expected request volume, and the networks you plan to target when reaching out.

***

## Rate Limits

The free testnet tier applies basic rate limits to ensure fair usage across all developers. These limits are intentionally permissive for development and testing workloads.

| Tier             | Rate Limit                 | Use Case                               |
| ---------------- | -------------------------- | -------------------------------------- |
| **Free Testnet** | Moderate (shared pool)     | Development, prototyping, demos        |
| **Production**   | Higher limits (negotiated) | Live applications, high-volume queries |

If you encounter `429 Too Many Requests` responses during development, reduce your request frequency or batch queries where possible. For sustained high-volume workloads, [contact us](mailto:contact@blackswanfinance.xyz) to discuss a production plan.

***

<Info>
  Mainnet support is planned for **BlackSwan v1.1**. The production API tier will unlock mainnet endpoints for Ethereum and Polygon. To be notified when mainnet access becomes available, reach out to [contact@blackswanfinance.xyz](mailto:contact@blackswanfinance.xyz) and ask to be added to the early-access list.
</Info>