HTTP Reference

The complete public contract is 36 operations under one origin:

https://api.blank.build/api/v2

Paths in the tables below are relative to that origin. Every operation ID matches the OpenAPI reference, where you can also see full request and response schemas. Anything outside /api/v2 is an internal Blank plane with no stability contract. There is no v1 contract and no unversioned alias.

Reading the tables

Auth — Anonymous needs no credential. Any key needs a valid key but no scope. Anything else is the exact scope set required; a key must carry all of them.
Rate policy — the value reported in X-RateLimit-Policy. Limits are environment configuration; read the rate-limit headers rather than hardcoding numbers.
Idempotent — Yes means the operation is a mutation and requires an Idempotency-Key header.
Operations marked with If-Match additionally require the resource’s current version as a strong ETag.

See Conventions for pagination, headers, retries, and concurrency, and Errors for the Problem Details envelope.

System

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/solana/manifest`	`getSolanaManifest`	Anonymous	`public-read-cheap`	200

Identity

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/me`	`getApiIdentity`	Any key	`api-key-read`	200

Tokens

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/tokens`	`listTokens`	Anonymous	`public-read-cheap`	200
`GET`	`/tokens/{mint}`	`getToken`	Anonymous	`public-read-cheap`	200
`GET`	`/wallets/{address}/holdings`	`listWalletHoldings`	Anonymous	`public-read-expensive`	200

Query for listTokens: cursor, limit (1–100, default 50), status, launchType, creator (a creator wallet address). listWalletHoldings takes no query and returns at most 500 holdings, unpaginated. See Tokens and market data.

Market data

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/tokens/{mint}/market`	`getTokenMarketSnapshot`	Anonymous	`public-read-cheap`	200
`GET`	`/tokens/{mint}/candles`	`listTokenCandles`	Anonymous	`public-read-expensive`	200
`GET`	`/tokens/{mint}/trades`	`listTokenTrades`	Anonymous	`public-read-cheap`	200
`GET`	`/tokens/{mint}/holders`	`getTokenHolderStats`	Anonymous	`public-read-cheap`	200
`GET`	`/wallets/{address}/trades`	`listWalletTrades`	Anonymous	`public-read-cheap`	200

listTokenCandles requires from, to, and interval (1m, 5m, 15m, 1h, 4h, 1d) and returns at most 1,000 points. Query for listWalletTrades: cursor, limit, mint.

Staking

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/tokens/{mint}/staking`	`getStakingPool`	Anonymous	`public-read-cheap`	200
`GET`	`/tokens/{mint}/staking/leaderboard`	`listStakingLeaderboard`	Anonymous	`public-read-expensive`	200
`GET`	`/tokens/{mint}/staking/stakers`	`listStakingStakers`	Anonymous	`public-read-expensive`	200
`GET`	`/wallets/{address}/staking/positions`	`listWalletStakingPositions`	Anonymous	`public-read-cheap`	200
`GET`	`/tokens/{mint}/staking/positions`	`listOwnedStakingPositions`	`staking:read`	`api-key-read`	200

Query for listStakingStakers: cursor, limit. Query for listWalletStakingPositions: cursor, limit, mint. Both position operations return live reward fields read from the chain per request (pendingRewardsLamports, totalRewardsClaimedLamports, claimable, rewardsAsOf) and answer 503 api_dependency_unavailable when that read fails. See Staking.

Fees

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/tokens/{mint}/fees`	`getTokenFeeState`	`fees:read`	`api-key-read`	200
`GET`	`/tokens/{mint}/fee-distributions`	`listTokenFeeDistributions`	`fees:read`	`api-key-read`	200

See Fees.

Presales

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/presales`	`listPresales`	Anonymous	`public-read-cheap`	200
`GET`	`/presales/{id}`	`getPresale`	Anonymous	`public-read-cheap`	200
`GET`	`/presales/{id}/participation`	`getPresaleParticipation`	`presales:read`	`api-key-read`	200

See Presales.

Predictions

Method	Path	Operation ID	Auth	Rate policy	Idempotent	Success
`GET`	`/tokens/{mint}/prediction-rounds`	`listPredictionRounds`	Anonymous	`public-read-cheap`	—	200
`GET`	`/tokens/{mint}/prediction-rounds/{roundId}`	`getPredictionRound`	Anonymous	`public-read-cheap`	—	200
`GET`	`/tokens/{mint}/prediction-rounds/{roundId}/predictions`	`listRoundPredictions`	Anonymous	`public-read-expensive`	—	200
`GET`	`/tokens/{mint}/prediction-rounds/{roundId}/standings`	`listPredictionStandings`	Anonymous	`public-read-expensive`	—	200
`GET`	`/tokens/{mint}/prediction-rounds/{roundId}/eligibility`	`getPredictionEligibility`	`predictions:read`	`api-key-read`	—	200
`GET`	`/predictions/{predictionId}`	`getOwnedPrediction`	`predictions:read`	`api-key-read`	—	200
`POST`	`/predictions`	`createPrediction`	`predictions:write`	`prediction-submit`	Yes	201

See Price predictions.

Operations

Method	Path	Operation ID	Auth	Rate policy	Success
`GET`	`/operations/{operationId}`	`getOperation`	`operations:read`	`operation-read`	200

Transaction intents

Method	Path	Operation ID	Auth	Rate policy	Idempotent	Success
`GET`	`/transaction-intents/{intentId}`	`getTransactionIntent`	`operations:read`	`operation-read`	—	200
`POST`	`/transaction-intents/{intentId}/submissions`	`submitTransactionIntent`	`transactions:write`	`transaction-submit`	Yes + `If-Match`	202

See Operations and transaction intents.

Webhooks

Method	Path	Operation ID	Auth	Rate policy	Idempotent	Success
`POST`	`/webhook-endpoints`	`createWebhookEndpoint`	`webhooks:write`	`webhook-admin`	Yes	201
`GET`	`/webhook-endpoints`	`listWebhookEndpoints`	`webhooks:read`	`api-key-read`	—	200
`GET`	`/webhook-endpoints/{endpointId}`	`getWebhookEndpoint`	`webhooks:read`	`api-key-read`	—	200
`PATCH`	`/webhook-endpoints/{endpointId}`	`updateWebhookEndpoint`	`webhooks:write`	`webhook-admin`	Yes + `If-Match`	200
`DELETE`	`/webhook-endpoints/{endpointId}`	`deleteWebhookEndpoint`	`webhooks:write`	`webhook-admin`	Yes + `If-Match`	200
`POST`	`/webhook-endpoints/{endpointId}/secret-rotations`	`rotateWebhookSecret`	`webhooks:write`	`webhook-admin`	Yes + `If-Match`	201
`GET`	`/webhook-endpoints/{endpointId}/deliveries`	`listWebhookDeliveries`	`webhooks:read`	`api-key-read`	—	200
`POST`	`/webhook-deliveries/{deliveryId}/replays`	`replayWebhookDelivery`	`webhooks:write`	`webhook-admin`	Yes	202

Blank also sends one request to you: the signed CloudEvent delivery, documented in the OpenAPI spec as the receiveBlankWebhookEvent webhook. See Webhooks.

Worked examples

Anonymous read with a conditional request:

curl -s "https://api.blank.build/api/v2/tokens?status=bonding&limit=20" \
  -H "Accept: application/json" \
  -H 'If-None-Match: "aG9sZGVy..."' -i

Authenticated read from a server shell:

curl -s "https://api.blank.build/api/v2/me" \
  -H "Authorization: Bearer $BLANK_API_KEY"

Mutation with durable idempotency:

curl -s -X POST "https://api.blank.build/api/v2/predictions" \
  -H "Authorization: Bearer $BLANK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: prediction-2026-08-10-round-17" \
  -d '{
    "roundId": "24c85940-7968-4b71-92dd-0d8f017cea5a",
    "walletAddress": "11111111111111111111111111111111",
    "predictedPriceInSol": "0.00042"
  }'

Never run an authenticated example in a browser or embed a key in client-side code. Authenticated operations receive no browser CORS allowance.

Start Here

Features

For Developers

Reference

API Reference

Endpoints

HTTP Reference

HTTP Reference

Reading the tables

System

Identity

Tokens

Market data

Staking

Fees

Presales

Predictions

Operations

Transaction intents

Webhooks

Worked examples

​HTTP Reference

​Reading the tables

​System

​Identity

​Tokens

​Market data

​Staking

​Fees

​Presales

​Predictions

​Operations

​Transaction intents

​Webhooks

​Worked examples

HTTP Reference

Reading the tables

System

Identity

Tokens

Market data

Staking

Fees

Presales

Predictions

Operations

Transaction intents

Webhooks

Worked examples