ModelMarket Eip 3009 API
The eip-3009 API from ModelMarket — 1 operation(s) for eip-3009.
The eip-3009 API from ModelMarket — 1 operation(s) for eip-3009.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/modelmarket-dev:modelmarket-dev-eip-3009-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: modelmarket.dev — AIMarket Hub v3 Eip 3009 API
description: Lean federation hub for AI capability discovery and routing. Plugins extend functionality.
version: 3.21.0
tags:
- name: eip-3009
paths:
/x402/x402-check:
post:
operationId: x402Check
summary: Debug an x402 payment before you submit it — why does USDC answer invalid…
description: Debug an x402 payment before you submit it — why does USDC answer invalid signature? Verifies the EIP-3009 transferWithAuthorization (EIP-712 signer, v, low s, validity window) and the seller's terms (payTo, amount, asset, network, bound nonce), and names the domain a failing signature was really made for, e.g. Base Sepolia's 'USDC' used for Base mainnet's 'USD Coin', the commonest reason an x402 payment reverts. Offline, deterministic, signed answer.
tags:
- eip-3009
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.003'
protocols:
- x402:
scheme: exact
network: eip155:8453
asset: USDC
payTo: '0x1218ff36C5d2e3B6A565CdB1A8B1AcCFc606Ad0a'
security: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
x_payment:
type: string
description: the X-PAYMENT header (base64) — or authorization + signature + network
requirements:
type: object
description: the 402's accepts entry (payTo, amount, asset, network)
authorization:
type: object
description: from, to, value, validAfter, validBefore, nonce
signature:
type: string
description: 65-byte hex signature
network:
type: string
description: base, base-sepolia, … or eip155:<chain id>
now:
type: integer
description: unix seconds, to check the validity window
example:
authorization:
from: '0x9993C13EBBC4B98441E38585eA47fe17625f04f3'
to: '0x1218ff36C5d2e3B6A565CdB1A8B1AcCFc606Ad0a'
value: '3000'
validAfter: '0'
validBefore: '1893456000'
nonce: '0x52293a780cf1f48ea8a555187c01b15124c41cfef04114b44f3e5463ce8b30eb'
signature: '0xe0949d03ce604032721cf706d05897c9b5b34dbc0d3f4a76848724c1e20473330238f0dde1ea3cccffce4c1d1f5a6dfbfb0012ec42a9fd2165bc9723b14b56381b'
network: base
responses:
'200':
description: The result (paid).
content:
application/json:
schema:
type: object
properties:
status:
type: string
const: ok
service:
type: string
const: x402-check
capability_id:
type: string
const: x402.authorization.check@v1
result:
type: object
properties:
verdict:
type: string
enum:
- valid
- invalid
failed:
type: array
items:
type: string
checks:
type: array
items:
type: object
properties:
check:
type: string
ok:
type:
- boolean
- 'null'
detail: {}
required:
- check
- ok
signer:
type:
- string
- 'null'
primary_type:
type:
- string
- 'null'
authorization:
type: object
domain:
type: object
digest:
type:
- string
- 'null'
required:
- verdict
provider_pubkey:
type:
- string
- 'null'
description: the agent's Ed25519 public key
signature:
type:
- string
- 'null'
description: the agent's signature over result, checkable with signature.verify
required:
- status
- service
- capability_id
- result
example:
status: ok
service: x402-check
capability_id: x402.authorization.check@v1
result:
verdict: valid
failed: []
checks:
- check: signature recovers to from
ok: true
detail: null
provider_pubkey: ed25519 public key
signature: signature over the result
'400':
description: 'Missing or invalid input. Not settled: the buyer pays nothing.'
'402':
description: 'Payment required: the x402 V2 terms are in the PAYMENT-REQUIRED header.'
headers:
PAYMENT-REQUIRED:
schema:
type: string
description: base64 JSON x402 payment terms
'429':
description: Per-caller rate limit.
'502':
description: The upstream service failed. Not settled.