Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.alterscope.org/llms.txt

Use this file to discover all available pages before exploring further.

The API is plain HTTPS + JSON. Anything that speaks both can call it.

​
List yield opportunities

curl -H "Authorization: Bearer $ALTERSCOPE_API_KEY" \
     -H "Accept: application/json" \
  "https://api.alterscope.org/v2/yield/opportunities?limit=10&risk_band=1"

​
Get a single opportunity

curl -H "Authorization: Bearer $ALTERSCOPE_API_KEY" \
  "https://api.alterscope.org/v2/yield/opportunities/hyperliquid-btc-basis"

​
Analyze a portfolio (POST with body)

curl -H "Authorization: Bearer $ALTERSCOPE_API_KEY" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{
       "positions": [
         { "opportunity_id": "hyperliquid-btc-basis", "notional_usd": 50000 },
         { "opportunity_id": "aave-usdc-lending",     "notional_usd": 50000 }
       ],
       "include_scenarios": true
     }' \
  "https://api.alterscope.org/v2/portfolio/analyze"

​
Subscribe to a webhook

curl -H "Authorization: Bearer $ALTERSCOPE_API_KEY" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{
       "url": "https://your.app/alterscope-webhook",
       "events": ["risk.depeg.start", "risk.cap.changed"],
       "secret": "whsec_..."
     }' \
  "https://api.alterscope.org/v2/webhooks"

​
Read a rate-limit window

curl -sI -H "Authorization: Bearer $ALTERSCOPE_API_KEY" \
  "https://api.alterscope.org/v2/yield/opportunities?limit=1" \
  | grep -i "X-RateLimit"