Empezar

Referencia

Límites y uso

Esta referencia está en inglés. La navegación y las etiquetas están traducidas.

Limits apply per key and count REST requests and MCP tool calls together. The data changes once a day, so caching goes a long way.

Limits

  • Per key, per minute60 requests
  • Per key, per day (UTC)5,000 requests
  • Signed-in web session, per minute300 requests
  • Public endpoints, per IP, per minute120 requests

Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds until the window resets) for the window closest to running out. Over the limit you get 429 rate_limited with Retry-After.

Need more? Write to us with what you are building.

Headers on every response
RateLimit-Limit: 60
RateLimit-Remaining: 42
RateLimit-Reset: 18
RateLimit-Policy: 60;w=60
Over the limit
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 18
RateLimit-Limit: 60
RateLimit-Remaining: 0
RateLimit-Reset: 18
Respuesta429
{
  "type": "https://yieldsniper.finance/developers/errors#rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "Limit of 60 requests per minute reached for this key. Retry after 18 seconds.",
  "request_id": "req_1c7e90d1b4f82a6e5d3c9b07"
}

Caching

  • Responses for the same screen don't change. Cache them until as_of moves; GET /screens/latest is a cheap way to check.
  • Every GET returns an ETag. Send it in If-None-Match and an unchanged response comes back as 304 with no body.
  • Ask for what you need: fields trims rows, and id in (…) fetches a known set in one call instead of one call per instrument.
Conditional request
curl https://yieldsniper.finance/api/v1/screens/latest \
  -H "Authorization: Bearer $YS_API_KEY" \
  -H 'If-None-Match: "VVzbh_ReUWWmU3lOurOO-Hwh3GM"'

# HTTP/1.1 304 Not Modified (no body)

Usage

Settings → API & MCP shows requests and MCP calls per day for the last 14 days, across your active keys, next to today's limit.

Usage is counted per key per UTC day. Revoking a key removes it from the chart.