# Metal API

**Canonical:** https://apis.io/apis/metal/metal-api/  
**Provider:** Metal — https://apis.io/providers/metal/  
**Base URL:** https://api.metal.build  
**Documentation:** https://docs.metal.build

Metal API is one of 2 APIs that [Metal](https://apis.io/providers/metal/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Metal API as documented publicly: 16 operations. Contract generated from the documentation by API Evangelist (2026-10-18); not the provider's own document.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/holder/${holderId}` | GET /holder/${holderId} |
| POST | `/holder/${userId}/spend` | POST /holder/${userId}/spend |
| POST | `/holder/${userId}/transfer` | POST /holder/${userId}/transfer |
| POST | `/holder/${userId}/withdraw` | POST /holder/${userId}/withdraw |
| GET | `/holder/{holderaddress}/token/{tokenaddress}` | Get Token Balance |
| GET | `/holder/user123/transactions` | GET /holder/user123/transactions |
| GET | `/merchant/all-tokens` | GET /merchant/all-tokens |
| GET | `/merchant/presale` | GET /merchant/presale |
| POST | `/merchant/presale` | POST /merchant/presale |
| GET | `/merchant/presale/resolve` | GET /merchant/presale/resolve |
| POST | `/merchant/presale/resolve` | POST /merchant/presale/resolve |
| GET | `/merchant/presales` | GET /merchant/presales |
| GET | `/token/0x1234567890abcdef1234567890abcdef12345678/distribute` | GET /token/0x1234567890abcdef1234567890abcdef12345678/distribute |
| GET | `/token/{tokenaddress}` | Get Token |
| POST | `/token/{tokenaddress}/distribute` | Distribute Tokens |
| GET | `/v1/conversations` | GET /v1/conversations |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/openapi/_ae-authored/metal-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-get-token-tokenaddress-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-post-token-tokenaddress-distribute-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-get-holder-holderaddress-token-tokenaddress-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-post-holder-userid-spend-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-get-holder-user123-transactions-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/metal/refs/heads/main/json-schema/metal-post-holder-userid-transfer-response-schema.json

## Other Metal APIs (1)

- [Metal API](https://apis.io/apis/metal/metal-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/metal/metal-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/metal/.