The Tradeics API skill focuses agents on correct HTTP integration — auth, envelopes, pagination, errors, clients, and versioning — independent of any single product domain.
Goals
- Generate code that matches REST API V2.
- Prefer official API clients (Postman, OpenAPI, Insomnia, Bruno, Hoppscotch).
- Honor rate limits, errors, and pagination.
Core conventions the skill must encode
| Topic | Canonical guide |
|---|---|
| Bearer auth | Authentication |
| First call | First request |
| Envelope & status | Reference intro + Errors guide |
| Environments | Versioning |
| Collections | OpenAPI / Postman under References |
Base URL (placeholder):
https://api.tradeics.example/v2/Behavior contract
- Prefer
/v2/— never invent legacy V1 paths. - Put secrets in env vars / secret stores, not source.
- On
429, exponential backoff with jitter. - Ignore unknown response fields.
Contents checklist
- Auth header templates (REST + LLM variants).
- Multi-language snippets pointer (First request).
- Client import links (OpenAPI 3.1, Postman).
- Common mistake catalog (wrong host, missing page param, ignoring scopes).
- When to escalate to Platform / Finance skills.