P3 Lending Developer API

B2B API for reputation scores. Base URL: https://api.p3lending.space

Quickstart

1. Log in to p3lending.space, open Developers in the sidebar.
2. Create an API key (copy it once; it won’t be shown again).
3. Call the API with Authorization: Bearer <your_key>.

curl -H "Authorization: Bearer p3_live_..." \
  "https://api.p3lending.space/api/v1/reputation/score?user_id=UUID"

Auth

All /api/v1/* endpoints require an API key in the Authorization header:

Authorization: Bearer p3_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# or
Authorization: Bearer p3_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keys are scoped (e.g. score:read, score:history). Never store or log the raw key; store only the prefix if needed for display.

Endpoints

• GET /api/v1/reputation/score?user_id= — Score by user ID (scope: score:read).
• GET /api/v1/reputation/score/by-wallet?address= — Score by wallet address (scope: score:read).
• POST /api/v1/reputation/score/batch — Body: {"user_ids": ["uuid1", "uuid2"]} (scope: score:read).
• GET /api/v1/reputation/score/history?user_id=&from=&to= — Score history (scope: score:history).

OpenAPI spec: /docs/openapi.json.

Errors

Responses use HTTP status codes and a JSON body:

• 400 — Bad request (e.g. missing user_id).
• 401 — Invalid or missing API key.
• 403 — Valid key but missing required scope.
• 404 — User not found.
• 429 — Rate limit exceeded; check X-RateLimit-* headers.
• 503 — Developer API not configured.

Rate limits

Per-key limits (configurable when creating the key):

• X-RateLimit-Limit — Requests per minute.
• X-RateLimit-Remaining — Remaining in current window.
• X-RateLimit-Reset — Unix timestamp when the window resets.

When exceeded, the API returns 429.