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

Hive Civilization X402 API

The X402 API from Hive Civilization — 18 operation(s) for x402.

Hive Civilization X402 API is one of 153 APIs that Hive Civilization publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include x402. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

This API exposes 20 operations across 18 paths, and defines 8 schemas. It is described by OpenAPI 3.2.0, at version 0.1.0.

Requests are made against the base URL https://receipts.thehiveryiq.com.

20 operations 18 paths 8 schemas 13 GET7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1.0
Base URL
https://receipts.thehiveryiq.com
Resource Areas
1

Paths & Operations 20

Across 18 paths, the API surfaces 20 operations — 13 GET, 7 POST. Each is listed below with its method, path, parameters, and response codes.

X402 20
GET
/v1/x402
X402 Facilitator Metadata
x402_facilitator_metadata_v1_x402_get → 200
GET
/v1/x402/pricing
Current x402 pricing table
get_pricing_v1_x402_pricing_get → 200
GET
/v1/x402/stats
x402 call statistics
get_stats_v1_x402_stats_get → 200
GET
/v1/x402/stats/buckets
Bucketed endpoint stats (top-level + drill-down)
get_stats_buckets_v1_x402_stats_buckets_get → 200
POST
/v1/x402/proof/submit
Submit a payment proof
submit_proof_v1_x402_proof_submit_post body → 200422
GET
/v1/x402/proof/verify
Verify an access token
verify_token_v1_x402_proof_verify_get 1 param → 200422
POST
/v1/x402/pricing/set
Admin: update endpoint pricing
set_pricing_v1_x402_pricing_set_post 3 params body → 200422
GET
/v1/x402/rails
Available settlement rails
get_rails_v1_x402_rails_get → 200
POST
/v1/x402/rails/select
Admin: choose default settlement asset
select_rail_v1_x402_rails_select_post 2 params body → 200422
GET
/v1/x402/stats/by-payer
Internal: aggregated x402 stats per payer (revenue forensics)
stats_by_payer_v1_x402_stats_by_payer_get 2 params → 200422
GET
/v1/x402/today
Today's UTC x402 aggregate (restart-survivable)
get_today_v1_x402_today_get 1 param → 200422
GET
/v1/x402/barter
Barter / counter-offer telemetry (per-path + histogram)
get_barter_v1_x402_barter_get 2 params → 200422
GET
/v1/x402/failed
Failed-tx recovery queue
get_failed_v1_x402_failed_get 1 param → 200422
POST
/v1/x402/recover
Manually re-verify a previously-failed proof
recover_proof_v1_x402_recover_post body → 200422
GET
/v1/x402/bogo
BOGO (first-call-free) introspection
bogo_stats_v1_x402_bogo_get → 200
POST
/v1/x402/quote
x402 atomic payment quote — LIVE, USDC on Base 8453
quote_v1_x402_quote_post body → 200422
GET
/v1/x402/client-intent
Browser/wallet-consumable x402 payment intent (LIVE nonce)
client_intent_get_v1_x402_client_intent_get 3 params → 200422
POST
/v1/x402/client-intent
Browser/wallet-consumable x402 payment intent (LIVE nonce) — POST
client_intent_post_v1_x402_client_intent_post body → 200422
GET
/v1/x402/wallet-intent
Alias of GET /v1/x402/client-intent
wallet_intent_get_v1_x402_wallet_intent_get 3 params → 200422
POST
/v1/x402/wallet-intent
Alias of POST /v1/x402/client-intent
wallet_intent_post_v1_x402_wallet_intent_post body → 200422

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are QuoteRequest (8 properties), ProofSubmitRequest (6 properties), ValidationError (5 properties), RecoverRequest (5 properties). Each schema is shown below with its type and property counts.

QuoteRequest
object
Body for POST /v1/x402/quote. All fields optional — caller can ask for a generic settlement quote, or a quote tied to a specific HiveMorph endpoint, or a quote…
8 properties
ProofSubmitRequest
object
Body for POST /v1/x402/proof/submit.
6 properties 4 required
RecoverRequest
object
Body for POST /v1/x402/recover.
5 properties 2 required
PricingSetRequest
object
Body for POST /v1/x402/pricing/set (also accepts query params).
5 properties
ClientIntentRequest
object
Optional body for POST /v1/x402/client-intent (and wallet-intent alias).
3 properties
HTTPValidationError
object
1 property
ValidationError
object
5 properties 3 required
RailSelectRequest
object
Body for POST /v1/x402/rails/select.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thehiveryiq-com-x402-api-openapi.yml Raw ↑

Other APIs Hive Civilization publishes across the network.

Hive MCP Gateway and Registry
Hive Passport Trust Rail (HKTN)
Hive Civilization A2A Agent
Hive Civilization A2a API
Hive Civilization Activation API
Hive Civilization Aegis API
Hive Civilization Affordances API
Hive Civilization Afir Stream API
Hive Civilization Agent Receipts API
Hive Civilization Alcoa Agentguard API
Hive Civilization Amplify API
Hive Civilization App Kits API
Where this information came from

This is an independent, third-party profile of Hive Civilization X402 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.