How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HostDeFi x402 (machine-payable) API

Pay-per-call lane for AI agents (x402 protocol): no key, no account - pay USDC per request and get the same A+-F Safety Read. Free tier and API-key plans are unchanged and remain the better per-call price for steady use.

HostDeFi x402 (machine-payable) API is one of 7 APIs that HostDeFi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include x402 (machine-payable). The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 24 operations across 24 paths, and defines 7 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://hostdefi.com/api, https://awake-integrity-production-faa0.up.railway.app.

24 operations 24 paths 7 schemas 19 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://hostdefi.com/api
Authentication
API Key
Resource Areas
1

Authentication & Security 1

HostDeFi x402 (machine-payable) API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyHeader). By default, every request must be authenticated, though some operations may also be called without credentials.

  • ApiKeyHeader — API key from POST /v1/keys (vx + 32 hex chars). Omit it to use the keyless free tier (100 calls/day per IP).

Paths & Operations 24

Across 24 paths, the API surfaces 24 operations — 19 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.

x402 (machine-payable) 24

Pay-per-call lane for AI agents (x402 protocol): no key, no account - pay USDC per request and get the same A+-F Safety Read. Free tier and API-key plans are unchanged and remain…

GET
/v1/x402/token-risk/{chain}/{address}
Token risk verdict, paid per call via x402
2 params → 200402503
GET
/v1/x402/token-risk/history/{chain}/{address}
Token safety history (dated daily rows), paid per call via x402
3 params → 200402404503
POST
/v1/x402/token-risk
Token risk verdict by free-form query, paid per call via x402
body → 200402503
POST
/v1/x402/token-risk/batch
Batch token risk verdicts, paid per call via x402
body → 200402503
GET
/v1/x402/pricing
x402 price sheet and resource catalog
→ 200
GET
/v1/x402/signals/solana/{mint}
Pre-graduation signals for a Solana mint, paid per call via x402
1 param → 200402404503
GET
/v1/x402/authority/solana/{mint}
Authority quick-check for a Solana mint, paid per call via x402
1 param → 200402404503
POST
/v1/x402/portfolio
Solana wallet portfolio audit, paid per call via x402
body → 200402404503
GET
/v1/x402/radar
Recent trend-radar alerts, paid per call via x402
→ 200402404503
POST
/v1/x402/keys
Buy a 30-day API key with one x402 payment
→ 200402500
GET
/v1/x402/obituaries
Rug/collapse ledger (dated gate-exit records), paid per call via x402
2 params → 200402503
GET
/v1/x402/listings/{chain}
Graded token listing for one chain, paid per call via x402
2 params → 200402400503
GET
/v1/x402/datasets/safety-snapshot
The full weekly safety-snapshot dataset, paid per call via x402
1 param → 200402503
GET
/v1/x402/radar/history
Full trend-radar alert history, paid per call via x402
→ 200402503
GET
/v1/x402/provider-risk
Risk grade for one x402 seller, paid per call via x402
1 param → 200402400404503
GET
/v1/x402/provider-risk/all
The full x402 provider-risk dataset, paid per call via x402
→ 200402503
GET
/v1/x402/swap/evm/quote
Executable EVM swap quote (ready-to-sign tx), paid per call via x402
→ 200400402404503
GET
/v1/x402/swap/evm/price
EVM swap price preview, paid per call via x402
→ 200400402404503
GET
/v1/x402/token-risk/deep/{chain}/{address}
Deep token report (verdict + full history + trend), paid per call via x402
3 params → 200402404503
GET
/v1/x402/token-risk/report/{chain}/{address}
Full due-diligence report (verdict + signals + history + cross-checks), paid per call via x402
3 params → 200402
POST
/v1/x402/wallet
Wallet risk-exposure read (Solana), paid per call via x402
body → 200402404503
GET
/v1/x402/launches
Fresh token launches with safety pre-reads, paid per call via x402
2 params → 200402404503
GET
/v1/x402/predict/markets
Tracked Polymarket prediction markets with latest odds, paid per call via x402
1 param → 200402503
GET
/v1/x402/predict/history
24h odds history for one tracked Polymarket market, paid per call via x402
1 param → 200402404503

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are X402PaymentRequirements (10 properties), RiskBlock (8 properties), SolanaSignals (5 properties), Verdict (5 properties). Each schema is shown below with its type and property counts.

Verdict
object
The graded Safety Read for one token — identical to the grade rendered on the HostDeFi token pages.
5 properties
EvmSignals
object
EVM signal set (present when the token resolved to an EVM chain). evmSecurity is always emitted (all-null flags when the security source was unavailable) and i…
2 properties 1 required
SolanaSignals
object
Solana signal set (present when the token resolved to Solana). authorities is always emitted (null-valued when the on-chain read was unavailable) and is what d…
5 properties 1 required
X402PaymentRequirements
object
One accepted payment option (x402 protocol v1, 'exact' scheme). Amounts are atomic units of the asset (USDC has 6 decimals: '10000' = $0.01).
10 properties
RiskBlock
object
Graded verdict, or an honest refusal to grade (graded: false) when the token is too new or under-described — the API never fakes a grade.
8 properties
X402Offer
object
The 402 Payment Required body: retry the same request with an X-PAYMENT header (base64 JSON payment payload) built against one of the 'accepts' options. Any st…
3 properties
MarketSignals
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hostdefi-x402-machine-payable-api-openapi.yml Raw ↑

Other APIs HostDeFi publishes across the network.

HostDeFi Token Risk API
HostDeFi Analyze Token API
HostDeFi Health API
HostDeFi Keys API
HostDeFi Scan API
HostDeFi Usage API
Where this information came from

This is an independent, third-party profile of HostDeFi x402 (machine-payable) API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.