# Cosmic Agency Ad Accounts API

## API Docs
- Auth [获取 tenant_access_token](https://doc.cosmicads.app/500201046e0.md): Open-platform client_id + client_secret → tenant_access_token. Max TTL 2h. Remaining ≥ 30m returns the same token. Cache it.
- Auth [Bearer probe](https://doc.cosmicads.app/500201047e0.md): Hard rate limit: 10 requests / second per API client for this path. Over limit → `429 RATE_LIMITED` + `Retry-After`.
- AdAccounts [List ad accounts (token-bound client only)](https://doc.cosmicads.app/500201048e0.md): **Tenancy**
- TopUpsList [List top-ups for token-bound client](https://doc.cosmicads.app/500201053e0.md): **Tenancy**
- TopUpsList [Get one top-up (404 if other tenant)](https://doc.cosmicads.app/500201054e0.md): Hard rate limit: 10 requests / second per API client for this path. Over limit → `429 RATE_LIMITED` + `Retry-After`.
- FundTransfersList [List clear/deduct tickets for token-bound client](https://doc.cosmicads.app/500201055e0.md): **Tenancy**
- FundTransfersList [Get one fund transfer (404 if other tenant)](https://doc.cosmicads.app/500201056e0.md): Hard rate limit: 10 requests / second per API client for this path. Over limit → `429 RATE_LIMITED` + `Retry-After`.
- Insights [Daily spend for Meta ad accounts](https://doc.cosmicads.app/528949853e0.md): **Insights**
- Insights [Daily spend by country for Meta ad accounts](https://doc.cosmicads.app/528949854e0.md): **Insights**
- TopupAndBalance [Submit topup (aligns with New Top-up modal)](https://doc.cosmicads.app/500201050e0.md): **Top-up**
- TopupAndBalance [Balance clear → wallet (pending approval)](https://doc.cosmicads.app/500201051e0.md): **Balance clear**
- TopupAndBalance [Partial deduct → wallet (pending approval)](https://doc.cosmicads.app/500201052e0.md): **Partial deduct**