Evaluate whether a requested USDC supply amount is realizable across approved Aave V3 and
Evaluate whether a requested USDC supply amount is realizable across approved Aave V3 and Morpho Blue lending opportunities on Base, with optional minimum supply APY and protocol filters.
10000 (raw units)
price
1
calls / 30d
1
unique payers
2026-09-13
updated
Provider
api.alphabuild.xyz · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x17fD9bf1C73f9E62A6AF16FC483279B3d83c1398",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"amount": "1000",
"asset": "USDC",
"target_environment": {
"chain_id": 8453,
"kind": "evm_chain",
"network_name": "base"
}
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"coverage_version": "lor-base-usdc-coverage-v1",
"evaluated_at": "2026-01-01T00:00:00.000Z",
"evidence": [],
"freshness": {
"block_number": "1",
"status": "fresh",
"target_state": "pinned_base_block"
},
"payment": {
"status": "settled",
"x402_implemented": true
},
"request_id": "00000000-0000-4000-8000-000000000000",
"result": {
"constraint_mode": "NONE",
"minimum_base_supply_apy": null,
"opportunities": [
{
"binding_constraint": "NONE",
"current_base_supply_apy": "0.04",
"maximum_feasible_amount": "1000",
"maximum_protocol_feasible_amount": "1000",
"maximum_return_floor_amount": null,
"modeled_apy_at_maximum_feasible_amount": "0.039",
"modeled_post_allocation_apy": "0.039",
"opportunity_id": "aave-v3-base-usdc",
"protocol": "aave-v3",
"protocol_state": {},
"rank": 1,
"verdict": "PROCEED"
}
],
"requested_amount": "1000",
"selected_opportunity": {
"binding_constraint": "NONE",
"current_base_supply_apy": "0.04",
"maximum_feasible_amount": "1000",
"maximum_protocol_feasible_amount": "1000",
"maximum_return_floor_amount": null,
"modeled_apy_at_maximum_feasible_amount": "0.039",
"modeled_post_allocation_apy": "0.039",
"opportunity_id": "aave-v3-base-usdc",
"protocol": "aave-v3",
"protocol_state": {},
"rank": 1,
"verdict": "PROCEED"
},
"selection": {
"candidate_count": 6,
"evaluated_count": 6,
"mode": "ALL_SUPPORTED",
"ranking_completeness": "COMPLETE",
"ranking_policy_version": "lor-ranking-v2",
"selected_opportunity_id": "aave-v3-base-usdc",
"selected_protocol": "aave-v3"
}
},
"ruleset_version": "lor-ruleset-v1",
"service": "lor",
"service_version": "0.1.0",
"target_context": {
"block_number": "1",
"chain_id": 8453,
"kind": "evm_chain",
"network_name": "base"
},
"verdict": "PROCEED",
"warnings": []
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Requested USDC amount in whole-token decimal units, not atomic units.",
"pattern": "^[0-9]+(?:\\.[0-9]+)?$",
"type": "string"
},
"asset": {
"const": "USDC",
"type": "string"
},
"minimum_base_supply_apy": {
"description": "Optional minimum acceptable base supply APY as a decimal fraction.",
"pattern": "^[0-9]+(?:\\.[0-9]+)?$",
"type": "string"
},
"opportunity_id": {
"description": "Optional approved opportunity identifier; requires protocol.",
"minLength": 1,
"type": "string"
},
"protocol": {
"description": "Optional protocol filter.",
"enum": [
"aave-v3",
"morpho-blue"
],
"type": "string"
},
"target_environment": {
"additionalProperties": false,
"properties": {
"chain_id": {
"const": 8453,
"type": "integer"
},
"kind": {
"const": "evm_chain",
"type": "string"
},
"network_name": {
"const": "base",
"type": "string"
}
},
"required": [
"kind",
"chain_id"
],
"type": "object"
}
},
"required": [
"target_environment",
"asset",
"amount"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"payment": {
"properties": {
"status": {
"type": "string"
},
"x402_implemented": {
"type": "boolean"
}
},
"required": [
"status",
"x402_implemented"
],
"type": "object"
},
"request_id": {
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"type": "string"
},
"result": {
"properties": {
"constraint_mode": {
"enum": [
"NONE",
"MINIMUM_BASE_SUPPLY_APY"
],
"type": "string"
},
"minimum_base_supply_apy": {
"type": [
"string",
"null"
]
},
"opportunities": {
"items": {
"type": "object"
},
"type": "array"
},
"requested_amount": {
"type": "string"
},
"selected_opportunity": {
"type": [
"object",
"null"
]
},
"selection": {
"type": "object"
}
},
"required": [
"requested_amount",
"minimum_base_supply_apy",
"constraint_mode",
"selection",
"selected_opportunity",
"opportunities"
],
"type": "object"
},
"service": {
"const": "lor",
"type": "string"
},
"verdict": {
"enum": [
"PROCEED",
"PROCEED_WITH_LIMIT",
"BLOCKED",
"UNKNOWN"
],
"type": "string"
}
},
"required": [
"request_id",
"service",
"verdict",
"result",
"payment"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.alphabuild.xyz/lor/v1/evaluate" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.alphabuild.xyz/lor/v1/evaluate");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.alphabuild.xyz/lor/v1/evaluate")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/8040.json, and this resource appears in /discovery/resources and /discovery/search.