Monid Wallet API
The Wallet API from Monid — 2 operation(s) for wallet.
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/monid-wallet-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:
title: Monid Wallet API
version: 0.1.0
description: Agentic payment platform for data — agents discover and buy data on demand. Authenticated `/v1/*` routes accept a Monid API key or Clerk JWT as a Bearer token. All errors return `{ code, message }`. List endpoints use cursor pagination; consult each operation schema for its last-page cursor encoding.
servers:
- url: https://api.monid.ai
description: Production
- url: https://monid.ai
description: Public registry alias (public/v1 only)
tags:
- name: Wallet
paths:
/v1/wallet/balance:
get:
tags:
- Wallet
summary: Get the live wallet balance
description: Fetches the live balance from the wallet provider, reconciles the wallet-balance control, and returns spendable `balance` (live − held; may be negative) plus `held` (reserved for in-flight runs). Never cached.
security:
- Bearer: []
responses:
'200':
description: Live wallet balance (dollars)
content:
application/json:
schema:
$ref: '#/components/schemas/WalletBalanceResponse'
'401':
description: Unauthorized — missing or invalid credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — caller has no workspace or no access
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Wallet not ACTIVE (provisioning, failed, or being set up). Transient states include a Retry-After header (seconds).
headers:
Retry-After:
description: Seconds to wait before retrying (present for transient states).
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WalletUnavailableError'
/v1/wallet/topup:
get:
tags:
- Wallet
summary: Get top-up configuration
description: Fees and limits for wallet top-ups, so the frontend does not hardcode values.
security:
- Bearer: []
responses:
'200':
description: Top-up fees and limits
content:
application/json:
schema:
$ref: '#/components/schemas/WalletTopupConfigResponse'
'401':
description: Unauthorized — missing or invalid credentials
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — caller has no workspace or no access
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Wallet not ACTIVE (provisioning, failed, or being set up). Transient states include a Retry-After header (seconds).
headers:
Retry-After:
description: Seconds to wait before retrying (present for transient states).
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/WalletUnavailableError'
components:
schemas:
WalletBalanceResponse:
type: object
properties:
balance:
$ref: '#/components/schemas/WalletMonetaryAmount'
held:
$ref: '#/components/schemas/WalletMonetaryAmount'
required:
- balance
- held
WalletUnavailableError:
type: object
properties:
code:
type: integer
description: HTTP status code, duplicated in the body.
example: 503
message:
type: string
description: Human-readable error description.
example: Wallet is being provisioned.
walletStatus:
type:
- string
- 'null'
description: Wallet provisioning status (e.g. PROVISIONING, FAILED). Null when the wallet does not exist yet.
example: PROVISIONING
required:
- code
- message
Error:
type: object
properties:
code:
type: integer
description: HTTP status code, duplicated in the body.
example: 400
message:
type: string
description: Human-readable error description.
example: Bad Request
required:
- code
- message
WalletMonetaryAmount:
type: object
properties:
value:
type: number
description: Amount in dollars (float).
example: 25.5
currency:
type: string
description: ISO currency code.
example: USD
required:
- value
- currency
WalletTopupConfigResponse:
type: object
properties:
minAmount:
type: number
description: Minimum top-up amount in dollars.
example: 5
maxAmount:
type: number
description: Maximum top-up amount in dollars. Omitted when no app-level cap is configured.
example: 1000
currency:
type: string
enum:
- USD
description: Top-up currency (currently always USD).
processingFee:
type: object
properties:
type:
type: string
enum:
- PERCENTAGE
rate:
type: number
description: Processing fee rate (e.g. 0.05 for 5%).
example: 0.05
description:
type: string
example: Processing fee (5%)
required:
- type
- rate
- description
required:
- minAmount
- currency
- processingFee
securitySchemes:
Bearer:
type: http
scheme: bearer
description: 'Monid API key (`Authorization: Bearer mk_...`) or Clerk-issued JWT.'