Skip to main content
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/yield/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": ["peg.depeg.start", "vault.cap.changed"]
     }' \
  "https://api.alterscope.org/v2/webhooks"
The signing secret is server-generated — you cannot supply it in the request body. It is returned once in the 201 response as data.signing_secret (prefixed whsec_). Store it then; rotate later via POST /v2/webhooks/{id}/rotate-secret.

​
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"