Alterscope Developer API

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"

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"

​List yield opportunities

​Get a single opportunity

​Analyze a portfolio (POST with body)

​Subscribe to a webhook

​Read a rate-limit window

List yield opportunities

Get a single opportunity

Analyze a portfolio (POST with body)

Subscribe to a webhook

Read a rate-limit window