General
Get Your API Key
Learn how to obtain and use your ChainPatrol API key
Getting Your API Key
To access ChainPatrol’s APIs and services, you’ll need an API key. Here’s how to get one:
- Go to your Organization Dashboard
- Navigate to the organization’s
settings
page - Navigate to
API keys
- Click on
Create Key
and pick your settings
Types of API Keys
Organization vs User Keys
-
Organization Keys: Grant organization-level attribution
- Reports submitted with organization keys are attributed to a machine user
- Best for automated systems, integrations, and organization-level workflows
- Ideal for bots, automated reporting systems, and CI/CD pipelines
-
User Keys: Grant user-level attribution
- Reports submitted with user keys are attributed directly to your user account
- Best for personal use and when individual accountability is needed
- Ideal for manual reporting and personal tooling
Test vs Live Keys
ChainPatrol provides both test and live environments to help you develop and test your integration safely.
-
Test Keys: For distinguishing when being used in development and testing
- Use in development environments
- These keys still affect production data
-
Live Keys: For production use
- Use in production environments
- Affects real data and reports
- Required for actual threat detection and reporting
API Key Format
ChainPatrol API keys follow this format:
- Always start with the prefix
cp_
- Are unique to your organization
- Should be kept secure and not shared publicly
Using Your API Key
When making API requests to ChainPatrol, include your API key in the request headers:
Support
If you need help with your API key or have any questions, you can:
- Email us at [email protected]
- Visit our documentation for more information about our APIs
Was this page helpful?