nsgoods-org Payable API
The Payable API from nsgoods-org — 7 operation(s) for payable.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/nsgoods-org:nsgoods-org-payable-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
openapi: 3.2.0
info:
description: Is this x402 endpoint payable? Reachable + well-formed 402 + (Solana) destination-ATA existence. Signed responses, x402 on Base or Solana. Response schema is additive within a version; breaking changes bump schema_version.
title: x402 payability check Payable API
version: 1.0.0
servers:
- url: https://payable.nsgoods.org
tags:
- name: Payable
paths:
/payable:
get:
parameters:
- description: https URL of the x402 endpoint to check
in: query
name: resource
required: true
schema:
format: uri
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PayabilityResult'
description: Signed payability verdict (schema_version 2)
'400':
description: missing/invalid resource (not https / non-public host)
'402':
content:
application/json:
schema:
type: object
description: Payment required (x402). Body carries the x402 PaymentRequirements; same document is base64 in the PAYMENT-REQUIRED response header.
headers:
PAYMENT-REQUIRED:
description: Base64 x402 v2 challenge
schema:
type: string
security:
- x402Payment: []
summary: Signed payability verdict for one x402 endpoint ($0.005)
tags:
- Payable
operationId: getPayable
x-operation-id-source: derived
/payable/address:
get:
parameters:
- description: 0x EVM address (checksummed or not)
in: query
name: address
required: true
schema:
type: string
- description: only 'base' supported for now
in: query
name: chain
required: true
schema:
enum:
- base
type: string
- description: ERC-20 for the transfer-path check (default USDC on Base)
in: query
name: token
required: false
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/AddressPreflight'
description: Signed address preflight (address_schema_version 1)
'400':
description: missing/invalid address, unsupported chain, or invalid token
'402':
content:
application/json:
schema:
type: object
description: Payment required (x402). Body carries the x402 PaymentRequirements; same document is base64 in the PAYMENT-REQUIRED response header.
headers:
PAYMENT-REQUIRED:
description: Base64 x402 v2 challenge
schema:
type: string
security:
- x402Payment: []
summary: Base/EVM address preflight ($0.005) — address_schema_version 1 (NOT…
tags:
- Payable
operationId: getPayableAddress
x-operation-id-source: derived
/payable/address/fixtures:
get:
responses:
'200':
description: Fixture set
summary: Free correctness fixtures (real Base addresses, verified expected values)
tags:
- Payable
operationId: getPayableAddressFixtures
x-operation-id-source: derived
/payable/address/preview:
get:
responses:
'200':
description: Signed demo preflight + 4 post-sign fields
summary: Free locked-demo address preflight (ignores input, always 200)
tags:
- Payable
operationId: getPayableAddressPreview
x-operation-id-source: derived
/payable/address/schema:
get:
responses:
'200':
description: JSON Schema (address_schema_version 1)
summary: Free JSON Schema of the address-preflight response
tags:
- Payable
operationId: getPayableAddressSchema
x-operation-id-source: derived
/payable/batch:
post:
requestBody:
content:
application/json:
schema:
properties:
resources:
items:
format: uri
type: string
maxItems: 2000
type: array
required:
- resources
type: object
required: true
responses:
'200':
content:
application/json:
schema:
properties:
count:
type: integer
results:
items:
$ref: '#/components/schemas/PayabilityResult'
type: array
schema_version:
const: 2
type: integer
type: object
description: One signature over {schema_version,checked_at,count,results[]}
'400':
description: malformed / non-https resource / over 2000 (split)
'402':
content:
application/json:
schema:
type: object
description: Payment required (x402). Body carries the x402 PaymentRequirements; same document is base64 in the PAYMENT-REQUIRED response header.
headers:
PAYMENT-REQUIRED:
description: Base64 x402 v2 challenge
schema:
type: string
security:
- x402Payment: []
summary: Bulk payability check, tiered price ($0.005/unit, $0.002 over 1000; max 2000)
tags:
- Payable
operationId: postPayableBatch
x-operation-id-source: derived
/payable/preview:
get:
responses:
'200':
description: Signed demo verdict + 4 post-sign fields
summary: Free locked-demo verdict (ignores input, always 200)
tags:
- Payable
operationId: getPayablePreview
x-operation-id-source: derived
components:
schemas:
AddressPreflight:
type: object
description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
x-ae-placeholder: true
PayabilityResult:
properties:
accepts_wellformed:
type: boolean
checked_at:
format: date-time
type: string
disclaimer:
type: string
observatory:
description: paid only; present when the observatory has prior data for the resource
properties:
first_seen:
type: string
last_change_at:
type:
- string
- 'null'
scans:
type: integer
verdict_now_vs_history:
enum:
- stable
- changed
type: string
type: object
options:
items:
properties:
detail:
type: object
network:
type: string
pay_to:
type: string
remediation:
description: present only on a failing option
type: object
verdict:
enum:
- PAYABLE
- ATA_MISSING_NEVER_EXISTED
- ATA_CLOSED_AFTER_USE
- EVM_NO_ATA_CHECK_NEEDED
- NOT_SPL_SETTLEMENT
- MALFORMED_402
type: string
type: object
type: array
payable_networks:
items:
type: string
type: array
proof:
description: paid only; pointer to the published payable correctness set
properties:
correctness_set:
type: string
verify:
type: string
type: object
reachable:
type: boolean
remediation:
description: present only on a top-level UNREACHABLE / MALFORMED_402
type: object
resource:
type: string
returns_402:
type: boolean
schema_version:
const: 2
type: integer
signature:
type: string
signed_by:
type: string
verdict:
enum:
- PAYABLE
- NOT_PAYABLE
- UNREACHABLE
- MALFORMED_402
type: string
required:
- schema_version
- resource
- reachable
- returns_402
- accepts_wellformed
- options
- payable_networks
- verdict
- signed_by
- signature
type: object
securitySchemes:
x402Payment:
description: x402 USDC payment on Base or Solana
in: header
name: X-PAYMENT
type: apiKey