Agentic Payments: Nevermined

Autonomous agents can purchase a Baselayer API key and run real business searches, paying per request via Nevermined’s card delegation. No Baselayer account or human sign-up is required.

​

Environment

• Baselayer agentic API base URL: https://api.baselayer.com
• Nevermined environment: https://api.live.nevermined.app. Nevermined API keys for this network start with live.
• Payment scheme: nvm:card-delegation (credit or debit card using Nevermined’s card delegation)
• Payment plan: Baselayer Startup: $10.00 per 100 credits (plan details)
• Agent listing: Baselayer Business Search Agent

​

One-time payment setup

1. Get a Nevermined API key. A human signs in once at https://nevermined.app and creates an API key for the live environment (starts with live). For a fully agentic handoff, use the embedded login flow: host a callback on 127.0.0.1 and send your human to https://nevermined.app/auth/cli?callback_url=http://127.0.0.1:<port>/callback. The key is delivered to your callback. Store it and send it as Authorization: Bearer <api-key> on every Nevermined call.
2. Enroll a card (one-time, human required). Either directly in the Nevermined app (Payment Methods → Enroll card), or via the embedded flow: mint a session with POST https://api.live.nevermined.app/api/v1/embed/session ({"returnUrl": "http://127.0.0.1:<port>/callback"}), then send your human to https://embed.nevermined.app/cards/setup?sessionToken=<token>&returnUrl=...&state=<random>&provider=stripe.
3. Create a spending delegation (programmatic): POST https://api.live.nevermined.app/api/v1/delegation/create with {"provider": "stripe", "providerPaymentMethodId": "<pm_...>", "spendingLimitCents": 10000, "durationSecs": 604800, "currency": "usd"}. A delegation authorizes spending within a budget and time window. Reuse it until spent or expired.
4. Mint an x402 access token (programmatic, repeatable): POST https://api.live.nevermined.app/api/v1/x402/permissions with {"accepted": {"scheme": "nvm:card-delegation", "network": "stripe", "planId": "<plan id above>"}, "delegationConfig": {"delegationId": "<your delegation>"}} → returns accessToken.

​

Buying and using Baselayer

​

1. Purchase an API key: POST /alpha/api_keys

POST https://api.baselayer.com/alpha/api_keys
Content-Type: application/json
payment-signature: <x402 access token>

{"name": "my-agent", "default_request_mode": "sync"}

{
  "id": "…",
  "name": "my-agent",
  "key": "prod_…",
  "default_request_mode": "sync"
}

​

2. Run a business search: POST /alpha/searches

POST https://api.baselayer.com/alpha/searches
Content-Type: application/json
payment-signature: <x402 access token>
X-API-Key: prod_…
Prefer: wait=120

{"name": "Howard Concrete Pumping Co Inc",
 "address": "2327 Hill Church Houston Rd, Canonsburg PA 15317"}

​

Python example

import httpx
from payments_py import Payments
from payments_py.common.types import PaymentOptions
from payments_py.x402.types import DelegationConfig, X402TokenOptions

PLAN_ID = "64016128970723825062202451177754352720194073054658343333156009220723821177122"
AGENT_ID = "60798063874007247008401413456869371418449913824213519077458224260713519377086"
BASE = "https://api.baselayer.com"

payments = Payments.get_instance(
    PaymentOptions(nvm_api_key="live:…", environment="live")
)
card = payments.delegation.list_payment_methods(provider="stripe")[0]
delegation = payments.delegation.create_delegation(...)  # step 3 above
token = payments.x402.get_x402_access_token(
    PLAN_ID,
    AGENT_ID,
    token_options=X402TokenOptions(
        scheme="nvm:card-delegation",
        delegation_config=DelegationConfig(delegation_id=delegation.delegation_id),
    ),
)["accessToken"]

key = httpx.post(
    f"{BASE}/alpha/api_keys",
    json={"name": "my-agent", "default_request_mode": "sync"},
    headers={"payment-signature": token},
).json()["key"]

results = httpx.post(
    f"{BASE}/alpha/searches",
    json={"name": "Acme Corp", "address": "1 Main St, Dover, DE"},
    headers={"payment-signature": token, "X-API-Key": key, "Prefer": "wait=120"},
    timeout=180,
).json()

​

Errors

• 402 + payment-required header — missing, invalid, or exhausted payment token. Decode the header, (re)mint a token, retry.
• 404 within /alpha — only the two endpoints above are served.
• You are only charged for successful (2xx) requests.

​

Reference

• Nevermined x402 documentation
• Nevermined SDK + API docs index
• Baselayer discovery listing on Nevermined
• Baselayer API reference