# Nedradv — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive mineral deposit information from Russia's Nedradv business portal to search deposits by mineral type and region, then retrieve detailed reserve data for specific deposits. Use this service to research Russian mineral resources, compare deposits across different commodities and geographic locations, and obtain technical reserve specifications for your mining or investment analysis.

**Category:** Government & Public Data | **Website:** [nedradv.ru/](https://nedradv.ru/) | **Docs:** [parse.bot/marketplace/04eaf232-c4fe-41ad-b6f4-dd683fe050f0/nedradv-ru-api](https://parse.bot/marketplace/04eaf232-c4fe-41ad-b6f4-dd683fe050f0/nedradv-ru-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/nedradv/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get deposit

Get full details of a specific mineral deposit including reserves data, geological conditions, location, and source information. Each deposit is identified by a 32-character hex ID obtained from list_deposits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | 32-character hex deposit ID from list_deposits results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nedradv/get-deposit \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### List deposits

List mineral deposits from the Nedradv database. Returns paginated results (200 per page, up to 25 pages). Optionally filter by mineral type ID or region ID. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mineral` | string | No | Mineral type ID to filter deposits (32-character hex, e.g. from the mineral filter on the site). When set, only deposits of that mineral type are returned. |
| `page` | integer | No | Page number (1-based). Each page returns up to 200 deposits. |
| `region` | string | No | Region ID to filter deposits (32-character hex). When set, only deposits in that region are returned. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nedradv/list-deposits \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"mineral":"<string>","page":"<integer>","region":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.