Keys and authentication

​

Send your key

# Option 1
curl -H "x-api-key: ay_your_key" "https://api.alphayou.net/api/v1/datasets"

# Option 2
curl -H "Authorization: Bearer ay_your_key" "https://api.alphayou.net/api/v1/datasets"

​

Get, swap and revoke keys

• A key is shown once, when you make it. Copy it then. We cannot show it again.
• An account can hold up to 2 live keys at once. Make the new key, switch your code to it, then revoke the old one. Nothing goes down.
• A revoked key stops working at once. Calls with it return 401.
• On the Free plan the daily allowance belongs to the account. Every key on the account, and every alias of the same inbox (for example name+2@gmail.com), shares one allowance.
• On Pro each key has its own allowance.
• Making extra keys or accounts to get around a limit is not allowed. See the API terms.

​

Check what your key can do

curl -H "x-api-key: $ALPHAYOU_API_KEY" \
  "https://api.alphayou.net/api/mcp/whoami"

{
  "tier": "free",
  "tools": [
    "alphayou_search_datasets",
    "alphayou_funds",
    "alphayou_company_disclosures",
    "alphayou_insider_trades"
  ],
  "toolCount": 4
}

​

Keep your key safe

• Treat it like a password. You are responsible for every call made with it.
• Never put it in a web page, a mobile app or a public code repository.
• Never paste it into a chat, a screenshot or a support message.
• If it leaks, make a new key and revoke the old one at once.

​

Get help