Agentic Endpoints Credits API

The Credits API from Agentic Endpoints — 4 operation(s) for credits.

Operations 5

POST /credits/buy Buy $6.00 of prepaid credit for $5.00 (20% bonus). #
POST /credits/buy-25 Buy $32.50 of prepaid credit for $25.00 (30% bonus). #
POST /credits/trial Get a free evaluation credit, no account required #
GET /credits/balance Check a prepaid credit balance #
POST /credits/balance Check a prepaid credit balance #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentic-endpoints-com:agentic-endpoints-com-credits-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentic-endpoints-com-credits-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: agentic-endpoints Credits API
  version: 1.0.0
  license:
    name: MIT
    identifier: MIT
  description: 'Pay-per-call utilities for autonomous agents. No signup, no API keys, no invoices: every endpoint answers HTTP 402 with a price and serves the request once payment is signed.'
servers:
- url: https://agentic-endpoints.com
tags:
- name: Credits
paths:
  /credits/buy:
    post:
      summary: Buy $6.00 of prepaid credit for $5.00 (20% bonus).
      description: Buy $6.00 of prepaid credit for $5.00 (20% bonus). Returns a credit token; send it as X-Credit-Token on any paid endpoint to be debited at list price with no per-call payment signature.. Costs $5.00, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: credits_buy
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
            example: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                credit_token: ae_...
                balance_usd: '6.000000'
                paid: $5.00
                bonus: 20%
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Credits
  /credits/buy-25:
    post:
      summary: Buy $32.50 of prepaid credit for $25.00 (30% bonus).
      description: Buy $32.50 of prepaid credit for $25.00 (30% bonus). Returns a credit token; send it as X-Credit-Token on any paid endpoint to be debited at list price with no per-call payment signature.. Costs $25.00, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: credits_buy_25
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
            example: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                credit_token: ae_...
                balance_usd: '32.500000'
                paid: $25.00
                bonus: 30%
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Credits
  /credits/trial:
    post:
      summary: Get a free evaluation credit, no account required
      description: 'Returns a credit token carrying a $0.10 balance — about 10 calls — immediately, with no account, no email, no wallet and no approval step. Send it as X-Credit-Token on any paid endpoint exactly like a purchased one. Takes no request body. One allowance per client address: calling again returns the same token and whatever balance remains, so retrying is safe but does not top the balance up. It exists because paying per call requires a funded wallet first, which asks a caller to commit money before it can tell whether the answer is worth buying.'
      operationId: credits_trial
      responses:
        '200':
          description: Success, or a settled refusal. Paid routes answer 200 with a machine-readable `status` (e.g. "forbidden", "not_found", "precondition_failed", "conflict") rather than a 4xx, because any status >=400 cancels x402 settlement and would give the answer away for free. Always branch on `status`, not on the HTTP code.
        '400':
          description: Malformed request.
        '404':
          description: No such record.
        '429':
          description: Rate limited.
      security: []
      tags:
      - Credits
  /credits/balance:
    get:
      summary: Check a prepaid credit balance
      description: 'Returns the remaining balance for a credit token, and what it has been spent on. Free, and takes no request body: the token goes in the X-Credit-Token header. Charging a buyer to find out how much they have left would be a good way to never sell them a second one.'
      operationId: credits_balance_get
      parameters:
      - name: X-Credit-Token
        in: header
        required: true
        description: The token issued by /credits/buy or /credits/trial. Required.
        schema:
          type: string
      responses:
        '200':
          description: Success, or a settled refusal. Paid routes answer 200 with a machine-readable `status` (e.g. "forbidden", "not_found", "precondition_failed", "conflict") rather than a 4xx, because any status >=400 cancels x402 settlement and would give the answer away for free. Always branch on `status`, not on the HTTP code.
        '400':
          description: Malformed request.
        '404':
          description: No such record.
        '429':
          description: Rate limited.
      security: []
      tags:
      - Credits
    post:
      summary: Check a prepaid credit balance
      description: 'Returns the remaining balance for a credit token, and what it has been spent on. Free, and takes no request body: the token goes in the X-Credit-Token header. Charging a buyer to find out how much they have left would be a good way to never sell them a second one.'
      operationId: credits_balance
      parameters:
      - name: X-Credit-Token
        in: header
        required: true
        description: The token issued by /credits/buy or /credits/trial. Required.
        schema:
          type: string
      responses:
        '200':
          description: Success, or a settled refusal. Paid routes answer 200 with a machine-readable `status` (e.g. "forbidden", "not_found", "precondition_failed", "conflict") rather than a 4xx, because any status >=400 cancels x402 settlement and would give the answer away for free. Always branch on `status`, not on the HTTP code.
        '400':
          description: Malformed request.
        '404':
          description: No such record.
        '429':
          description: Rate limited.
      security: []
      tags:
      - Credits
components:
  schemas:
    PaymentRequired:
      type: object
      description: Body of a 402. Every field is derived from the same challenge the caller is asked to sign, so it cannot quote a different price or recipient.
      properties:
        error:
          type: string
          const: payment_required
        price:
          type: string
          description: List price in dollars, e.g. $0.005
        resource:
          type: string
          description: The URL being charged for
        ways_to_pay:
          type: object
          description: The three routes in, cheapest first. free_trial needs no wallet, no signature, no account and no email.
          properties:
            free_trial:
              type: object
            prepaid_credit:
              type: object
            per_call_x402:
              type: object
        accepts:
          type: array
          description: The x402 challenge, echoed here for v1 clients that read it from the body rather than the payment-required header.
          items:
            type: object
        x402Version:
          type: number
      required:
      - error
      - ways_to_pay
  securitySchemes:
    creditToken:
      type: apiKey
      in: header
      name: X-Credit-Token
      description: A prepaid or trial balance. Get one free with no wallet and no account at POST https://agentic-endpoints.com/credits/trial, or buy credit at POST https://agentic-endpoints.com/credits/buy. Each call is debited at the route's list price and nothing is signed per request.
    x402Payment:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: A signed x402 payment authorising this one call, built from the challenge returned with HTTP 402. Requires a funded wallet on Base; the credit token does not.