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:

curl https://api.blackswanfinance.xyz/v1/credit/0x4EEA76237a91880B1c8B7a1c740610fFC0306EE4

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

# 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: [e-mail]

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 to discuss a production plan.

---

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 [e-mail] and ask to be added to the early-access list.